@wowok/agent-mcp 2.4.1 → 2.4.3

package/dist/schema/query/index.js

@@ -3,7 +3,7 @@ import { TokenTypeInfoSchema, QueryLocalMarkListResultSchema, QueryAccountListRe
 import { AccountOrMark_AddressSchema, BalanceTypeSchema, CacheExpireTypeSchema, EntrypointSchema, GuardIdentifierSchema, GuardTableItemSchema, NameOrAddressSchema, ObjectBaseSchema, ObjectTypeSchema, QueryIdSchema, SupportedValueSchema, ValueTypeSchema, QueryReceivedResultSchema, LongNameSchema, DescriptionSchema } from "../common/index.js";
 import { SemanticSummarySchema } from "../call/index.js";
 import { isValidPermissionIndex } from '../utils/permission-index-utils.js';
-import { isValidGuardQueryId, isValidGuardQueryIdOrName } from '../utils/guard-query-utils.js';
+import { isValidGuardQueryId, isValidGuardQueryIdOrName, isValidWitnessType } from '../utils/guard-query-utils.js';
 import { ENTITY_LINKER_ADDRESS, ENTITY_REGISTRAR_ADDRESS, isWitnessType, } from "@wowok/wowok";
 import { DiscountType as WDiscountType } from "@wowok/wowok";
 import { QueryEnvSchema } from "../common/index.js";
@@ -144,7 +144,7 @@ export const ProgressSessionSchema = z.object({
     next_node: z.string().describe("Next node ID"),
     forwards: z.array(ProgressSessionHolderSchema).describe("Operation list in Progress session"),
     weights: tolerantNumber.describe("Total operation weight"),
-    threshold: tolerantNumber.describe("Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."),
+    threshold: tolerantNumber.default(0).describe("Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."),
 }).describe("Progress session");
 export const ObjectProgressSchema = ObjectBaseSchema.extend({
     machine: z.string().describe("Machine ID that Progress object belongs to"),
@@ -196,7 +196,7 @@ export const AllocatorSchema = z.object({
 }).describe("Fund allocator");
 export const AllocatorsSchema = z.object({
     description: DescriptionSchema.describe("Description of fund allocator list"),
-    threshold: BalanceTypeSchema.describe("Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."),
+    threshold: BalanceTypeSchema.default(0).describe("Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."),
     allocators: z.array(AllocatorSchema).describe("Fund allocator list. Each fund allocator represents a fund allocation strategy."),
 }).describe("Fund allocator list");
 export const ObjectServiceSchema = ObjectBaseSchema.extend({
@@ -402,11 +402,17 @@ export const ObjectPermissionSchema = ObjectBaseSchema.extend({
     })).describe("Permission item remark list"),
     um: z.union([z.string(), z.null()]).describe("Contact object"),
 }).describe("Permission object");
-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 WitnessTypeSchema = z.union([
+    z.number()
+        .int()
+        .refine(isWitnessType, {
+        message: 'Invalid WitnessType numeric value. Valid range: 100-108.',
+    }),
+    z.string()
+        .refine((name) => isValidWitnessType(name), {
+        message: 'Invalid WitnessType string name. Valid names: OrderProgress (100), OrderMachine (101), OrderService (102), ProgressMachine (103), ArbOrder (104), ArbArbitration (105), ArbProgress (106), ArbMachine (107), ArbService (108). Case-insensitive; "Type" prefix is optional.',
+    })
+]).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. Can be a numeric ID (100-108) or a string name (case-insensitive, with or without the 'Type' prefix). String format is recommended for readability.\n\nAvailable WitnessTypes:\n- OrderProgress / 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- OrderMachine / TypeOrderMachine (101): Query an Order's associated Machine (workflow definition). Use case: Verify the workflow structure or check node configurations.\n- OrderService / TypeOrderService (102): Query an Order's parent Service object. Use case: Validate the service offering details or check service-level configurations.\n- ProgressMachine / TypeProgressMachine (103): Query a Progress's associated Machine. Use case: Access workflow definition from a Progress context.\n- ArbOrder / TypeArbOrder (104): Query an Arb's associated Order. Use case: In arbitration voting guards, verify order details like payment amount or service ID.\n- ArbArbitration / TypeArbArbitration (105): Query an Arb's parent Arbitration service. Use case: Access arbitration configuration or fee settings from within an Arb case.\n- ArbProgress / TypeArbProgress (106): Query an Arb's associated Progress. Use case: Check order workflow state during arbitration validation.\n- ArbMachine / TypeArbMachine (107): Query an Arb's associated Machine. Use case: Access workflow definition for dispute context analysis.\n- ArbService / 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='OrderProgress' 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({
@@ -848,7 +854,7 @@ export const MachineForwardSchema = z.object({
 }).strict().describe("Forward in Machine object");
 export const MachineNodePairSchema = z.object({
     prev_node: z.string().describe("Previous node name"),
-    threshold: tolerantNumber.describe("Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."),
+    threshold: tolerantNumber.default(0).describe("Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."),
     forwards: z.array(MachineForwardSchema).describe("Forward list"),
 }).strict().describe("Node pair in Machine object");
 export const MachineNodeSchema = z.object({

package/dist/schema/utils/guard-query-utils.d.ts

@@ -1,3 +1,4 @@
+import { WitnessType } from "@wowok/wowok";
 export declare const isValidGuardQueryId: (id: number) => boolean;
 export declare const isValidGuardQueryName: (name: string) => boolean;
 export declare const isValidGuardQueryIdOrName: (input: number | string) => boolean;
@@ -9,3 +10,9 @@ export declare const BOOL_RETURNING_QUERIES: {
     name: string;
     description: string;
 }[];
+export declare const isValidWitnessType: (input: number | string) => boolean;
+export declare const WITNESS_TYPE_ENTRIES: {
+    id: WitnessType;
+    name: string;
+    fullName: string;
+}[];

package/dist/schema/utils/guard-query-utils.js

@@ -1,4 +1,4 @@
-import { GUARDQUERY, ValueType } from "@wowok/wowok";
+import { GUARDQUERY, ValueType, WitnessType, isValidWitnessTypeInput, witnessTypeToString } from "@wowok/wowok";
 const validGuardQueryIds = new Set(GUARDQUERY.map(item => item.id));
 const validGuardQueryNames = new Set(GUARDQUERY.map(item => item.name.toLowerCase()));
 const boolReturningQueryIds = new Set(GUARDQUERY.filter(item => item.return === ValueType.Bool).map(item => item.id));
@@ -31,3 +31,16 @@ export const isBoolReturningQuery = (input) => {
 export const BOOL_RETURNING_QUERIES = GUARDQUERY
     .filter(item => item.return === ValueType.Bool)
     .map(item => ({ id: item.id, name: item.name, description: item.description }));
+export const isValidWitnessType = (input) => {
+    return isValidWitnessTypeInput(input);
+};
+export const WITNESS_TYPE_ENTRIES = Object.keys(WitnessType)
+    .filter(k => isNaN(Number(k)))
+    .map(k => {
+    const enumValue = WitnessType[k];
+    return {
+        id: enumValue,
+        name: witnessTypeToString(enumValue),
+        fullName: k,
+    };
+});

package/dist/schemas/bridge_operation.output.json

@@ -655,7 +655,7 @@
                       },
                       "name": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                        "description": "Query instruction name. Example: 'progress.current'"
                       },
                       "objectType": {
                         "type": "string",

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-07-17T00:22:14.123Z",
+  "generatedAt": "2026-07-18T11:29:05.935Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/messenger_operation.output.json

@@ -1690,7 +1690,7 @@
                       },
                       "name": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                        "description": "Query instruction name. Example: 'progress.current'"
                       },
                       "objectType": {
                         "type": "string",

package/dist/schemas/onchain_events.output.json

@@ -1081,7 +1081,7 @@
                       },
                       "name": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                        "description": "Query instruction name. Example: 'progress.current'"
                       },
                       "objectType": {
                         "type": "string",

package/dist/schemas/onchain_operations.output.json

@@ -2475,7 +2475,7 @@
                       },
                       "name": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                        "description": "Query instruction name. Example: 'progress.current'"
                       },
                       "objectType": {
                         "type": "string",
@@ -2812,7 +2812,7 @@
         "result"
       ],
       "additionalProperties": false,
