@wowok/agent-mcp 2.6.0 → 2.6.3

package/dist/schema/call/machine.js

@@ -1,7 +1,23 @@
 import { z } from 'zod';
 import { WithPermissionObjectSchema, NamedObjectSchema, ObjectsSchema, CallEnvSchema, SubmissionCallSchema, } from './base.js';
 import { MachineNodeSchema, MachineForwardSchema } from '../query/index.js';
-import { ManyAccountOrMark_AddressSchema, NameOrAddressSchema, NameSchema, NotEmptyNameSchema, ReceivedObjectsOrRecentlySchema } from '../common/index.js';
+import { ManyAccountOrMark_AddressSchema, NameOrAddressSchema, NameSchema, NotEmptyNameSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from '../common/index.js';
+function validateEntryForward(nodes) {
+    for (const node of nodes) {
+        if (!node.pairs)
+            continue;
+        for (const pair of node.pairs) {
+            if (pair.prev_node === "") {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+const ENTRY_FORWARD_ERROR_MESSAGE = "Machine has no entry forward. At least one node must have a pair with prev_node=\"\" (empty string), " +
+    "which defines how Progress advances from the initial state (current=\"\") to the first node. " +
+    "Without an entry forward, the workflow will be permanently stuck. " +
+    "Example: {name: 'Subscribed', pairs: [{prev_node: '', forwards: [{name: 'Subscribe', weight: 1}]}]}";
 export const ProgressNamedOperatorSchema = z.object({
     op: z.union([z.literal('add'), z.literal('set'), z.literal('remove')]),
     name: NotEmptyNameSchema,
@@ -68,7 +84,17 @@ export const NodeSchema = z.discriminatedUnion('op', [
         op: z.literal('remove forward'),
         data: z.array(NodeRemoveForwardDataSchema).describe('List of operations to delete.'),
     }).strict().describe('Delete operations.'),
-]);
+])
+    .superRefine((data, ctx) => {
+    if ((data.op === 'add' || data.op === 'set') && data.bReplace === true) {
+        if (!validateEntryForward(data.nodes)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: ENTRY_FORWARD_ERROR_MESSAGE,
+            });
+        }
+    }
+});
 export const NodeJsonOrMarkdownFileSchema = z.object({
     json_or_markdown_file: z.string().describe(`Path to a JSON or Markdown file containing node array for COMPLETE REPLACEMENT of all nodes.
 
@@ -113,9 +139,29 @@ Supported formats: JSON array or Markdown with code blocks.
 If parsing fails, error includes line number and column information.`),
     pause: z.boolean().optional().describe('Whether to pause generating new Progress objects.'),
     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.'),
+    owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this Machine 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 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.");
+}).strict()
+    .refine((data) => {
+    if (data.publish !== true)
+        return true;
+    if (!data.node)
+        return true;
+    if ('json_or_markdown_file' in data.node)
+        return true;
+    if ('nodes' in data.node && Array.isArray(data.node.nodes)) {
+        const isCreatingNew = typeof data.object === 'object' && data.object !== null;
+        const isReplace = data.node.bReplace === true;
+        if (isCreatingNew || isReplace) {
+            const nodes = data.node.nodes;
+            if (Array.isArray(nodes) && nodes.length > 0 && typeof nodes[0] === 'object') {
+                return validateEntryForward(nodes);
+            }
+        }
+    }
+    return true;
+}, { message: ENTRY_FORWARD_ERROR_MESSAGE })
+    .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/order.d.ts

@@ -60,7 +60,7 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
         check_all_founded?: boolean | undefined;
     }>>;
     required_info: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodNull]>>;
-    progress: z.ZodOptional<z.ZodObject<{
+    progress: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         operation: z.ZodObject<{
             next_node_name: z.ZodEffects<z.ZodString, string, string>;
             forward: z.ZodEffects<z.ZodString, string, string>;
@@ -87,7 +87,14 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
             next_node_name: string;
         };
         message?: string | undefined;
-    }>>;
+    }>, {
+        op: "next" | "hold" | "unhold" | "adminUnhold";
+        operation: {
+            forward: string;
+            next_node_name: string;
+        };
+        message?: string | undefined;
+    }, unknown>>;
     arb_confirm: z.ZodOptional<z.ZodObject<{
         arb: z.ZodEffects<z.ZodString, string, string>;
         confirm: z.ZodBoolean;
@@ -121,81 +128,51 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
     }, {
         arb: string;
     }>>;
