@wowok/agent-mcp 2.6.0 → 2.6.3

package/dist/schema/call/base.js

@@ -15,9 +15,30 @@ export function strictParse(schema, input, fieldName = "input") {
     const inputFields = Object.keys(input || {});
     const unknownFields = inputFields.filter(f => !allowedFields.includes(f));
     if (unknownFields.length > 0) {
-        throw new Error(`Unknown ${fieldName} field(s): ${unknownFields.join(', ')}`);
+        throw new Error(`Unknown ${fieldName} field(s): ${unknownFields.join(', ')}. ` +
+            `Allowed fields: ${allowedFields.join(', ')}. ` +
+            `Remove the unknown field(s) or check the schema for the correct field name.`);
     }
-    return schema.parse(input);
+    const result = schema.safeParse(input);
+    if (!result.success) {
+        const errorLines = result.error.issues.map(issue => {
+            const path = issue.path.length > 0
+                ? issue.path.map(p => typeof p === "number" ? `[${p}]` : p).join(".").replace(".[", "[")
+                : "(root)";
+            let extras = "";
+            const issueAny = issue;
+            if (issue.code === "invalid_type") {
+                const expected = issueAny.expected;
+                const received = issueAny.received;
+                if (typeof expected === "string" && typeof received === "string") {
+                    extras = ` (expected: ${expected}; received: ${received})`;
+                }
+            }
+            return `  - ${fieldName}.${path} [${issue.code}]: ${issue.message}${extras}`;
+        });
+        throw new Error(`${fieldName} validation failed with ${result.error.issues.length} error(s):\n${errorLines.join("\n")}`);
+    }
+    return result.data;
 }
 export const NamedObjectSchema = z.object({
     name: NameSchema.optional().describe("The name of the object"),
@@ -227,7 +248,7 @@ export const SemanticSummarySchema = z.object({
 export const CallResponseErrorSchema = z.object({
     type: z.literal("error").describe("Discriminator for this result variant. Constraint: always 'error'. Example: 'error'"),
     error: z.string().describe("Human-readable error message from the chain or SDK. Relation: enriched via enrichMoveError before classification. Example: 'Insufficient balance for gas'"),
-    error_code: z.enum(["invalid_parameter", "guard_rejected", "state_conflict", "insufficient_balance", "object_not_found", "permission_denied", "immutable_violation", "network_error", "rate_limit", "gas_exceeded", "bcs_error", "signature_error", "config_error", "unknown"]).optional().describe("Error classification for programmatic recovery. Constraint: enum of 14 values. Relation: drives Recover Loop strategy selection. Example: 'insufficient_balance'"),
+    error_code: z.enum(["invalid_parameter", "guard_rejected", "state_conflict", "insufficient_balance", "object_not_found", "permission_denied", "immutable_violation", "network_error", "rate_limit", "gas_exceeded", "bcs_error", "signature_error", "config_error", "wip_verification_failed", "unknown"]).optional().describe("Error classification for programmatic recovery. Constraint: enum of 15 values (must match ErrorCode in semantic.ts). Relation: drives Recover Loop strategy selection. Example: 'insufficient_balance'"),
     retryable: z.boolean().optional().describe("Whether the same call can be retried as-is. Constraint: true for network_error, rate_limit, gas_exceeded, and insufficient_balance. Example: true"),
     recovery_hint: z.string().optional().describe("Recovery suggestion for AI or user. Relation: paired with error_code to guide Recover Loop. Example: 'Claim faucet tokens then retry'"),
     related_object: z.string().optional().describe("Object ID related to the error, if any. Example: '0x123...'"),
@@ -263,7 +284,7 @@ export const SubmissionCallSchema = z.object({
         object: NameOrAddressSchema.describe("Guard object name or ID to verify against. Example: 'my-delivery-guard' or '0x123...'"),
         impack: z.boolean().describe("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"),
     }).strict()).max(MAX_GUARD_COUNT_PASSPORT).describe(`Array of Guard objects to verify. Constraint: at most ${MAX_GUARD_COUNT_PASSPORT} entries (MAX_GUARD_COUNT_PASSPORT). Relation: each entry corresponds to a Guard bound to the operation.`),
-    submission: z.array(GuardSubmissionToFillSchema).describe("User-submitted data for each Guard. Relation: one entry per Guard in the guard array; fill submission fields and resubmit via call_with_submission."),
+    submission: z.array(GuardSubmissionToFillSchema).describe("User-submitted data for each Guard. Relation: one entry per Guard in the guard array; fill submission fields and resubmit via call_with_submission. PLACEMENT: this `submission` field is at the SAME level as `data` and `env` in the operation input — NOT inside `data.data`. Example structure: {tool:'onchain_operations', data:{operation_type:'order', data:{object:'my_order', progress:{...}}}, submission:{type:'submission', guard:[...], submission:[...]}}"),
 }).strict().describe("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'.");
 export const TypedPermissionObjectSchema = z.union([
     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."),
@@ -292,7 +313,7 @@ export const CallResultSchema = z.discriminatedUnion("type", [
     }),
     CallPendingConfirmationSchema,
 ]).describe("Discriminated union of 6 result types: 'transaction' (raw Wow response), 'submission' (Guard verification needed), 'error' (failed with error_code), 'data' (query result array), 'null' (no-op completed), 'pending_confirmation' (ConfirmGate blocked — re-call with env.confirmed=true). AI should check result.type first to determine how to process the response.");
-export const ObjectsSchema = z.union([
+export const ObjectsSchema = z.preprocess((val) => (Array.isArray(val) ? { op: 'add', objects: val } : val), z.union([
     z.object({
         op: z.union([z.literal('add'), z.literal('set')]),
         objects: z.array(NameOrAddressSchema).describe('List of object IDs or names to add or set'),
@@ -304,7 +325,7 @@ export const ObjectsSchema = z.union([
     z.object({
         op: z.literal('clear'),
     }).strict(),
-]);
+]));
 export const VerifyMismatchSchema = z.object({
     dimension: z.enum(["created", "modified", "released", "state", "event"]).describe("Verify dimension that mismatched. Example: 'created'"),
     expected: z.string().describe("What the Expect Loop declared. Example: 'Service object created'"),

package/dist/schema/call/bridge.d.ts

@@ -2707,19 +2707,19 @@ export declare const BridgeCallOutputSchema: z.ZodObject<{
     }>, z.ZodObject<{
         type: z.ZodLiteral<"error">;
         error: z.ZodString;
-        error_code: z.ZodOptional<z.ZodEnum<["invalid_parameter", "guard_rejected", "state_conflict", "insufficient_balance", "object_not_found", "permission_denied", "immutable_violation", "network_error", "unknown"]>>;
+        error_code: z.ZodOptional<z.ZodEnum<["invalid_parameter", "guard_rejected", "state_conflict", "insufficient_balance", "object_not_found", "permission_denied", "immutable_violation", "network_error", "rate_limit", "gas_exceeded", "bcs_error", "signature_error", "config_error", "wip_verification_failed", "unknown"]>>;
         retryable: z.ZodOptional<z.ZodBoolean>;
         recovery_hint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         type: "error";
         error: string;
-        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | undefined;
+        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "wip_verification_failed" | undefined;
         retryable?: boolean | undefined;
         recovery_hint?: string | undefined;
     }, {
         type: "error";
         error: string;
-        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | undefined;
+        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "wip_verification_failed" | undefined;
         retryable?: boolean | undefined;
         recovery_hint?: string | undefined;
     }>]>;
@@ -3393,7 +3393,7 @@ export declare const BridgeCallOutputSchema: z.ZodObject<{
     } | {
         type: "error";
         error: string;
-        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | undefined;
+        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "wip_verification_failed" | undefined;
         retryable?: boolean | undefined;
         recovery_hint?: string | undefined;
     };
@@ -3528,7 +3528,7 @@ export declare const BridgeCallOutputSchema: z.ZodObject<{
     } | {
         type: "error";
         error: string;
-        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | undefined;
+        error_code?: "unknown" | "invalid_parameter" | "guard_rejected" | "state_conflict" | "insufficient_balance" | "object_not_found" | "permission_denied" | "immutable_violation" | "network_error" | "rate_limit" | "gas_exceeded" | "bcs_error" | "signature_error" | "config_error" | "wip_verification_failed" | undefined;
         retryable?: boolean | undefined;
         recovery_hint?: string | undefined;
     };

package/dist/schema/call/bridge.js

@@ -444,7 +444,9 @@ export const BridgeCallOutputSchema = z.object({
                 .enum([
                 "invalid_parameter", "guard_rejected", "state_conflict",
                 "insufficient_balance", "object_not_found", "permission_denied",
-                "immutable_violation", "network_error", "unknown",
+                "immutable_violation", "network_error", "rate_limit",
+                "gas_exceeded", "bcs_error", "signature_error",
+                "config_error", "wip_verification_failed", "unknown",
             ])
                 .optional()
                 .describe("Error classification for programmatic recovery"),

package/dist/schema/call/contact.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { WithPermissionObjectSchema, CallEnvSchema, SubmissionCallSchema } from "./base.js";
-import { NameOrAddressSchema, ReceivedObjectsOrRecentlySchema, DescriptionSchema, LongNameSchema, NameSchema } from "../common/index.js";
+import { NameOrAddressSchema, ReceivedObjectsOrRecentlySchema, DescriptionSchema, LongNameSchema, NameSchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from "../common/index.js";
 export const ImEntrySchema = z.object({
     at: NameOrAddressSchema.describe("Contact's account address or name for instant messaging"),
     description: LongNameSchema.optional().describe("Optional description or note about this contact"),
@@ -28,7 +28,7 @@ export const CallContact_DataSchema = z.object({
     description: DescriptionSchema.optional().describe("Contact object description or public information"),
     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"),
+    owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Receive objects sent to this Contact object and unwrap them to the permission owner." + RECEIVE_FORMAT_BLOCK_OBJECTS),
 }).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.");
 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.d.ts

@@ -171,7 +171,7 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
     }>>;
     description: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     location: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-    rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+    rewards: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
         op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
         objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     }, "strict", z.ZodTypeAny, {
@@ -195,7 +195,15 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         op: "clear";
     }, {
         op: "clear";
-    }>]>>;
+    }>]>, {
+        op: "set" | "add";
+        objects: string[];
+    } | {
+        op: "remove";
+        objects: string[];
+    } | {
+        op: "clear";
+    }, unknown>>;
     feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
         who: z.ZodObject<{
             name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -427,15 +435,7 @@ export declare const CallDemand_DataSchema: z.ZodObject<{
         feedback?: string | undefined;
         acceptance_score?: number | undefined;
     }[] | undefined;
-    rewards?: {
-        op: "set" | "add";
-        objects: string[];
-    } | {
-        op: "remove";
-        objects: string[];
-    } | {
-        op: "clear";
-    } | undefined;
+    rewards?: unknown;
     guards?: {
         guard: {
             guard: string;
@@ -543,7 +543,7 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
         }>>;
         description: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         location: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
-        rewards: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        rewards: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodObject<{
             op: z.ZodUnion<[z.ZodLiteral<"add">, z.ZodLiteral<"set">]>;
             objects: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
         }, "strict", z.ZodTypeAny, {
@@ -567,7 +567,15 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             op: "clear";
         }, {
             op: "clear";
-        }>]>>;
+        }>]>, {
+            op: "set" | "add";
+            objects: string[];
+        } | {
+            op: "remove";
+            objects: string[];
+        } | {
+            op: "clear";
+        }, unknown>>;
         feedback: z.ZodOptional<z.ZodArray<z.ZodObject<{
             who: z.ZodObject<{
                 name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -799,15 +807,7 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             feedback?: string | undefined;
             acceptance_score?: number | undefined;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
         guards?: {
             guard: {
                 guard: string;
@@ -1200,15 +1200,7 @@ export declare const CallDemand_InputSchema: z.ZodObject<{
             feedback?: string | undefined;
             acceptance_score?: number | undefined;
         }[] | undefined;
-        rewards?: {
-            op: "set" | "add";
-            objects: string[];
-        } | {
-            op: "remove";
-            objects: string[];
-        } | {
-            op: "clear";
-        } | undefined;
+        rewards?: unknown;
         guards?: {
             guard: {
                 guard: string;

package/dist/schema/call/demand.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { WithPermissionObjectSchema, ObjectsSchema, CallEnvSchema, SubmissionCallSchema, } from './base.js';
 import { ServiceGuardSchema } from '../query/index.js';
-import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, NameOrAddressSchema, ReceivedObjectsOrRecentlySchema } from '../common/index.js';
+import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, NameOrAddressSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from '../common/index.js';
 export const GuardsSchema = z.discriminatedUnion('op', [
     z.object({
         op: z.literal('add'),
@@ -37,7 +37,7 @@ export const CallDemand_DataSchema = z.object({
     rewards: ObjectsSchema.optional().describe('Reward information of the Demand object'),
     feedback: z.array(FeedbackInfoSchema).optional().describe('User feedback information for the Demand 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.'),
+    owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this Demand object and send them to the owner of its Permission object.' + RECEIVE_FORMAT_BLOCK_OBJECTS),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe('Contact object ID or name.'),
 }).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({

package/dist/schema/call/guard.js

@@ -96,7 +96,7 @@ export const GuardBindingHintSchema = z.object({
         .describe("Whether the Guard references the Host Object itself (circular reference pattern). true=Guard queries the Host Object it binds to."),
 }).strict().describe("Optional semantic hint for Guard capability system. Provides intent + binding context so the MCP server can derive GuardPuzzle, run risk assessment, and generate confirmation text. Strongly recommended: fill this field to enable puzzle_status, matched_scene, suggested_patterns, confirmation_text, and pending_questions in the response guard_advice.");
 export const CallGuard_DataSchema = z.object({
-    namedNew: NamedObjectSchema.optional().describe("Name and optional tags for the new Guard object. Set 'onChain: true' to create a public on-chain identity. When using root.type='file', this field OVERRIDES namedNew in the file."),
+    namedNew: NamedObjectSchema.optional().describe("Name and optional tags for the new Guard object. Set 'onChain: true' to create a public on-chain identity. When using root.type='file', this field OVERRIDES namedNew in the file. CIRCULAR DEPENDENCY (DOC-01): When a Guard queries a Service that hasn't been created yet, use a LocalMark NAME (not address) in the query table — the name is resolved to an address at transaction build time. Workflow: (1) Create Service (Phase 1, no publish) → (2) Create Guard referencing Service by name → (3) Update Service.buy_guard = Guard address → (4) Publish Service."),
     description: DescriptionSchema.optional().describe("Guard description. When using root.type='file', this field OVERRIDES description in the file."),
     table: z.array(GuardTableItemBaseSchema).optional().describe("Data table of the Guard object. When using root.type='file', this field OVERRIDES table in the file."),
     root: CallGuard_RootSchema.describe("Root definition: either a direct GuardNode (must be a logical operation returning Bool) or a file reference (type='file'). When type='file', the file can define all Guard fields (namedNew, description, table, root, rely), and schema fields override file content."),
@@ -126,7 +126,7 @@ export const CallGuard_DataSchema = z.object({
     return true;
 }, {
     message: "Invalid Guard root: When using 'identifier' as root, the referenced table item must exist and have value_type='Bool' (or 0)."
-}).describe("On-chain Guard creation. IMPORTANT: All defined data (include all submitted data) must be defined in the 'table' field. USAGE: Set 'namedNew' field with {name, tags?, onChain?} to name the new Guard. The Guard is immutable once created. Define the validation logic in 'root' field. When root.type='file', the file can contain all Guard fields, and any fields defined in the schema will OVERRIDE the file content.");
+}).describe("On-chain Guard creation. IMPORTANT: All defined data (include all submitted data) must be defined in the 'table' field. USAGE: Set 'namedNew' field with {name, tags?, onChain?} to name the new Guard (you may also use 'object' as an alias for 'namedNew' — the MCP preprocess will convert it automatically). The Guard is immutable once created. Define the validation logic in 'root' field. When root.type='file', the file can contain all Guard fields, and any fields defined in the schema will OVERRIDE the file content.");
 export const CallGuard_InputSchema = z.object({
     data: CallGuard_DataSchema.describe("Guard data definition."),
     env: CallEnvSchema.optional(),