-      "description": "Unified MCP tool output. result.type discriminates 5 outcomes: 'transaction' (raw Sui response), 'submission' (needs Guard data), 'error' (failed with error_code), 'data' (query result), 'null' (no-op). When semantic is present, prefer it over raw result parsing. When harness_report is present, check verify.status first and follow recovery.strategy if status is 'fail'."
+      "description": "Unified MCP tool output. result.type discriminates 5 outcomes: 'transaction' (raw Wow response), 'submission' (needs Guard data), 'error' (failed with error_code), 'data' (query result), 'null' (no-op). When semantic is present, prefer it over raw result parsing. When harness_report is present, check verify.status first and follow recovery.strategy if status is 'fail'."
     }
   }
 }

package/dist/schemas/onchain_operations.schema.json

@@ -1676,10 +1676,8 @@
                   "description": "Description of fund allocator list"
                 },
                 "threshold": {
-                  "type": [
-                    "number",
-                    "string"
-                  ],
+                  "$ref": "#/definitions/data_service/properties/order_new/properties/buy/properties/total_pay/anyOf/0/properties/balance",
+                  "default": 0,
                   "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."
                 },
                 "allocators": {
@@ -1799,7 +1797,6 @@
               },
               "required": [
                 "description",
-                "threshold",
                 "allocators"
               ],
               "additionalProperties": false,
