@wowok/agent-mcp 2.2.15 → 2.2.17

package/dist/index.d.ts

@@ -15693,7 +15693,7 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         name_or_address?: string | undefined;
         local_mark_first?: boolean | undefined;
     }>]>;
-    all_type: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"CoinWrapper">, z.ZodNull]>>;
     cursor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
     limit: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
     no_cache: z.ZodOptional<z.ZodBoolean>;
@@ -15704,9 +15704,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }, {
@@ -15715,9 +15715,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }>]>]>, {
@@ -15803,9 +15803,9 @@ declare const WatchQueryOperationsSchema: z.ZodEffects<z.ZodUnion<[z.ZodDiscrimi
         local_mark_first?: boolean | undefined;
     };
     query_type: "onchain_received";
+    type?: string | null | undefined;
     no_cache?: boolean | undefined;
     network?: import("@wowok/wowok").ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
     cursor?: string | null | undefined;
     limit?: number | null | undefined;
 }, unknown>;

package/dist/index.js

@@ -10,6 +10,10 @@ import { CallService, CallMachine, CallProgress, CallPermission, CallGuard, Call
 import { areSchemasAvailable, getSchemaIndex, processSchemaQuery, } from "./schema-query/index.js";
 const SERVER_DESCRIPTION = `WoWok MCP Server - Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.
 
+## CRITICAL: Schema Discovery Rule
+
+When the current context does not contain a tool's input/output schema, or when you are uncertain whether the schema you have is complete and up-to-date, you MUST query it first before calling the tool. Use schema_query for operational tool schemas or wowok_buildin_info for protocol constants and reference data. Never guess schema parameters, query instruction IDs, or type codes — always retrieve them from the live server.
+
 ## Token System Overview
 
 ### Default Platform Token: WOW
@@ -87,7 +91,7 @@ Token amounts are HIGHLY SENSITIVE. Always:
 | Sign WIP file | wip_file (sign) | account_operation (signData) |
 | Verify WIP file integrity | wip_file (verify) | query_toolkit |
 | Send encrypted file via messenger | messenger_operation (send_file) | wip_file |
-| Generate witness timestamp (WTS) | messenger_operation (generate_wts) | wip_file |
+| Generate Witness Timestamped Sequence (WTS) | messenger_operation (generate_wts) | wip_file |
 | Query protocol constants | wowok_buildin_info | query_toolkit |
 | Query tool schemas | schema_query | wowok_buildin_info |
 
@@ -598,12 +602,15 @@ const WatchQueryOperationsSchema = z.preprocess((input) => {
         z.object({
             query_type: z.literal("onchain_received"),
             name_or_address: AccountOrMark_AddressAISchema.describe("Name or address of the object that received payments/items - can be a string (name/address) or full object"),
-            all_type: z.boolean().optional().describe("Set to true to query all token types received; defaults to the object's Token type '0x2::payment::CoinWrapper<TOKEN>' (Coins wrapper sent via Payment object). If the object has no Token type, the call will fail."),
+            type: z.union([z.string(), z.literal("CoinWrapper"), z.null()]).optional().describe("Type filter for querying received objects. " +
+                "- If undefined or null: query all types (equivalent to the old all_type=true). " +
+                "- If 'CoinWrapper': query CoinWrapper type for the object's token (equivalent to the old all_type=false). " +
+                "- If string: query specific StructType (e.g., '0x2::payment::CoinWrapper<0x2::wow::WOW>')."),
             cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor from previous page"),
             limit: z.union([z.number(), z.null()]).optional().describe("Max records per page"),
             no_cache: z.boolean().optional().describe("Set to true to bypass cache and fetch fresh on-chain data"),
             network: EntrypointSchema.optional(),
-        }).describe("Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and all_type filter. Returns: ReceivedBalance | ReceivedNormal[]"),
+        }).describe("Query objects (Payments, Tokens, NFTs) received by a specific object. Use to track incoming payments or items sent to an on-chain object. Supports pagination and type filter. Returns: ReceivedBalance | ReceivedNormal[]"),
     ]),
 ]));
 async function handleOnchainOperations(args) {
@@ -1040,7 +1047,7 @@ async function handleWatchQueryOperations(args) {
         case "onchain_received": {
             const queryResult = await query_received({
                 name_or_address: normalizeAccountOrMark(validated.name_or_address),
-                all_type: validated.all_type,
+                type: validated.type,
                 cursor: validated.cursor,
                 limit: validated.limit,
                 no_cache: validated.no_cache,
@@ -1348,7 +1355,7 @@ async function main() {
         _meta: createToolMeta("operation", ["info", "local", "private", "data-management", "off-chain"]),
     }, handleInfoOperation);
     server.registerTool("wip_file", {
-        title: "🤝 Witness Information Promise File Operations",
+        title: "🤝 Witness Immutable Promise File Operations",
         description: "generate (create WIP files from markdown and images), verify (integrity check), sign (add signatures), or wip2html (convert to HTML).",
         inputSchema: WipOperationsSchema,
         outputSchema: z.object({
@@ -1394,7 +1401,7 @@ async function main() {
             + "ONCHAIN (blockchain):\n"
             + "7. onchain_personal_profile — Query any user's PUBLIC on-chain profile: social links, reputation (likes/dislikes), personal info records, voting history, referrer.\n"
             + "8. onchain_objects — Batch query on-chain WOWOK objects by ID or name: supports Service, Machine, Order, Treasury, Reward, Arb, Personal, Contact, and more.\n"
-            + "9. onchain_received — Query objects (Payments, Tokens, NFTs) received by a specific object. Supports pagination and all_type filter.\n\n"
+            + "9. onchain_received — Query objects (Payments, Tokens, NFTs) received by a specific object. Supports pagination and type filter.\n\n"
             + "For dynamic table data queries (pagination, table items), use the 'onchain_table_data' tool.",
         inputSchema: WatchQueryOperationsSchema,
         outputSchema: z.object({

package/dist/schema/common/index.d.ts

@@ -568,44 +568,6 @@ export declare const QueryEnvSchema: z.ZodObject<{
     no_cache?: boolean | undefined;
     network?: ENTRYPOINT | undefined;
 }>;
-export declare const QueryReceivedSchema: z.ZodObject<{
-    no_cache: z.ZodOptional<z.ZodBoolean>;
-    network: z.ZodOptional<z.ZodEnum<[ENTRYPOINT.Localnet, ENTRYPOINT.Testnet]>>;
-} & {
-    name_or_address: z.ZodUnion<[z.ZodString, z.ZodObject<{
-        name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-        local_mark_first: z.ZodOptional<z.ZodBoolean>;
-    }, "strict", z.ZodTypeAny, {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    }, {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    }>]>;
-    all_type: z.ZodOptional<z.ZodBoolean>;
-    cursor: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
-    limit: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodNull]>>;
-}, "strict", z.ZodTypeAny, {
-    name_or_address: string | {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    };
-    no_cache?: boolean | undefined;
-    network?: ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
-    cursor?: string | null | undefined;
-    limit?: number | null | undefined;
-}, {
-    name_or_address: string | {
-        name_or_address?: string | undefined;
-        local_mark_first?: boolean | undefined;
-    };
-    no_cache?: boolean | undefined;
-    network?: ENTRYPOINT | undefined;
-    all_type?: boolean | undefined;
-    cursor?: string | null | undefined;
-    limit?: number | null | undefined;
-}>;
 export declare const ReceivedBalanceObjectSchema: z.ZodObject<{
     id: z.ZodString;
     balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
@@ -837,7 +799,6 @@ export type GuardTableItem = z.infer<typeof GuardTableItemSchema>;
 export type Entrypoint = z.infer<typeof EntrypointSchema>;
 export type ObjectBase = z.infer<typeof ObjectBaseSchema>;
 export type QueryEnv = z.infer<typeof QueryEnvSchema>;
-export type QueryReceived = z.infer<typeof QueryReceivedSchema>;
 export type ReceivedBalance = z.infer<typeof ReceivedBalanceSchema>;
 export type ReceivedNormal = z.infer<typeof ReceivedNormalSchema>;
 export type QueryReceivedResult = z.infer<typeof QueryReceivedResultSchema>;

package/dist/schema/common/index.js

@@ -272,12 +272,6 @@ export const QueryEnvSchema = z.object({
     no_cache: z.boolean().optional().describe("Whether to disable cache"),
     network: EntrypointSchema.optional(),
 }).strict().describe("Query environment parameters");
-export const QueryReceivedSchema = QueryEnvSchema.extend({
-    name_or_address: AccountOrMark_AddressAISchema,
-    all_type: z.boolean().optional().describe("Whether to query all types of received objects"),
-    cursor: z.union([z.string(), z.null()]).optional().describe("Pagination cursor"),
-    limit: z.union([z.number(), z.null()]).optional().describe("Number of records returned per page"),
-}).strict().describe("Request parameters for querying object's received objects");
 export const ReceivedBalanceObjectSchema = z.object({
     id: z.string().describe("Received CoinWrapper object ID"),
     balance: BalanceTypeSchema,

package/dist/schema/messenger/index.d.ts

@@ -496,8 +496,8 @@ export declare const MessageFilterSchema: z.ZodObject<{
     skipAutoMarkViewed: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-    limit?: number | undefined;
     account?: string | undefined;
+    limit?: number | undefined;
     contentType?: "text" | "wip" | "zip" | "wts" | undefined;
     direction?: "received" | "sent" | undefined;
     msgType?: 1 | 3 | undefined;
@@ -538,8 +538,8 @@ export declare const MessageFilterSchema: z.ZodObject<{
     viewedAtEnd?: number | undefined;
 }, {
     status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-    limit?: number | undefined;
     account?: string | undefined;
+    limit?: number | undefined;
     contentType?: "text" | "wip" | "zip" | "wts" | undefined;
     direction?: "received" | "sent" | undefined;
     msgType?: 1 | 3 | undefined;
@@ -1645,8 +1645,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
         skipAutoMarkViewed: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1687,8 +1687,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
         viewedAtEnd?: number | undefined;
     }, {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1732,8 +1732,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
     operation: "watch_messages";
     filter?: {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;
@@ -1777,8 +1777,8 @@ export declare const MessengerOperationInputSchema: z.ZodDiscriminatedUnion<"ope
     operation: "watch_messages";
     filter?: {
         status?: "pending" | "confirmed" | "read" | "failed" | "rejected" | "decrypted" | "decrypt_failed" | undefined;
-        limit?: number | undefined;
         account?: string | undefined;
+        limit?: number | undefined;
         contentType?: "text" | "wip" | "zip" | "wts" | undefined;
         direction?: "received" | "sent" | undefined;
         msgType?: 1 | 3 | undefined;

package/dist/schema/query/index.js

@@ -3,7 +3,7 @@ import { TokenTypeInfoSchema, QueryLocalMarkListResultSchema, QueryAccountListRe
 import { AccountOrMark_AddressSchema, BalanceTypeSchema, EntrypointSchema, GuardIdentifierSchema, GuardTableItemSchema, NameOrAddressSchema, ObjectBaseSchema, ObjectTypeSchema, QueryIdSchema, SupportedValueSchema, ValueTypeSchema, QueryReceivedResultSchema, LongNameSchema, DescriptionSchema } from "../common/index.js";
 import { isValidPermissionIndex } from '../utils/permission-index-utils.js';
 import { isValidGuardQueryId, isValidGuardQueryIdOrName } from '../utils/guard-query-utils.js';
-import { isWitnessType, } from "@wowok/wowok";
+import { ENTITY_LINKER_ADDRESS, ENTITY_REGISTRAR_ADDRESS, isWitnessType, } from "@wowok/wowok";
 import { DiscountType as WDiscountType } from "@wowok/wowok";
 import { QueryEnvSchema } from "../common/index.js";
 const MAX_MULTI_OPERANDS = 8;
@@ -402,7 +402,7 @@ export const WitnessTypeSchema = z.number()
     .int()
     .refine(isWitnessType, {
     message: 'Invalid WitnessType value',
-});
+}).describe("When specified, the query retrieves data from the associated (witness) object instead of the queried object itself. This enables cross-object queries within Guard validation logic. Available WitnessTypes and their use cases:\n\n- TypeOrderProgress (100): Query an Order's associated Progress object. Use case: Check if order has reached a specific workflow node (e.g., 'complete') before allowing reward claims.\n- TypeOrderMachine (101): Query an Order's associated Machine (workflow definition). Use case: Verify the workflow structure or check node configurations.\n- TypeOrderService (102): Query an Order's parent Service object. Use case: Validate the service offering details or check service-level configurations.\n- TypeProgressMachine (103): Query a Progress's associated Machine. Use case: Access workflow definition from a Progress context.\n- TypeArbOrder (104): Query an Arb's associated Order. Use case: In arbitration voting guards, verify order details like payment amount or service ID.\n- TypeArbArbitration (105): Query an Arb's parent Arbitration service. Use case: Access arbitration configuration or fee settings from within an Arb case.\n- TypeArbProgress (106): Query an Arb's associated Progress. Use case: Check order workflow state during arbitration validation.\n- TypeArbMachine (107): Query an Arb's associated Machine. Use case: Access workflow definition for dispute context analysis.\n- TypeArbService (108): Query an Arb's associated Service. Use case: Verify service terms or compensation fund status during arbitration.\n\nExample: To validate that an order has reached the 'complete' node, query the Order with convert_witness=TypeOrderProgress and check the Progress's current_node field.");
 export const GuardQueryIdSchema = z.number().int().min(0).refine((id) => isValidGuardQueryId(id), { message: "Invalid guard query ID. ID not found in GUARDQUERY array." }).describe("ID of the data query instruction for the Object.");
 export const GuardNodeSchema = z.lazy(() => z.discriminatedUnion('type', [
     z.object({
@@ -417,10 +417,10 @@ export const GuardNodeSchema = z.lazy(() => z.discriminatedUnion('type', [
         ]).describe("ID or name of the wowok object data query instruction. Can be a numeric ID (e.g., 1001) or a name string (e.g., 'permission.description'). Name matching is case-insensitive."),
         object: z.object({
             identifier: GuardIdentifierSchema,
-            convert_witness: WitnessTypeSchema.optional().describe("Optional. When specified, the query retrieves data from the associated object instead of the object itself. For example, querying an order with convert_witness=TypeOrderProgress retrieves the associated Progress object data."),
+            convert_witness: WitnessTypeSchema.optional(),
         }).strict().describe("The object to query from the Guard table."),
         parameters: z.array(GuardNodeSchema).describe("Parameters required by the query (must match the query's expected parameters type)."),
-    }).strict().describe("Returns the result of executing a data query instruction on the specified object. The return type depends on the query being executed. SPECIAL NOTE for EntityLinker/EntityRegistrar queries: Use system addresses in the Guard table - ENTITY_LINKER_ADDRESS (0xaaa) for EntityLinker queries, ENTITY_REGISTRAR_ADDRESS (0xaab) for EntityRegistrar queries."),
+    }).strict().describe(`Returns the result of executing a data query instruction on the specified object. The return type depends on the query being executed. SPECIAL NOTE for EntityLinker/EntityRegistrar queries: Use system addresses in the Guard table -${ENTITY_LINKER_ADDRESS} for EntityLinker queries, ${ENTITY_REGISTRAR_ADDRESS} for EntityRegistrar queries.`),
     z.object({
         type: z.literal('logic_as_u256_greater_or_equal'),
         nodes: z.array(GuardNodeSchema),

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-05-20T11:48:42.252Z",
+  "generatedAt": "2026-05-21T08:51:01.877Z",
   "tools": [
     {
       "name": "onchain_operations",

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.2.15",
+  "version": "2.2.17",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "node",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wowok-ai/agent.git"
+  },
+  "homepage": "https://wowok.net",
   "files": [
     "dist",
     "docs",
@@ -31,7 +36,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.2.13",
+    "@wowok/wowok": "2.2.14",
     "lodash": "^4.18.1",
     "zod": "^3.25.76"
   },