wowok_agent 2.1.37 → 2.1.38

package/dist/schema/call/allocation.js

@@ -19,7 +19,7 @@ export const CallAllocation_OperateSchema = z.object({
 export const CallAllocation_DataSchema = z.union([
     CallAllocation_CreateSchema,
     CallAllocation_OperateSchema
-]).describe("On-chain Allocation operations. USAGE: (1) CREATE NEW: Use CallAllocation_CreateSchema by setting 'object' with {name, type, ...}. (2) OPERATE EXISTING: Use CallAllocation_OperateSchema by setting 'object' with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+]).describe("On-chain Allocation operations. USAGE: (1) CREATE NEW: Use CallAllocation_CreateSchema by setting 'object' with OBJECT format {name, type_parameter, ...}. (2) OPERATE EXISTING: Use CallAllocation_OperateSchema by setting 'object' with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. ");
 export const CallAllocation_InputSchema = z.object({
     data: CallAllocation_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/arbitration.js

@@ -97,7 +97,7 @@ export const CallArbitration_DataSchema = z.object({
     voting_guard: VotingGuardActionSchema.optional().describe("Set Guard for verification during arbitration voting; if Guard verification fails, arbitration voting will fail."),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object.")
-}).strict().describe("On-chain Arbitration operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, type, permission, ...} to create an Arbitration. NOTE:'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Arbitration operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create an Arbitration. NOTE:'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 // 定义输入schema
 export const CallArbitration_InputSchema = z.object({
     data: CallArbitration_DataSchema,

package/dist/schema/call/base.js

@@ -29,18 +29,18 @@ export const NamedObjectSchema = z.object({
     "Only set 'replaceExistName: true' when the user EXPLICITLY demands to forcefully claim the name.");
 // 定义 NormalObject schema
 export const NormalObjectSchema = z.union([
-    NameOrAddressSchema.describe("Object name or ID. Used to operate on an existing object."),
-    NamedObjectSchema,
-]).describe("Reference an existing object by name or ID, or create a new object by providing its name.");
+    NameOrAddressSchema.describe("String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Example: 'my-service' or '0x1234...'"),
+    NamedObjectSchema.describe("Object format: CREATE a NEW object with specified properties. See NamedObjectSchema for details including 'name' (optional), 'tags' (optional), 'onChain' (whether to make name public), and 'replaceExistName' (force claim existing name)."),
+]).describe("Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object using NamedObjectSchema structure with optional name, tags, and visibility settings.");
 // 定义 NamedObjectWithDescription schema
 export const NamedObjectWithDescriptionSchema = NamedObjectSchema.extend({
     description: z.string().optional().describe("The description of the object"),
 }).strict().describe("Create a new object with a name and optional description. The name helps identify the object, while the description provides additional details about its purpose or functionality.");
 // 定义 DescriptionObject schema
 export const DescriptionObjectSchema = z.union([
-    NameOrAddressSchema.describe("Object name or ID. Used to operate on an existing object."),
-    NamedObjectWithDescriptionSchema
-]).describe("Reference an existing object by name or ID, or create a new object by specifying its name and description.");
+    NameOrAddressSchema.describe("String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Example: 'my-object' or '0x1234...'"),
+    NamedObjectWithDescriptionSchema.describe("Object format: CREATE a NEW object with name, optional description, and visibility settings. Extends NamedObjectSchema with an additional 'description' field for detailed object information.")
+]).describe("Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with full configuration including optional name, tags, description, and visibility settings (local private by default, or public on-chain with onChain:true).");
 // 定义 TypeNamedObject schema
 export const TypeNamedObjectSchema = NamedObjectSchema.extend({
     type_parameter: TokenTypeWithDefaultSchema.describe("Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments."),
@@ -59,7 +59,7 @@ export const CoinParamSchema = z.union([
         balance: BalanceTypeSchema,
     }).describe("Specify an amount value."),
     z.object({
-        coin: z.string().describe("Coin object ID. Use a specified Coin object."),
+        coin: z.string().describe("Coin object ID or name(local mark). Use a specified Coin object."),
     }),
 ]).describe("Specify the amount to pay from the transaction account, or the Coin ID owned by the transaction account. Used for payment.");
 // 定义 CallEnv schema
@@ -105,19 +105,19 @@ export const SubmissionCallSchema = z.object({
 }).strict().describe("Guard verification submission data required to complete an operation. Contains: (1) 'guard' - array of Guard objects to verify, each with an object ID and an 'impack' flag indicating if its result affects the final outcome; (2) 'submission' - array of user data submissions matching the Guard's requirements. The operation proceeds only after all Guards with impack=true are successfully verified.");
 // 定义 TypedPermissionObject schema
 export const TypedPermissionObjectSchema = z.union([
-    NameOrAddressSchema.describe("Object name or ID. Used to operate on an existing object."),
-    TypeNamedObjectWithPermissionSchema,
-]).describe("Reference an existing object by name or ID, or create a new object with full configuration: name (optional), tags (optional), description (optional), token type for payments, and Permission-based access control.");
+    NameOrAddressSchema.describe("String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Use this when the object already exists and you want to reference it."),
+    TypeNamedObjectWithPermissionSchema.describe("Object format: CREATE a NEW object with COMPLETE configuration including: optional name, tags, description, token type for payments (e.g., '0x2::wow::WOW'), AND Permission-based access control. Use this for creating sophisticated objects with both payment token specification and permission management."),
+]).describe("Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with full configuration including name, tags, description, token type for payments, and Permission-based access control. The object format is used when you need both token specification AND permission management.");
 // 定义 WithPermissionObject schema
 export const WithPermissionObjectSchema = z.union([
-    NameOrAddressSchema.describe("Object name or ID. Used to operate on an existing object."),
-    NamedObjectWithPermissionSchema,
-]).describe("Create a new object (which can be named and tagged) with a Permission object to manage its access control, or operate on an existing object by referencing its name or ID.");
+    NameOrAddressSchema.describe("String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Use when the Permission object already exists."),
+    NamedObjectWithPermissionSchema.describe("Object format: CREATE a NEW object with Permission-based access control. Includes optional name, tags, visibility settings, AND a Permission object (which itself can be referenced by string or created as a new object). Use this to create objects with managed access permissions."),
+]).describe("Two ways to specify a Permission-managed object: (1) STRING - Reference an EXISTING Permission object by name or ID; (2) OBJECT - CREATE a NEW object with Permission access control, where the Permission can also be either referenced (string) or newly created (object). This is used when you need permission management but don't need to specify a token type.");
 // 定义 TypedDescriptionObject schema
 export const TypedDescriptionObjectSchema = z.union([
-    NameOrAddressSchema.describe("Object name or ID. Used to operate on an existing object."),
-    TypeNamedObjectSchema,
-]).describe("Reference an existing object by name or ID, or create a new object with full configuration options: name (optional), tags (optional array), description (optional), token type for payments (e.g., '0x2::wow::WOW'), and visibility settings (local by default, or public on-chain).");
+    NameOrAddressSchema.describe("String format: Reference an EXISTING object by its name (local mark) or on-chain object ID. Use when the object already exists."),
+    TypeNamedObjectSchema.describe("Object format: CREATE a NEW object with token type specification for payments. Includes optional name, tags, visibility settings, AND a specific token type (e.g., '0x2::wow::WOW' or '0x2::usdt::USDT'). Use this when you need to specify what token the object will use for payments but don't need permission management."),
+]).describe("Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with token type specification for payments. The object format includes name, tags, visibility settings, and a required token type. This is used when you need to specify the payment token but don't need permission management.");
 // 定义 CallResult schema
 export const CallResultSchema = z.discriminatedUnion("type", [
     SubmissionCallSchema,

package/dist/schema/call/contact.js

@@ -32,7 +32,7 @@ export const CallContact_DataSchema = z.object({
     location: LongNameSchema.optional().describe("Physical or virtual location information for this contact"),
     ims: ImsOperationSchema.optional().describe("IM contact list operation: add, set, remove, or clear instant messaging contacts"),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Receive objects sent to this contact object and unwrap them to the permission owner"),
-}).strict().describe("On-chain Contact operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, permission, ...} to create a Contact. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Contact operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Contact. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 // CallContact_InputSchema - Complete input schema for Contact tool
 export const CallContact_InputSchema = z.object({
     data: CallContact_DataSchema.describe("Contact operation data containing object reference and operations to perform"),

package/dist/schema/call/demand.js

@@ -43,7 +43,7 @@ export const CallDemand_DataSchema = z.object({
     guards: GuardsSchema.optional().describe('Validation Guard list for the Demand object. Used to verify whether the service recommended by the user meets the requirements'),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object.'),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe('Contact object.'),
-}).strict().describe("On-chain Demand operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, permission, ...} to create a Demand. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Demand operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Demand. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallDemand_InputSchema = z.object({
     data: CallDemand_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/handler.js

@@ -21,6 +21,22 @@ export function handleCallResult(result) {
     // Handle transaction result (contains digest field)
     if (result && "digest" in result) {
         const r = ResponseData(result);
+        const txStatus = result?.effects?.status?.status;
+        const txError = result?.effects?.status?.error;
+        const isSuccess = txStatus === "success";
+        if (!isSuccess) {
+            const output = {
+                message: `Transaction failed: ${txError || txStatus || "unknown error"}`,
+                result: { type: "error", error: txError || txStatus || "transaction failed" },
+            };
+            return {
+                content: [
+                    { type: "text", text: output.message },
+                    { type: "text", text: JSON.stringify(r) },
+                ],
+                structuredContent: output,
+            };
+        }
         const output = {
             message: "Transaction completed successfully",
             result: { type: "transaction", ...result },

package/dist/schema/call/machine.js

@@ -129,7 +129,7 @@ If parsing fails, error includes line number and column information.`),
     publish: z.boolean().optional().describe('Whether to publish the object. After the object is published, new Progress objects can be generated; and node settings will no longer be changeable.'),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object.'),
     um: z.union([z.string(), z.null()]).optional().describe('Contact object.'),
-}).strict().describe("On-chain Machine operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, permission, ...} to create a Machine. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Machine operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Machine. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallMachine_InputSchema = z.object({
     data: CallMachine_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/permission.js

@@ -109,7 +109,7 @@ export const CallPermission_DataSchema = z.object({
     builder: AccountOrMark_AddressSchema.optional().describe("Set or transfer ownership of the Permission object to the specified user ID. The creator automatically becomes the builder; only the builder can transfer ownership to other users."),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this object and send them to the builder(owner).'),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object."),
-}).strict().describe("On-chain Permission operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, tag?, ...} to create a Permission. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Permission operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, tags?, ...} to create a Permission. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 // 定义输入schema
 export const CallPermission_InputSchema = z.object({
     data: CallPermission_DataSchema,

package/dist/schema/call/progress.js

@@ -15,7 +15,7 @@ export const OperateSchema = z.object({
     message: z.string().optional().describe("Operation result message."),
 }).strict().describe("Advance Progress object: lock operation permission (hold=true) or submit operation result (hold=false or omitted).");
 export const CallProgress_DataSchema = z.object({
-    object: NameOrAddressSchema.describe("Progress object ID or name"),
+    object: NameOrAddressSchema.describe("Progress object ID or name."),
     task: NameOrAddressSchema.optional().describe("Task ID. Cannot be changed after setting."),
     repository: ObjectsSchema.optional().describe("Consensus data Repository object list."),
     progress_namedOperator: ProgressNamedOperatorSchema.optional().describe("Manage operators for Progress permission namespace."),

package/dist/schema/call/repository.js

@@ -77,7 +77,7 @@ export const CallRepository_DataSchema = z.object({
     rewards: ObjectsSchema.optional().describe("Reward object list. Used for data contribution incentives."),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object."),
-}).strict().describe("On-chain Repository operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, permission, ...} to create a Repository. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Repository operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, permission, ...} to create a Repository. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallRepository_InputSchema = z.object({
     data: CallRepository_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/reward.js

@@ -38,7 +38,7 @@ export const CallReward_DataSchema = z.object({
     guard_expiration_time: z.union([z.number().int().min(1), z.null()]).optional().describe("Add expiration time(ms). Before this time expires, new Guard and fund allocation rules cannot be added."),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object."),
-}).strict().describe("On-chain Reward operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, type, permission, ...} to create a Reward. NOTE: 'name' goes INSIDE 'object', NOT at the data root level.'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Reward operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create a Reward. NOTE: 'name' goes INSIDE 'object', NOT at the data root level.'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallReward_InputSchema = z.object({
     data: CallReward_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/service.js

@@ -80,7 +80,7 @@ export const CallService_DataSchema = z.object({
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name."),
     pause: z.boolean().optional().describe("Whether to pause accepting new orders."),
     publish: z.boolean().optional().describe("Whether to publish the Service. After publishing, customers can place orders; at the same time, service commitments such as machine, order_allocators, arbitrations, etc. will be immutable."),
-}).strict().describe("On-chain Service operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, type, permission, ...} to create a Service. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Service operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create a Service. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallService_InputSchema = z.object({
     data: CallService_DataSchema,
     env: CallEnvSchema.optional(),

package/dist/schema/call/treasury.js

@@ -68,7 +68,7 @@ export const CallTreasury_DataSchema = z.object({
     external_withdraw_guard: ExternalWithdrawGuardSchema.optional().describe("Set external withdrawal Guard for Treasury object"),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this object and send them to the owner of its Permission object."),
     um: z.union([NamedObjectSchema, z.null()]).optional().describe("Contact object."),
-}).strict().describe("On-chain Treasury operations. USAGE: (1) CREATE NEW: Set 'object' field with {name, type, permission, ...} to create a Treasury. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with object ID or name. The 'object' field is CRITICAL and REQUIRED in both cases.");
+}).strict().describe("On-chain Treasury operations. USAGE: (1) CREATE NEW: Set 'object' field with OBJECT format {name, type_parameter, permission, ...} to create a Treasury. NOTE: 'name' goes INSIDE 'object', NOT at the data root level. 'permission' can be a new Permission object or reference an existing one - check 'object' field description for details. (2) OPERATE EXISTING: Set 'object' field with STRING format (object ID or name). The 'object' field is CRITICAL and REQUIRED in both cases. STRING for existing, OBJECT for new creation.");
 export const CallTreasury_InputSchema = z.object({
     data: CallTreasury_DataSchema,
     env: CallEnvSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wowok_agent",
-  "version": "2.1.37",
+  "version": "2.1.38",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,7 +30,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "lodash": "^4.18.1",
-    "wowok": "2.1.37",
+    "wowok": "2.1.38",
     "zod": "^3.25.76"
   },
   "devDependencies": {