@@ -2226,6 +2223,7 @@
                                     "number",
                                     "string"
                                   ],
+                                  "default": 0,
                                   "description": "Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."
                                 },
                                 "forwards": {
@@ -2289,10 +2287,7 @@
                                                   {
                                                     "type": "array",
                                                     "items": {
-                                                      "type": [
-                                                        "number",
-                                                        "string"
-                                                      ]
+                                                      "$ref": "#/definitions/data_machine/properties/node/anyOf/0/anyOf/0/properties/nodes/items/properties/pairs/items/properties/threshold"
                                                     }
                                                   },
                                                   {
@@ -2327,7 +2322,6 @@
                               },
                               "required": [
                                 "prev_node",
-                                "threshold",
                                 "forwards"
                               ],
                               "additionalProperties": false,
@@ -5804,7 +5798,8 @@
                     "number",
                     "string"
                   ],
-                  "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."
+                  "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold.",
+                  "default": 0
                 },
                 "allocators": {
                   "type": "array",
@@ -5908,16 +5903,13 @@
                         "description": "Fund allocation item list. Each item represents a recipient and their corresponding reward allocation value."
                       },
                       "fix": {
-                        "type": [
-                          "number",
-                          "string"
-                        ],
+                        "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/threshold",
                         "description": "Fixed allocation amount. If specified, all recipients will receive the fixed allocation amount."
                       },
                       "max": {
                         "anyOf": [
                           {
-                            "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                            "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/threshold"
                           },
                           {
                             "type": "null"
@@ -5938,7 +5930,6 @@
               },
               "required": [
                 "description",
-                "threshold",
                 "allocators"
               ],
               "additionalProperties": false,
@@ -5950,7 +5941,7 @@
                   "type": "object",
                   "properties": {
                     "balance": {
-                      "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                      "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/threshold"
                     }
                   },
                   "required": [
@@ -6034,7 +6025,7 @@
                   "type": "object",
                   "properties": {
                     "balance": {
-                      "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                      "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/threshold"
                     },
                     "token_type": {
                       "type": "string",
@@ -6050,7 +6041,7 @@
                             "description": "Received CoinWrapper object ID"
                           },
                           "balance": {
-                            "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                            "$ref": "#/definitions/data_allocation/anyOf/0/properties/allocators/properties/threshold"
                           },
                           "payment": {
                             "type": "string",

package/dist/schemas/onchain_operations_allocation.schema.json

@@ -74,7 +74,8 @@
                     "number",
                     "string"
                   ],
-                  "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."
+                  "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold.",
+                  "default": 0
                 },
                 "allocators": {
                   "type": "array",
@@ -178,16 +179,13 @@
                         "description": "Fund allocation item list. Each item represents a recipient and their corresponding reward allocation value."
                       },
                       "fix": {
-                        "type": [
-                          "number",
-                          "string"
-                        ],
+                        "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/threshold",
                         "description": "Fixed allocation amount. If specified, all recipients will receive the fixed allocation amount."
                       },
                       "max": {
                         "anyOf": [
                           {
-                            "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                            "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/threshold"
                           },
                           {
                             "type": "null"
@@ -208,7 +206,6 @@
               },
               "required": [
                 "description",
-                "threshold",
                 "allocators"
               ],
               "additionalProperties": false,
@@ -220,7 +217,7 @@
                   "type": "object",
                   "properties": {
                     "balance": {
-                      "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                      "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/threshold"
                     }
                   },
                   "required": [
@@ -304,7 +301,7 @@
                   "type": "object",
                   "properties": {
                     "balance": {
-                      "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                      "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/threshold"
                     },
                     "token_type": {
                       "type": "string",
@@ -320,7 +317,7 @@
                             "description": "Received CoinWrapper object ID"
                           },
                           "balance": {
-                            "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/allocators/items/properties/fix"
+                            "$ref": "#/definitions/data/anyOf/0/properties/allocators/properties/threshold"
                           },
                           "payment": {
                             "type": "string",

package/dist/schemas/onchain_operations_machine.schema.json

@@ -295,6 +295,7 @@
                                     "number",
                                     "string"
                                   ],
+                                  "default": 0,
                                   "description": "Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."
                                 },
                                 "forwards": {
@@ -358,10 +359,7 @@
                                                   {
                                                     "type": "array",
                                                     "items": {
-                                                      "type": [
-                                                        "number",
-                                                        "string"
-                                                      ]
+                                                      "$ref": "#/definitions/data/properties/node/anyOf/0/anyOf/0/properties/nodes/items/properties/pairs/items/properties/threshold"
                                                     }
                                                   },
                                                   {
@@ -396,7 +394,6 @@
                               },
                               "required": [
                                 "prev_node",
-                                "threshold",
                                 "forwards"
                               ],
                               "additionalProperties": false,

package/dist/schemas/onchain_operations_service.schema.json

@@ -586,10 +586,8 @@
                   "description": "Description of fund allocator list"
                 },
                 "threshold": {
-                  "type": [
-                    "number",
-                    "string"
-                  ],
+                  "$ref": "#/definitions/data/properties/order_new/properties/buy/properties/total_pay/anyOf/0/properties/balance",
+                  "default": 0,
                   "description": "Threshold. If defined, fund allocation will be triggered when amount in Allocation object reaches this threshold."
                 },
                 "allocators": {
@@ -709,7 +707,6 @@
               },
               "required": [
                 "description",
-                "threshold",
                 "allocators"
               ],
               "additionalProperties": false,

package/dist/schemas/onchain_table_data.output.json

@@ -1589,6 +1589,7 @@
                                   "number",
                                   "string"
                                 ],
+                                "default": 0,
                                 "description": "Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."
                               },
                               "forwards": {
@@ -1652,10 +1653,7 @@
                                                 {
                                                   "type": "array",
                                                   "items": {
-                                                    "type": [
-                                                      "number",
-                                                      "string"
-                                                    ]
+                                                    "$ref": "#/definitions/onchain_table_data/properties/result/anyOf/8/properties/result/anyOf/0/properties/value/items/properties/threshold"
                                                   }
                                                 },
                                                 {
@@ -1690,7 +1688,6 @@
                             },
                             "required": [
                               "prev_node",
-                              "threshold",
                               "forwards"
                             ],
                             "additionalProperties": false,
@@ -1881,18 +1878,15 @@
                                 "description": "Total operation weight"
                               },
                               "threshold": {
-                                "type": [
-                                  "number",
-                                  "string"
-                                ],
+                                "$ref": "#/definitions/onchain_table_data/properties/result/anyOf/8/properties/result/anyOf/0/properties/value/items/properties/threshold",
+                                "default": 0,
                                 "description": "Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."
                               }
                             },
                             "required": [
                               "next_node",
                               "forwards",
-                              "weights",
-                              "threshold"
+                              "weights"
                             ],
                             "additionalProperties": false,
                             "description": "Progress session"
@@ -2657,7 +2651,7 @@
                       },
                       "name": {
                         "type": "string",
-                        "description": "Query instruction name. Example: 'progress.current_node_name'"
+                        "description": "Query instruction name. Example: 'progress.current'"
                       },
                       "objectType": {
                         "type": "string",

package/dist/tools/handlers/bridge.d.ts

@@ -0,0 +1 @@
+export { handleBridgeOperations } from "../../schema/call/bridge-handler.js";

package/dist/tools/handlers/bridge.js

@@ -0,0 +1 @@
+export { handleBridgeOperations } from "../../schema/call/bridge-handler.js";

package/dist/tools/handlers/config.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDispatchResult } from "../types.js";
+export declare function handleConfigOperation(args: any): Promise<ToolDispatchResult>;

package/dist/tools/handlers/config.js

@@ -0,0 +1,71 @@
+import { listServices, getServiceInfo, toggle as toggleService, setEnabled as setServiceEnabled, reset as resetService, } from "../../config/index.js";
+export async function handleConfigOperation(args) {
+    const action = args.action;
+    let result;
+    switch (action) {
+        case "list":
+            result = { services: listServices() };
+            break;
+        case "toggle": {
+            const service = args.service;
+            if (!service)
+                throw new Error("'service' param is required for toggle");
+            const existing = getServiceInfo(service);
+            if (!existing) {
+                throw new Error(`Unknown service: ${service}. Use action='list' to see all valid services.`);
+            }
+            const newState = toggleService(service);
+            result = { service, enabled: newState, reminder: existing.reminder };
+            break;
+        }
+        case "enable": {
+            const service = args.service;
+            if (!service)
+                throw new Error("'service' param is required for enable");
+            const existing = getServiceInfo(service);
+            if (!existing)
+                throw new Error(`Unknown service: ${service}. Use action='list' to see all valid services.`);
+            setServiceEnabled(service, true);
+            result = { service, enabled: true, reminder: existing.reminder };
+            break;
+        }
+        case "disable": {
+            const service = args.service;
+            if (!service)
+                throw new Error("'service' param is required for disable");
+            const existing = getServiceInfo(service);
+            if (!existing)
+                throw new Error(`Unknown service: ${service}. Use action='list' to see all valid services.`);
+            setServiceEnabled(service, false);
+            result = { service, enabled: false, reminder: existing.reminder };
+            break;
+        }
+        case "reset": {
+            const service = args.service;
+            if (!service)
+                throw new Error("'service' param is required for reset");
+            const existing = getServiceInfo(service);
+            if (!existing)
+                throw new Error(`Unknown service: ${service}. Use action='list' to see all valid services.`);
+            resetService(service);
+            result = { service, enabled: getServiceInfo(service)?.enabled, reminder: existing.reminder, reset: true };
+            break;
+        }
+        case "info": {
+            const service = args.service;
+            if (!service)
+                throw new Error("'service' param is required for info");
+            const info = getServiceInfo(service);
+            if (!info)
+                throw new Error(`Unknown service: ${service}. Use action='list' to see all valid services.`);
+            result = info;
+            break;
+        }
+        default:
+            throw new Error(`Unknown config_operation action: ${action}`);
+    }
+    return {
+        content: [{ type: "text", text: JSON.stringify({ result }) }],
+        structuredContent: { result },
+    };
+}

package/dist/tools/handlers/file-export.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDispatchResult } from "../types.js";
+export declare function handleGuard2File(args: any): Promise<ToolDispatchResult>;
+export declare function handleMachineNode2File(args: any): Promise<ToolDispatchResult>;

package/dist/tools/handlers/file-export.js

@@ -0,0 +1,90 @@
+import { resolve } from "path";
+import { strictParse, getEnvConfig, Guard2File_InputSchema, MachineNode2File_InputSchema, } from "../../schema/index.js";
+import { guard2file, machineNode2file, } from "@wowok/wowok";
+export async function handleGuard2File(args) {
+    const validated = strictParse(Guard2File_InputSchema, args, "guard2file input");
+    const env = getEnvConfig(validated.env);
+    try {
+        await guard2file(validated.guard, validated.file_path, validated.format || "json", env.network);
+        const result = {
+            result: {
+                status: "success",
+                data: {
+                    file_path: resolve(validated.file_path),
+                    format: validated.format || "json",
+                    guard_object: validated.guard,
+                },
+            },
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: result,
+        };
+    }
+    catch (error) {
+        const result = {
+            result: {
+                status: "error",
+                error: error.message,
+            },
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: result,
+        };
+    }
+}
+export async function handleMachineNode2File(args) {
+    const validated = strictParse(MachineNode2File_InputSchema, args, "machineNode2file input");
+    const env = getEnvConfig(validated.env);
+    try {
+        await machineNode2file(validated.machine, validated.file_path, validated.format || "json", env.network);
+        let node_count = undefined;
+        try {
+            const filePath = resolve(validated.file_path);
+            const fileContent = await import('fs/promises').then(fs => fs.readFile(filePath, 'utf-8'));
+            if ((validated.format || "json") === "json") {
+                const parsed = JSON.parse(fileContent);
+                if (Array.isArray(parsed)) {
+                    node_count = parsed.length;
+                }
+            }
+            else {
+                const nodeMatches = fileContent.match(/^##\s+Node:/gm);
+                node_count = nodeMatches ? nodeMatches.length : 0;
+            }
+        }
+        catch {
+            node_count = undefined;
+        }
+        const result = {
+            result: {
+                status: "success",
+                data: {
+                    file_path: resolve(validated.file_path),
+                    format: validated.format || "json",
+                    machine_object: validated.machine,
+                },
+            },
+        };
+        if (node_count !== undefined) {
+            result.result.data.node_count = node_count;
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: result,
+        };
+    }
+    catch (error) {
+        const result = {
+            result: {
+                status: "error",
+                error: error.message,
+            },
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result) }],
+            structuredContent: result,
+        };
+    }
+}