@wowok/agent-mcp 2.6.3 → 2.6.6

package/dist/schema/query/index.js

@@ -121,8 +121,11 @@ export const ServiceSaleSchema = z.object({
     wip: z.string().describe("WIP file URL. EMPTY string \"\" skips verification (TESTING ONLY). " +
         "Production MUST use a real HTTP URL pointing to a .wip file generated by the wip_file tool. " +
         "Example: \"https://cdn.example.com/products/phone_v1.wip\""),
-    wip_hash: z.string().describe("WIP file hash (hex string). EMPTY string \"\" skips hash comparison (TESTING ONLY). " +
-        "Production: fill with the hash you saw when viewing the product, to prevent merchant replacing the WIP file before order."),
+    wip_hash: z.string().describe("SHA-256 hash (hex string) of the sale's WIP file, committed on-chain by the merchant. " +
+        "BUY RULE: if this is NON-EMPTY, the buyer MUST pass this exact value as wip_hash when creating an order " +
+        "(ServiceBuyItem.wip_hash) — NEVER use \"\". Pinning the on-chain hash prevents the merchant from replacing " +
+        "the WIP file (a legitimate update) between the buyer's view and order placement, ensuring 'what you see is " +
+        "what you get'. EMPTY means no hash was committed (TESTING ONLY, no delivery-integrity guarantee)."),
 }).describe("Service sale");
 export const PurchasedItemSchema = z.object({
     name: LongNameSchema.describe("Name of the product or service"),
@@ -975,7 +978,12 @@ export const MachineForwardSchema = z.object({
         "that progress is not modified by this forward. " +
         "For target-node verification after transition, bind the Guard to the Allocator instead " +
         "(allocation.alloc runs AFTER the state transition completes)."),
-}).strict().describe("Forward in Machine object");
+}).strict().refine((f) => (f.namedOperator !== null && f.namedOperator !== undefined) ||
+    (f.permissionIndex !== null && f.permissionIndex !== undefined), {
+    message: "One of 'namedOperator' or 'permissionIndex' must be provided for each forward. " +
+        "Use namedOperator:'' (empty string) when the ORDER OWNER operates this forward; " +
+        "use a permissionIndex (e.g. 1000) when the same operator acts for all orders.",
+}).describe("Forward in Machine object");
 export const MachineNodePairSchema = z.object({
     prev_node: z.string().describe("Previous node name. Empty string '' means initial entry node (the first node in the workflow)."),
     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."),
@@ -1564,6 +1572,20 @@ export const OnchainQueryResultSchema_Part3 = z.union([
         query_type: z.literal("onchain_address_activity"),
         result: z.union([TransactionHistoryAnswerSchema, z.undefined()]),
     }).strict(),
+    z.object({
+        query_type: z.literal("token_value_convert"),
+        result: z.object({
+            token_type: z.string().describe("Full token type used for conversion"),
+            symbol: z.string().optional().describe("Resolved token symbol"),
+            decimals: z.number().optional().describe("Resolved decimals N — the precision reminder"),
+            precision_known: z.boolean().describe("false → precision unavailable; conversion may have been impossible"),
+            direction: z.union([z.literal("raw_to_unit"), z.literal("unit_to_raw")]),
+            input: z.string().describe("Input value as provided"),
+            output: z.string().describe("Converted value (empty string when conversion was impossible)"),
+            error: z.string().optional().describe("Hard failure reason (e.g. unit→raw without known precision)"),
+            text: z.string().describe("One-line human text with the decimals reminder"),
+        }).strict().describe("Bidirectional token value conversion result — see Fund Processing Layer"),
+    }).strict(),
 ]);
 export const AllQueryResultsSchema = z.union([
     LocalQueryResultSchema,

package/dist/schema/schema-query/index.d.ts

@@ -1,21 +1,27 @@
 import { z } from "zod";
 export declare const SchemaQueryInputSchema: z.ZodObject<{
-    action: z.ZodEnum<["list", "get", "get_output", "search", "list_operations", "get_guard_templates", "get_field", "search_examples"]>;
+    action: z.ZodEnum<["list", "get", "get_output", "search", "list_operations", "get_guard_templates", "get_field", "search_examples", "get_tool_reference", "get_guard_design_patterns", "get_safety_rules", "get_templates"]>;
     name: z.ZodOptional<z.ZodString>;
     query: z.ZodOptional<z.ZodString>;
     field_path: z.ZodOptional<z.ZodString>;
     template: z.ZodOptional<z.ZodString>;
+    object_type: z.ZodOptional<z.ZodEnum<["guard", "machine", "service", "order", "progress", "arbitration", "treasury", "permission", "passport", "allocation", "reward"]>>;
+    params: z.ZodOptional<z.ZodString>;
     output_file: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    action: "get" | "search" | "list" | "get_output" | "list_operations" | "get_guard_templates" | "get_field" | "search_examples";
+    action: "get" | "search" | "list" | "get_output" | "get_field" | "list_operations" | "get_guard_templates" | "search_examples" | "get_tool_reference" | "get_guard_design_patterns" | "get_safety_rules" | "get_templates";
+    params?: string | undefined;
     name?: string | undefined;
+    object_type?: "reward" | "permission" | "guard" | "allocation" | "service" | "machine" | "arbitration" | "treasury" | "order" | "progress" | "passport" | undefined;
     query?: string | undefined;
     field_path?: string | undefined;
     template?: string | undefined;
     output_file?: string | undefined;
 }, {
-    action: "get" | "search" | "list" | "get_output" | "list_operations" | "get_guard_templates" | "get_field" | "search_examples";
+    action: "get" | "search" | "list" | "get_output" | "get_field" | "list_operations" | "get_guard_templates" | "search_examples" | "get_tool_reference" | "get_guard_design_patterns" | "get_safety_rules" | "get_templates";
+    params?: string | undefined;
     name?: string | undefined;
+    object_type?: "reward" | "permission" | "guard" | "allocation" | "service" | "machine" | "arbitration" | "treasury" | "order" | "progress" | "passport" | undefined;
     query?: string | undefined;
     field_path?: string | undefined;
     template?: string | undefined;
@@ -52,9 +58,9 @@ export declare const SchemaQueryOutputSchema: z.ZodObject<{
         score: number;
         tags: string[];
         file: string;
+        verified: boolean;
         industry: string;
         operation_type: string;
-        verified: boolean;
         matched_fields: string[];
     }, {
         description: string;
@@ -62,9 +68,9 @@ export declare const SchemaQueryOutputSchema: z.ZodObject<{
         score: number;
         tags: string[];
         file: string;
+        verified: boolean;
         industry: string;
         operation_type: string;
-        verified: boolean;
         matched_fields: string[];
     }>, "many">, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodNull]>;
     message: z.ZodString;
@@ -82,9 +88,9 @@ export declare const SchemaQueryOutputSchema: z.ZodObject<{
         score: number;
         tags: string[];
         file: string;
+        verified: boolean;
         industry: string;
         operation_type: string;
-        verified: boolean;
         matched_fields: string[];
     }[] | null;
     success: boolean;
@@ -103,9 +109,9 @@ export declare const SchemaQueryOutputSchema: z.ZodObject<{
         score: number;
         tags: string[];
         file: string;
+        verified: boolean;
         industry: string;
         operation_type: string;
-        verified: boolean;
         matched_fields: string[];
     }[] | null;
     success: boolean;

package/dist/schema/schema-query/index.js

@@ -11,16 +11,20 @@ export const SchemaQueryInputSchema = z
         "get_guard_templates",
         "get_field",
         "search_examples",
+        "get_tool_reference",
+        "get_guard_design_patterns",
+        "get_safety_rules",
+        "get_templates",
     ])
-        .describe("Action to perform: 'list' (all schemas), 'get' (specific input schema), 'get_output' (tool output schema), 'get_field' (field-path query e.g. field_path='data.node'), 'search' (by keyword), 'list_operations' (on-chain operations), 'get_guard_templates' (Guard creation templates + best practices), 'search_examples' (search verified example files by keyword — matches title, description, tags, operation_type, industry)."),
+        .describe("Action to perform: 'list' (all schemas), 'get' (specific input schema), 'get_output' (tool output schema), 'get_field' (field-path query e.g. field_path='data.node'), 'search' (by keyword), 'list_operations' (on-chain operations), 'get_guard_templates' (Guard creation templates + best practices), 'search_examples' (search verified example files by keyword — matches title, description, tags, operation_type, industry), 'get_tool_reference' (MCP tool usage reference: summaries, actions, prerequisites, notes — sunk from wowok-tools skill), 'get_guard_design_patterns' (curated Guard design pattern catalog: business requirement → logic tree template — sunk from wowok-guard skill), 'get_safety_rules' (object reuse/immutability/operation-classification/naming rules — sunk from wowok-safety skill), 'get_templates' (unified template registry: ~90 parameterized templates across 11 object types — guard/machine/service/order/progress/arbitration/treasury/permission/passport/allocation/reward; omit 'template' to list metadata, provide 'template' for full detail, provide 'template' + 'params' to instantiate into executable JSON)."),
     name: z
         .string()
         .optional()
-        .describe("Schema/tool name for 'get'/'get_output'/'get_field' action (e.g., 'onchain_operations', 'onchain_operations_machine')."),
+        .describe("Schema/tool name for 'get'/'get_output'/'get_field'/'get_tool_reference' action (e.g., 'onchain_operations', 'onchain_operations_machine'), or pattern id for 'get_guard_design_patterns' (e.g., 'pattern.identity_check_allowlist')."),
     query: z
         .string()
         .optional()
-        .describe("Search query for 'search' action"),
+        .describe("Search query for 'search' action, keyword filter for 'get_tool_reference', or host filter for 'get_guard_design_patterns' (e.g. 'service_buy_guard', 'machine_forward', 'reward_claim')."),
     field_path: z
         .string()
         .optional()
@@ -28,7 +32,27 @@ export const SchemaQueryInputSchema = z
     template: z
         .string()
         .optional()
-        .describe("Guard template name for 'get_guard_templates' action. Omit to list all available templates. Available: signer_verification, progress_node_check, order_owner_verification, service_belonging_check, reward_not_claimed, combined_reward_guard."),
+        .describe("Guard template name for 'get_guard_templates' action. Omit to list all available templates. Available: signer_verification, progress_node_check, order_owner_verification, service_belonging_check, reward_not_claimed, combined_reward_guard. For 'get_templates': unified template id (e.g. 'tpl_buy_guard_whitelist', 'tpl_machine_ecommerce_standard', 'T-S-01', 'T-O-01', 'first_order')."),
+    object_type: z
+        .enum([
+        "guard",
+        "machine",
+        "service",
+        "order",
+        "progress",
+        "arbitration",
+        "treasury",
+        "permission",
+        "passport",
+        "allocation",
+        "reward",
+    ])
+        .optional()
+        .describe("Object-type filter for 'get_templates' list mode (e.g. 'guard' lists only Guard templates)."),
+    params: z
+        .string()
+        .optional()
+        .describe("JSON-encoded parameter object for 'get_templates' instantiation mode (e.g. '{\"whitelist\":[\"0xabc\"]}'). Required params are declared in each template's 'parameters' list (see detail mode)."),
     output_file: z
         .string()
         .optional()
@@ -63,7 +87,7 @@ export const SchemaQueryOutputSchema = z
         .union([
         z.array(SchemaListItemSchema).describe("List of schema summaries (list/search/list_operations)."),
         z.array(ExampleSearchResultSchema).describe("List of matching examples (search_examples)."),
-        z.record(z.unknown()).describe("JSON Schema object (get/get_output/get_field) or Guard template data."),
+        z.record(z.unknown()).describe("JSON Schema object (get/get_output/get_field), Guard template data, tool reference data (get_tool_reference), Guard design pattern catalog (get_guard_design_patterns), or safety rules tables (get_safety_rules)."),
         z.null().describe("No data — lookup failed or returned nothing, or data was written to output_file."),
     ])
         .describe("Response data — array of schema summaries for list-like actions, array of example results for search_examples, JSON Schema object for get/get_output/get_field, Guard template data for get_guard_templates, null on failure or when output_file is used."),