-    receive: z.ZodOptional<z.ZodObject<{
-        result: z.ZodUnion<[z.ZodObject<{
-            balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-            token_type: z.ZodEffects<z.ZodString, string, string>;
-            received: z.ZodArray<z.ZodObject<{
-                id: z.ZodString;
-                balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                payment: z.ZodString;
-            }, "strict", z.ZodTypeAny, {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }, {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }>, "many">;
-        }, "strict", z.ZodTypeAny, {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        }, {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        }>, z.ZodArray<z.ZodObject<{
+    receive: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        content_raw: z.ZodOptional<z.ZodAny>;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }, {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }>, "many">, z.ZodObject<{
+        balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        token_type: z.ZodEffects<z.ZodString, string, string>;
+        received: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
-            type: z.ZodString;
-            content_raw: z.ZodOptional<z.ZodAny>;
+            balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            payment: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            type: string;
             id: string;
-            content_raw?: any;
+            balance: string | number;
+            payment: string;
         }, {
-            type: string;
             id: string;
-            content_raw?: any;
-        }>, "many">]>;
-    }, "strict", z.ZodTypeAny, {
-        result: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
             balance: string | number;
-            token_type: string;
-        } | {
-            type: string;
+            payment: string;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        received: {
             id: string;
-            content_raw?: any;
+            balance: string | number;
+            payment: string;
         }[];
+        balance: string | number;
+        token_type: string;
     }, {
-        result: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | {
-            type: string;
+        received: {
             id: string;
-            content_raw?: any;
+            balance: string | number;
+            payment: string;
         }[];
-    }>>;
+        balance: string | number;
+        token_type: string;
+    }>, z.ZodLiteral<"recently">]>>;
     transfer_to: z.ZodOptional<z.ZodObject<{
         name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         local_mark_first: z.ZodOptional<z.ZodBoolean>;
@@ -217,20 +194,18 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
         message?: string | undefined;
     } | undefined;
     receive?: {
-        result: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | {
-            type: string;
+        received: {
             id: string;
-            content_raw?: any;
+            balance: string | number;
+            payment: string;
         }[];
-    } | undefined;
+        balance: string | number;
+        token_type: string;
+    } | "recently" | {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }[] | undefined;
     agent?: {
         entities: {
             name_or_address?: string | undefined;
@@ -258,29 +233,20 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
     } | undefined;
 }, {
     object: string;
-    progress?: {
-        op: "next" | "hold" | "unhold" | "adminUnhold";
-        operation: {
-            forward: string;
-            next_node_name: string;
-        };
-        message?: string | undefined;
-    } | undefined;
+    progress?: unknown;
     receive?: {
-        result: {
-            received: {
-                id: string;
-                balance: string | number;
-                payment: string;
-            }[];
-            balance: string | number;
-            token_type: string;
-        } | {
-            type: string;
+        received: {
             id: string;
-            content_raw?: any;
+            balance: string | number;
+            payment: string;
         }[];
-    } | undefined;
+        balance: string | number;
+        token_type: string;
+    } | "recently" | {
+        type: string;
+        id: string;
+        content_raw?: any;
+    }[] | undefined;
     agent?: {
         entities: {
             name_or_address?: string | undefined;
@@ -336,7 +302,7 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
             check_all_founded?: boolean | undefined;
         }>>;
         required_info: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodString, string, string>, z.ZodNull]>>;
-        progress: z.ZodOptional<z.ZodObject<{
+        progress: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             operation: z.ZodObject<{
                 next_node_name: z.ZodEffects<z.ZodString, string, string>;
                 forward: z.ZodEffects<z.ZodString, string, string>;
@@ -363,7 +329,14 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
                 next_node_name: string;
             };
             message?: string | undefined;
-        }>>;
+        }>, {
+            op: "next" | "hold" | "unhold" | "adminUnhold";
+            operation: {
+                forward: string;
+                next_node_name: string;
+            };
+            message?: string | undefined;
+        }, unknown>>;
         arb_confirm: z.ZodOptional<z.ZodObject<{
             arb: z.ZodEffects<z.ZodString, string, string>;
             confirm: z.ZodBoolean;
@@ -397,81 +370,51 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
         }, {
             arb: string;
         }>>;
