@wowok/agent-mcp 2.6.1 → 2.6.4

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(),
@@ -124,7 +170,7 @@ export const CallMachine_InputSchema = z.object({
 export const MachineNode2File_InputSchema = z.object({
     machine: NameOrAddressSchema.describe("Machine object ID or name to export"),
     file_path: z.string().describe("Output file path (absolute or relative)"),
-    format: z.enum(["json", "markdown"]).optional().describe("Output format: 'json' (default) or 'markdown'"),
+    format: z.enum(["json", "markdown"]).optional().default("json").describe("Output format: 'json' (default) or 'markdown'"),
     env: CallEnvSchema.optional(),
 }).strict().describe("Query a Machine object from the blockchain and export its node definition to a JSON or Markdown file. The exported file can be edited and used to create new Machine objects.");
 export const MachineNode2File_OutputSchema = z.discriminatedUnion("status", [

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

@@ -71,7 +71,7 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
             forward: string;
             next_node_name: string;
         }>;
-        op: z.ZodEnum<["next", "hold", "unhold", "adminUnhold"]>;
+        op: z.ZodDefault<z.ZodEnum<["next", "hold", "unhold", "adminUnhold"]>>;
         message: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         op: "next" | "hold" | "unhold" | "adminUnhold";
@@ -81,12 +81,12 @@ export declare const CallOrder_DataSchema: z.ZodObject<{
         };
         message?: string | undefined;
     }, {
-        op: "next" | "hold" | "unhold" | "adminUnhold";
         operation: {
             forward: string;
             next_node_name: string;
         };
         message?: string | undefined;
+        op?: "next" | "hold" | "unhold" | "adminUnhold" | undefined;
     }>, {
         op: "next" | "hold" | "unhold" | "adminUnhold";
         operation: {
@@ -313,7 +313,7 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
                 forward: string;
                 next_node_name: string;
             }>;
-            op: z.ZodEnum<["next", "hold", "unhold", "adminUnhold"]>;
+            op: z.ZodDefault<z.ZodEnum<["next", "hold", "unhold", "adminUnhold"]>>;
             message: z.ZodOptional<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
             op: "next" | "hold" | "unhold" | "adminUnhold";
@@ -323,12 +323,12 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
             };
             message?: string | undefined;
         }, {
-            op: "next" | "hold" | "unhold" | "adminUnhold";
             operation: {
                 forward: string;
                 next_node_name: string;
             };
             message?: string | undefined;
+            op?: "next" | "hold" | "unhold" | "adminUnhold" | undefined;
         }>, {
             op: "next" | "hold" | "unhold" | "adminUnhold";
             operation: {
@@ -525,10 +525,11 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
         user_intent_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         project: z.ZodOptional<z.ZodString>;
         client_schema_version: z.ZodOptional<z.ZodString>;
-        schema_strict_mode: z.ZodOptional<z.ZodBoolean>;
+        schema_strict_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         dry_run: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -537,7 +538,6 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
@@ -811,6 +811,7 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
     } | undefined;
     env?: {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -819,7 +820,6 @@ export declare const CallOrder_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     } | undefined;
 }, {

package/dist/schema/call/order.js

@@ -1,7 +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, ReceivedObjectsOrRecentlySchema } 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,11 +24,8 @@ export const CallOrder_DataSchema = z.object({
     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: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects or other objects received by the order and transfer them to the order owner. " +
-        "ACCEPTED FORMATS (consistent with `owner_receive` on other objects — see arbitration/contact/demand/machine/permission/repository/reward/service/treasury):\n" +
-        "• 'recently' (string) — auto-query and receive all recently received objects\n" +
-        "• ReceivedNormal[] (array) — explicit list of received objects: [{id, type, content_raw?}]\n" +
-        "• ReceivedBalance ({token_type, balance, received: [{id, balance, payment}]}) — received balance record\n" +
-        "DO NOT wrap in {result: ...} — pass directly (NOT {result: [...]})"),
+        "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({

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

@@ -491,10 +491,11 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
         user_intent_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         project: z.ZodOptional<z.ZodString>;
         client_schema_version: z.ZodOptional<z.ZodString>;
-        schema_strict_mode: z.ZodOptional<z.ZodBoolean>;
+        schema_strict_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         dry_run: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -503,7 +504,6 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
@@ -551,6 +551,7 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
     };
     env?: {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -559,7 +560,6 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     } | undefined;
 }, {

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

@@ -2468,10 +2468,11 @@ export declare const CallPermission_InputSchema: z.ZodObject<{
         user_intent_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         project: z.ZodOptional<z.ZodString>;
         client_schema_version: z.ZodOptional<z.ZodString>;
-        schema_strict_mode: z.ZodOptional<z.ZodBoolean>;
+        schema_strict_mode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         dry_run: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -2480,7 +2481,6 @@ export declare const CallPermission_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     }, {
         no_cache?: boolean | undefined;
@@ -2842,6 +2842,7 @@ export declare const CallPermission_InputSchema: z.ZodObject<{
     } | undefined;
     env?: {
         account: string;
+        schema_strict_mode: boolean;
         no_cache?: boolean | undefined;
         network?: import("@wowok/wowok").ENTRYPOINT | undefined;
         permission_guard?: string[] | undefined;
@@ -2850,7 +2851,6 @@ export declare const CallPermission_InputSchema: z.ZodObject<{
         user_intent_phrases?: string[] | undefined;
         project?: string | undefined;
         client_schema_version?: string | undefined;
-        schema_strict_mode?: boolean | undefined;
         dry_run?: boolean | undefined;
     } | undefined;
 }, {

package/dist/schema/call/permission.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { PermissionIndexTypeSchema } from "../query/index.js";
 import { CallEnvSchema, SubmissionCallSchema, NormalObjectSchema } from "./base.js";
-import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, ManyAccountOrMark_AddressSchema, NameOrAddressSchema, ReceivedObjectsOrRecentlySchema } from "../common/index.js";
+import { AccountOrMark_AddressSchema, DescriptionSchema, LongNameSchema, ManyAccountOrMark_AddressSchema, NameOrAddressSchema, ReceivedObjectsOrRecentlySchema, RECEIVE_FORMAT_BLOCK_OBJECTS } from "../common/index.js";
 export const RemarkSetSchema = z.object({
     op: z.literal("set"),
     index: PermissionIndexTypeSchema,
@@ -95,7 +95,7 @@ export const CallPermission_DataSchema = z.object({
     admin: AdminSchema.optional().describe("Manage Permission object admins: add new admins, remove existing admins, or set the complete admin list. Only the Permission object owner (builder) can perform this operation. The creator automatically becomes an admin with full permissions."),
     apply: z.array(NameOrAddressSchema).optional().describe("Array of object IDs or names to operate on, apply the Permission object to these objects' permission control. Note: The signer must be the owner of the existing Permission objects for these objects"),
     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).'),
+    owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe('Unwrap CoinWrapper objects and other objects received by this Permission object and send them to the builder(owner).' + RECEIVE_FORMAT_BLOCK_OBJECTS),
     um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name."),
 }).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.");
 export const CallPermission_InputSchema = z.object({