-        receive: z.ZodOptional<z.ZodObject<{
-            result: z.ZodUnion<[z.ZodObject<{
-                balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                token_type: z.ZodEffects<z.ZodString, string, string>;
-                received: z.ZodArray<z.ZodObject<{
-                    id: z.ZodString;
-                    balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
-                    payment: z.ZodString;
-                }, "strict", z.ZodTypeAny, {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }, {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }>, "many">;
-            }, "strict", z.ZodTypeAny, {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            }, {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            }>, z.ZodArray<z.ZodObject<{
+        receive: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            content_raw: z.ZodOptional<z.ZodAny>;
+        }, "strict", z.ZodTypeAny, {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }, {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }>, "many">, z.ZodObject<{
+            balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+            token_type: z.ZodEffects<z.ZodString, string, string>;
+            received: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
-                type: z.ZodString;
-                content_raw: z.ZodOptional<z.ZodAny>;
+                balance: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+                payment: z.ZodString;
             }, "strict", z.ZodTypeAny, {
-                type: string;
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }, {
-                type: string;
                 id: string;
-                content_raw?: any;
-            }>, "many">]>;
-        }, "strict", z.ZodTypeAny, {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
                 balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+                payment: string;
+            }>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
+            balance: string | number;
+            token_type: string;
         }, {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
-        }>>;
+            balance: string | number;
+            token_type: string;
+        }>, z.ZodLiteral<"recently">]>>;
         transfer_to: z.ZodOptional<z.ZodObject<{
             name_or_address: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
             local_mark_first: z.ZodOptional<z.ZodBoolean>;
@@ -493,20 +436,18 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
             message?: string | undefined;
         } | undefined;
         receive?: {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
-        } | undefined;
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         agent?: {
             entities: {
                 name_or_address?: string | undefined;
@@ -534,29 +475,20 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
         } | undefined;
     }, {
         object: string;
-        progress?: {
-            op: "next" | "hold" | "unhold" | "adminUnhold";
-            operation: {
-                forward: string;
-                next_node_name: string;
-            };
-            message?: string | undefined;
-        } | undefined;
+        progress?: unknown;
         receive?: {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
-        } | undefined;
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         agent?: {
             entities: {
                 name_or_address?: string | undefined;
@@ -812,20 +744,18 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
             message?: string | undefined;
         } | undefined;
         receive?: {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
-        } | undefined;
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         agent?: {
             entities: {
                 name_or_address?: string | undefined;
@@ -895,29 +825,20 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
 }, {
     data: {
         object: string;
-        progress?: {
-            op: "next" | "hold" | "unhold" | "adminUnhold";
-            operation: {
-                forward: string;
-                next_node_name: string;
-            };
-            message?: string | undefined;
-        } | undefined;
+        progress?: unknown;
         receive?: {
-            result: {
-                received: {
-                    id: string;
-                    balance: string | number;
-                    payment: string;
-                }[];
-                balance: string | number;
-                token_type: string;
-            } | {
-                type: string;
+            received: {
                 id: string;
-                content_raw?: any;
+                balance: string | number;
+                payment: string;
             }[];
-        } | undefined;
+            balance: string | number;
+            token_type: string;
+        } | "recently" | {
+            type: string;
+            id: string;
+            content_raw?: any;
+        }[] | undefined;
         agent?: {
             entities: {
                 name_or_address?: string | undefined;

package/dist/schema/call/order.js

@@ -1,8 +1,7 @@
 import { z } from "zod";
 import { CallEnvSchema, SubmissionCallSchema } from "./base.js";
 import { OperateSchema } from "./progress.js";
-import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, ManyAccountOrMark_AddressSchema, NameOrAddressSchema } from "../common/index.js";
-import { QueryReceivedResultSchema } from "../common/index.js";
+import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, ManyAccountOrMark_AddressSchema, NameOrAddressSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from "../common/index.js";
 export const ArbConfirmSchema = z.object({
     arb: NameOrAddressSchema.describe("Arb object ID or name."),
     confirm: z.boolean().describe("Whether to confirm that the submitted arbitration materials are valid for arbitration."),
@@ -24,7 +23,9 @@ export const CallOrder_DataSchema = z.object({
     arb_confirm: ArbConfirmSchema.optional().describe("Submit compensation request and apply for arbitration"),
     arb_objection: ArbObjectionSchema.optional().describe("Oppose and appeal the arbitration result, request re-arbitration."),
     arb_claim_compensation: ArbClaimCompensationSchema.optional().describe("Specify the adjudicated Arb object to obtain order compensation."),
-    receive: QueryReceivedResultSchema.optional().describe("Unwrap CoinWrapper objects or other objects received by the order and transfer them to the order owner"),
+    receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects or other objects received by the order and transfer them to the order owner. " +
+        "Consistent with `owner_receive` on other objects (arbitration/contact/demand/machine/permission/repository/reward/service/treasury)." +
+        RECEIVE_FORMAT_BLOCK_OBJECTS),
     transfer_to: AccountOrMark_AddressSchema.optional().describe("Set new owner of the order. Requires order owner permission to set."),
 }).strict().describe("On-chain, operate on an Order object.");
 export const CallOrder_InputSchema = z.object({