@wowok/agent-mcp 2.7.1 → 2.7.3

package/dist/schema/call/guard.js

@@ -1,161 +1 @@
-import { z } from 'zod';
-import { CallEnvSchema, NamedObjectSchema, SubmissionCallSchema } from './base.js';
-import { GuardNodeSchema } from '../query/index.js';
-import { DescriptionSchema, GuardTableItemBaseSchema, NameOrAddressSchema } from '../common/index.js';
-import { isBoolReturningQuery } from '../utils/guard-query-utils.js';
-import { ValueType } from '@wowok/wowok';
-export const CallGuard_RootSchema = z.union([
-    GuardNodeSchema.refine((node) => {
-        const allowedTypes = [
-            'logic_as_u256_greater', 'logic_as_u256_lesser', 'logic_as_u256_equal',
-            'logic_as_u256_greater_or_equal', 'logic_as_u256_lesser_or_equal',
-            'logic_equal', 'logic_not', 'logic_and', 'logic_or',
-            'logic_string_contains', 'logic_string_nocase_contains', 'logic_string_nocase_equal',
-            'calc_string_contains', 'calc_string_nocase_contains', 'calc_string_nocase_equal',
-            'vec_contains_bool', 'vec_contains_address', 'vec_contains_string',
-            'vec_contains_string_nocase', 'vec_contains_number',
-            'query_reward_record_exists',
-            'query',
-            'identifier'
-        ];
-        if (!allowedTypes.includes(node.type)) {
-            return false;
-        }
-        if (node.type === 'query') {
-            const queryNode = node;
-            if (!isBoolReturningQuery(queryNode.query)) {
-                return false;
-            }
-        }
-        return true;
-    }, {
-        message: "Guard root node must be an operation that returns Bool. Allowed types: logic_*, calc_string_contains, calc_string_nocase_*, vec_contains_*, reward_record_exist, identifier (must reference Bool type in table). For 'query' type, ONLY queries that return Bool are allowed. Use 'wowok_buildin_info' tool with {\"info\": \"guard instructions\", \"filter\": {\"returnType\": \"Bool\", \"scope\": \"object query\"}} to list all Bool-returning queries. Other nodes (calc_number_*, context, non-Bool queries) must be wrapped with a logic operation."
-    }).describe("Guard computational tree root node. MUST be an operation that returns a Bool value (pass/fail). For 'query' type, the specific query must return Bool. For 'identifier' type, the referenced table item must have value_type=Bool."),
-    z.object({
-        type: z.literal("file"),
-        file_path: z.string().describe("Path to JSON or Markdown file containing Guard definition. File can define: namedNew, description, table, root, rely."),
-        format: z.enum(["json", "markdown"]).optional().default("json")
-            .describe("File format: 'json' or 'markdown'. Default is 'json'."),
-    }).strict(),
-]).describe("Guard root definition. Either provide a direct GuardNode tree (must be a logical operation returning Bool) or reference a file to load. When using file type, fields defined in the schema (namedNew, description, table, rely) will OVERRIDE the corresponding fields in the file.");
-const isBoolValueType = (valueType) => {
-    if (typeof valueType === 'number') {
-        return valueType === ValueType.Bool;
-    }
-    if (typeof valueType === 'string') {
-        return valueType.toLowerCase() === 'bool' || valueType === '0';
-    }
-    return false;
-};
-export const GuardBindingHintActionSchema = z.enum([
-    "buy",
-    "forward",
-    "allocate",
-    "claim_reward",
-    "vote",
-    "dispute",
-    "write_repository",
-    "submit_progress",
-    "gen_passport",
-    "custom",
-]).describe("Guard protected action type. Maps to IntentPuzzle.action in the puzzle model.");
-export const GuardBindingHintHostObjectSchema = z.enum([
-    "Service",
-    "Machine",
-    "Arbitration",
-    "Reward",
-    "Repository",
-    "Progress",
-    "Demand",
-    "Standalone",
-]).describe("Host object type that the Guard will bind to. 'Standalone' for independent Guards (rely dependency or gen_passport).");
-export const GuardBindingHintBindingFieldSchema = z.enum([
-    "buy_guard",
-    "order_allocators",
-    "Forward.guard",
-    "submission",
-    "guard",
-    "write_guard",
-    "usage_guard",
-    "voting_guard",
-    "ServiceGuard",
-    "none",
-]).describe("Binding field on the host object. 'none' for standalone Guards.");
-export const GuardBindingHintSchema = z.object({
-    action: GuardBindingHintActionSchema
-        .describe("Protected action type. Example: 'buy' for Service buy_guard, 'forward' for Machine Forward.guard."),
-    host_object: GuardBindingHintHostObjectSchema
-        .describe("Host object type. Example: 'Service', 'Machine'."),
-    binding_field: GuardBindingHintBindingFieldSchema
-        .describe("Binding field. Example: 'buy_guard', 'Forward.guard'."),
-    rule_sentence: z.string().optional()
-        .describe("One-sentence description of the validation rule (human-readable). Example: 'Only the author can purchase this service'."),
-    failure_conditions: z.array(z.string()).optional()
-        .describe("List of conditions under which the Guard should FAIL. Example: ['Signer is not in allowlist','Order is already completed']."),
-    circular_reference: z.boolean().optional()
-        .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. 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."),
-    rely: z.object({
-        guards: z.array(NameOrAddressSchema).describe("List of dependent Guard object IDs or names."),
-        logic_or: z.boolean().optional().describe("Whether to use logical OR operator."),
-    }).optional().describe("All Guard objects that the new Guard object depends on. If logic_or is true, the execution result of the new Guard object is the logical OR of the execution results of all dependent Guard objects; otherwise, it is logical AND. When using root.type='file', this field OVERRIDES rely in the file."),
-    binding_hint: GuardBindingHintSchema.optional()
-        .describe("Phase 5 Guard capability hint. Provides semantic context (action + host_object + binding_field + optional rule/failure_conditions) for puzzle derivation. When provided, the response will include complete guard_advice (puzzle_status, matched_scene, suggested_patterns, confirmation_text, pending_questions). When absent, puzzle_status intent/binding dimensions are marked incomplete."),
-}).strict().refine((data) => {
-    if (typeof data.root === 'object' && data.root !== null && 'type' in data.root) {
-        const rootObj = data.root;
-        if (rootObj.type === 'file') {
-            return true;
-        }
-    }
-    const rootNode = data.root;
-    if (rootNode.type === 'identifier' && rootNode.identifier !== undefined) {
-        const tableItem = data.table?.find(item => item.identifier === rootNode.identifier);
-        if (!tableItem) {
-            return false;
-        }
-        if (!isBoolValueType(tableItem.value_type)) {
-            return false;
-        }
-    }
-    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 (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(),
-}).strict().describe("On-chain Guard creation input wrapper. Contains the Guard data definition and optional environment settings.");
-export const CallGenPassport_InputSchema = z.object({
-    guard: z.union([NameOrAddressSchema, z.array(NameOrAddressSchema)]).describe("Guard object ID(s) to verify and generate passport from. Can be a single guard (string) or multiple guards (array of strings). Supports guard names or addresses."),
-    info: SubmissionCallSchema.optional().describe("Optional submission data. If not provided, will attempt to get existing submissions from the guard."),
-    env: CallEnvSchema.optional(),
-}).strict().describe("Generate a new Passport object after Guard verification succeeds. The Passport is an immutable on-chain object that can be used for offline friend verification, transaction condition verification, etc. Supports verifying multiple guards at once.");
-export const Guard2File_InputSchema = z.object({
-    guard: NameOrAddressSchema.describe("Guard object ID or name to export"),
-    file_path: z.string().describe("Output file path (absolute or relative)"),
-    format: z.enum(["json", "markdown"]).optional().default("json").describe("Output format: 'json' (default) or 'markdown'"),
-    env: CallEnvSchema.optional(),
-}).strict().describe("Query a Guard object from the blockchain and export its definition to a JSON or Markdown file. The exported file can be edited and used to create new Guard objects.");
-export const Guard2File_OutputSchema = z.discriminatedUnion("status", [
-    z.object({
-        status: z.literal("success"),
-        data: z.object({
-            file_path: z.string().describe("Absolute path of the exported file"),
-            format: z.enum(["json", "markdown"]).describe("Export format"),
-            guard_object: z.string().describe("Guard object ID"),
-        }).strict().describe("Success result data"),
-    }).strict(),
-    z.object({
-        status: z.literal("error"),
-        error: z.string().describe("Error message"),
-    }).strict(),
-]).describe("Guard2File operation output schema with discriminator");
-export const Guard2File_OutputWrappedSchema = z.object({
-    result: Guard2File_OutputSchema,
-}).strict().describe("Guard2File operation output wrapped schema");
+import{z}from'zod';import{CallEnvSchema,NamedObjectSchema,SubmissionCallSchema}from'./base.js';import{GuardNodeSchema}from'../query/index.js';import{DescriptionSchema,GuardTableItemBaseSchema,NameOrAddressSchema}from'../common/index.js';import{isBoolReturningQuery}from'../utils/guard-query-utils.js';import{ValueType}from'@wowok/wowok';export const CallGuard_RootSchema=z['union']([GuardNodeSchema['refine'](a=>{const b=a,c=['logic_as_u256_greater','logic_as_u256_lesser','logic_as_u256_equal','logic_as_u256_greater_or_equal','logic_as_u256_lesser_or_equal','logic_equal','logic_not','logic_and','logic_or','logic_string_contains','logic_string_nocase_contains','logic_string_nocase_equal','calc_string_contains','calc_string_nocase_contains','calc_string_nocase_equal','vec_contains_bool','vec_contains_address','vec_contains_string','vec_contains_string_nocase','vec_contains_number','query_reward_record_exists','query','identifier'];if(!c['includes'](b['type']))return![];if(b['type']==='query'){const d=b;if(!isBoolReturningQuery(d['query']))return![];}return!![];},{'message':'Guard\x20root\x20node\x20must\x20be\x20an\x20operation\x20that\x20returns\x20Bool.\x20Allowed\x20types:\x20logic_*,\x20calc_string_contains,\x20calc_string_nocase_*,\x20vec_contains_*,\x20reward_record_exist,\x20identifier\x20(must\x20reference\x20Bool\x20type\x20in\x20table).\x20For\x20\x27query\x27\x20type,\x20ONLY\x20queries\x20that\x20return\x20Bool\x20are\x20allowed.\x20Use\x20\x27wowok_buildin_info\x27\x20tool\x20with\x20{\x22info\x22:\x20\x22guard\x20instructions\x22,\x20\x22filter\x22:\x20{\x22returnType\x22:\x20\x22Bool\x22,\x20\x22scope\x22:\x20\x22object\x20query\x22}}\x20to\x20list\x20all\x20Bool-returning\x20queries.\x20Other\x20nodes\x20(calc_number_*,\x20context,\x20non-Bool\x20queries)\x20must\x20be\x20wrapped\x20with\x20a\x20logic\x20operation.'})['describe']('Guard\x20computational\x20tree\x20root\x20node.\x20MUST\x20be\x20an\x20operation\x20that\x20returns\x20a\x20Bool\x20value\x20(pass/fail).\x20For\x20\x27query\x27\x20type,\x20the\x20specific\x20query\x20must\x20return\x20Bool.\x20For\x20\x27identifier\x27\x20type,\x20the\x20referenced\x20table\x20item\x20must\x20have\x20value_type=Bool.'),z['object']({'type':z['literal']('file'),'file_path':z['string']()['describe']('Path\x20to\x20JSON\x20or\x20Markdown\x20file\x20containing\x20Guard\x20definition.\x20File\x20can\x20define:\x20namedNew,\x20description,\x20table,\x20root,\x20rely.'),'format':z['enum'](['json','markdown'])['optional']()['default']('json')['describe']('File\x20format:\x20\x27json\x27\x20or\x20\x27markdown\x27.\x20Default\x20is\x20\x27json\x27.')})['strict']()])['describe']('Guard\x20root\x20definition.\x20Either\x20provide\x20a\x20direct\x20GuardNode\x20tree\x20(must\x20be\x20a\x20logical\x20operation\x20returning\x20Bool)\x20or\x20reference\x20a\x20file\x20to\x20load.\x20When\x20using\x20file\x20type,\x20fields\x20defined\x20in\x20the\x20schema\x20(namedNew,\x20description,\x20table,\x20rely)\x20will\x20OVERRIDE\x20the\x20corresponding\x20fields\x20in\x20the\x20file.');const isBoolValueType=a=>{if(typeof a==='number')return a===ValueType['Bool'];if(typeof a==='string')return a['toLowerCase']()==='bool'||a==='0';return![];};export const GuardBindingHintActionSchema=z['enum'](['buy','forward','allocate','claim_reward','vote','dispute','write_repository','submit_progress','gen_passport','custom'])['describe']('Guard\x20protected\x20action\x20type.\x20Maps\x20to\x20IntentPuzzle.action\x20in\x20the\x20puzzle\x20model.');export const GuardBindingHintHostObjectSchema=z['enum'](['Service','Machine','Arbitration','Reward','Repository','Progress','Demand','Standalone'])['describe']('Host\x20object\x20type\x20that\x20the\x20Guard\x20will\x20bind\x20to.\x20\x27Standalone\x27\x20for\x20independent\x20Guards\x20(rely\x20dependency\x20or\x20gen_passport).');export const GuardBindingHintBindingFieldSchema=z['enum'](['buy_guard','order_allocators','Forward.guard','submission','guard','write_guard','usage_guard','voting_guard','ServiceGuard','none'])['describe']('Binding\x20field\x20on\x20the\x20host\x20object.\x20\x27none\x27\x20for\x20standalone\x20Guards.');export const GuardBindingHintSchema=z['object']({'action':GuardBindingHintActionSchema['describe']('Protected\x20action\x20type.\x20Example:\x20\x27buy\x27\x20for\x20Service\x20buy_guard,\x20\x27forward\x27\x20for\x20Machine\x20Forward.guard.'),'host_object':GuardBindingHintHostObjectSchema['describe']('Host\x20object\x20type.\x20Example:\x20\x27Service\x27,\x20\x27Machine\x27.'),'binding_field':GuardBindingHintBindingFieldSchema['describe']('Binding\x20field.\x20Example:\x20\x27buy_guard\x27,\x20\x27Forward.guard\x27.'),'rule_sentence':z['string']()['optional']()['describe']('One-sentence\x20description\x20of\x20the\x20validation\x20rule\x20(human-readable).\x20Example:\x20\x27Only\x20the\x20author\x20can\x20purchase\x20this\x20service\x27.'),'failure_conditions':z['array'](z['string']())['optional']()['describe']('List\x20of\x20conditions\x20under\x20which\x20the\x20Guard\x20should\x20FAIL.\x20Example:\x20[\x27Signer\x20is\x20not\x20in\x20allowlist\x27,\x27Order\x20is\x20already\x20completed\x27].'),'circular_reference':z['boolean']()['optional']()['describe']('Whether\x20the\x20Guard\x20references\x20the\x20Host\x20Object\x20itself\x20(circular\x20reference\x20pattern).\x20true=Guard\x20queries\x20the\x20Host\x20Object\x20it\x20binds\x20to.')})['strict']()['describe']('Optional\x20semantic\x20hint\x20for\x20Guard\x20capability\x20system.\x20Provides\x20intent\x20+\x20binding\x20context\x20so\x20the\x20MCP\x20server\x20can\x20derive\x20GuardPuzzle,\x20run\x20risk\x20assessment,\x20and\x20generate\x20confirmation\x20text.\x20Strongly\x20recommended:\x20fill\x20this\x20field\x20to\x20enable\x20puzzle_status,\x20matched_scene,\x20suggested_patterns,\x20confirmation_text,\x20and\x20pending_questions\x20in\x20the\x20response\x20guard_advice.');export const CallGuard_DataSchema=z['object']({'namedNew':NamedObjectSchema['optional']()['describe']('Name\x20and\x20optional\x20tags\x20for\x20the\x20new\x20Guard\x20object.\x20Set\x20\x27onChain:\x20true\x27\x20to\x20create\x20a\x20public\x20on-chain\x20identity.\x20When\x20using\x20root.type=\x27file\x27,\x20this\x20field\x20OVERRIDES\x20namedNew\x20in\x20the\x20file.\x20CIRCULAR\x20DEPENDENCY\x20(DOC-01):\x20When\x20a\x20Guard\x20queries\x20a\x20Service\x20that\x20hasn\x27t\x20been\x20created\x20yet,\x20use\x20a\x20LocalMark\x20NAME\x20(not\x20address)\x20in\x20the\x20query\x20table\x20—\x20the\x20name\x20is\x20resolved\x20to\x20an\x20address\x20at\x20transaction\x20build\x20time.\x20Workflow:\x20(1)\x20Create\x20Service\x20(Phase\x201,\x20no\x20publish)\x20→\x20(2)\x20Create\x20Guard\x20referencing\x20Service\x20by\x20name\x20→\x20(3)\x20Update\x20Service.buy_guard\x20=\x20Guard\x20address\x20→\x20(4)\x20Publish\x20Service.'),'description':DescriptionSchema['optional']()['describe']('Guard\x20description.\x20When\x20using\x20root.type=\x27file\x27,\x20this\x20field\x20OVERRIDES\x20description\x20in\x20the\x20file.'),'table':z['array'](GuardTableItemBaseSchema)['optional']()['describe']('Data\x20table\x20of\x20the\x20Guard\x20object.\x20When\x20using\x20root.type=\x27file\x27,\x20this\x20field\x20OVERRIDES\x20table\x20in\x20the\x20file.'),'root':CallGuard_RootSchema['describe']('Root\x20definition:\x20either\x20a\x20direct\x20GuardNode\x20(must\x20be\x20a\x20logical\x20operation\x20returning\x20Bool)\x20or\x20a\x20file\x20reference\x20(type=\x27file\x27).\x20When\x20type=\x27file\x27,\x20the\x20file\x20can\x20define\x20all\x20Guard\x20fields\x20(namedNew,\x20description,\x20table,\x20root,\x20rely),\x20and\x20schema\x20fields\x20override\x20file\x20content.'),'rely':z['object']({'guards':z['array'](NameOrAddressSchema)['describe']('List\x20of\x20dependent\x20Guard\x20object\x20IDs\x20or\x20names.'),'logic_or':z['boolean']()['optional']()['describe']('Whether\x20to\x20use\x20logical\x20OR\x20operator.')})['optional']()['describe']('All\x20Guard\x20objects\x20that\x20the\x20new\x20Guard\x20object\x20depends\x20on.\x20If\x20logic_or\x20is\x20true,\x20the\x20execution\x20result\x20of\x20the\x20new\x20Guard\x20object\x20is\x20the\x20logical\x20OR\x20of\x20the\x20execution\x20results\x20of\x20all\x20dependent\x20Guard\x20objects;\x20otherwise,\x20it\x20is\x20logical\x20AND.\x20When\x20using\x20root.type=\x27file\x27,\x20this\x20field\x20OVERRIDES\x20rely\x20in\x20the\x20file.'),'binding_hint':GuardBindingHintSchema['optional']()['describe']('Phase\x205\x20Guard\x20capability\x20hint.\x20Provides\x20semantic\x20context\x20(action\x20+\x20host_object\x20+\x20binding_field\x20+\x20optional\x20rule/failure_conditions)\x20for\x20puzzle\x20derivation.\x20When\x20provided,\x20the\x20response\x20will\x20include\x20complete\x20guard_advice\x20(puzzle_status,\x20matched_scene,\x20suggested_patterns,\x20confirmation_text,\x20pending_questions).\x20When\x20absent,\x20puzzle_status\x20intent/binding\x20dimensions\x20are\x20marked\x20incomplete.')})['strict']()['refine'](a=>{if(typeof a['root']==='object'&&a['root']!==null&&'type'in a['root']){const c=a['root'];if(c['type']==='file')return!![];}const b=a['root'];if(b['type']==='identifier'&&b['identifier']!==undefined){const d=a['table']?.['find'](e=>e['identifier']===b['identifier']);if(!d)return![];if(!isBoolValueType(d['value_type']))return![];}return!![];},{'message':'Invalid\x20Guard\x20root:\x20When\x20using\x20\x27identifier\x27\x20as\x20root,\x20the\x20referenced\x20table\x20item\x20must\x20exist\x20and\x20have\x20value_type=\x27Bool\x27\x20(or\x200).'})['describe']('On-chain\x20Guard\x20creation.\x20IMPORTANT:\x20All\x20defined\x20data\x20(include\x20all\x20submitted\x20data)\x20must\x20be\x20defined\x20in\x20the\x20\x27table\x27\x20field.\x20USAGE:\x20Set\x20\x27namedNew\x27\x20field\x20with\x20{name,\x20tags?,\x20onChain?}\x20to\x20name\x20the\x20new\x20Guard\x20(you\x20may\x20also\x20use\x20\x27object\x27\x20as\x20an\x20alias\x20for\x20\x27namedNew\x27\x20—\x20the\x20MCP\x20preprocess\x20will\x20convert\x20it\x20automatically).\x20The\x20Guard\x20is\x20immutable\x20once\x20created.\x20Define\x20the\x20validation\x20logic\x20in\x20\x27root\x27\x20field.\x20When\x20root.type=\x27file\x27,\x20the\x20file\x20can\x20contain\x20all\x20Guard\x20fields,\x20and\x20any\x20fields\x20defined\x20in\x20the\x20schema\x20will\x20OVERRIDE\x20the\x20file\x20content.');export const CallGuard_InputSchema=z['object']({'data':CallGuard_DataSchema['describe']('Guard\x20data\x20definition.'),'env':CallEnvSchema['optional']()})['strict']()['describe']('On-chain\x20Guard\x20creation\x20input\x20wrapper.\x20Contains\x20the\x20Guard\x20data\x20definition\x20and\x20optional\x20environment\x20settings.');export const CallGenPassport_InputSchema=z['object']({'guard':z['union']([NameOrAddressSchema,z['array'](NameOrAddressSchema)])['describe']('Guard\x20object\x20ID(s)\x20to\x20verify\x20and\x20generate\x20passport\x20from.\x20Can\x20be\x20a\x20single\x20guard\x20(string)\x20or\x20multiple\x20guards\x20(array\x20of\x20strings).\x20Supports\x20guard\x20names\x20or\x20addresses.'),'info':SubmissionCallSchema['optional']()['describe']('Optional\x20submission\x20data.\x20If\x20not\x20provided,\x20will\x20attempt\x20to\x20get\x20existing\x20submissions\x20from\x20the\x20guard.'),'env':CallEnvSchema['optional']()})['strict']()['describe']('Generate\x20a\x20new\x20Passport\x20object\x20after\x20Guard\x20verification\x20succeeds.\x20The\x20Passport\x20is\x20an\x20immutable\x20on-chain\x20object\x20that\x20can\x20be\x20used\x20for\x20offline\x20friend\x20verification,\x20transaction\x20condition\x20verification,\x20etc.\x20Supports\x20verifying\x20multiple\x20guards\x20at\x20once.');export const Guard2File_InputSchema=z['object']({'guard':NameOrAddressSchema['describe']('Guard\x20object\x20ID\x20or\x20name\x20to\x20export'),'file_path':z['string']()['optional']()['describe']('Output\x20file\x20path\x20(absolute\x20or\x20relative).\x20Defaults\x20to\x20the\x20workspace\x20directory\x20when\x20omitted.'),'format':z['enum'](['json','markdown'])['optional']()['default']('json')['describe']('Output\x20format:\x20\x27json\x27\x20(default)\x20or\x20\x27markdown\x27'),'env':CallEnvSchema['optional']()})['strict']()['describe']('Query\x20a\x20Guard\x20object\x20from\x20the\x20blockchain\x20and\x20export\x20its\x20definition\x20to\x20a\x20JSON\x20or\x20Markdown\x20file.\x20The\x20exported\x20file\x20can\x20be\x20edited\x20and\x20used\x20to\x20create\x20new\x20Guard\x20objects.');export const Guard2File_OutputSchema=z['discriminatedUnion']('status',[z['object']({'status':z['literal']('success'),'data':z['object']({'file_path':z['string']()['describe']('Absolute\x20path\x20of\x20the\x20exported\x20file'),'format':z['enum'](['json','markdown'])['describe']('Export\x20format'),'guard':z['string']()['describe']('Guard\x20object\x20ID\x20that\x20was\x20exported')})['strict']()['describe']('Success\x20result\x20data')})['strict'](),z['object']({'status':z['literal']('error'),'error':z['string']()['describe']('Error\x20message')})['strict']()])['describe']('Guard2File\x20operation\x20output\x20schema\x20with\x20discriminator');export const Guard2File_OutputWrappedSchema=z['object']({'result':Guard2File_OutputSchema})['strict']()['describe']('Guard2File\x20operation\x20output\x20wrapped\x20schema');

package/dist/schema/call/handler.js

@@ -1,322 +1 @@
-import { ResponseData, LocalMark, enrichMoveError } from "@wowok/wowok";
-import { classifyError, buildSemantic } from "./semantic.js";
-let successHook = null;
-export function registerSuccessHook(hook) {
-    successHook = hook;
-}
-function fireSuccessHook(result, context) {
-    if (successHook) {
-        try {
-            successHook(result, context);
-        }
-        catch { }
-    }
-}
-function applySchemaWarning(output, context) {
-    const schemaCheck = context?.schema_check;
-    if (!schemaCheck || (schemaCheck.warnings.length === 0 && schemaCheck.errors.length === 0)) {
-        return output;
-    }
-    const warnings = [...schemaCheck.warnings, ...schemaCheck.errors];
-    let semantic = output.semantic;
-    if (semantic && warnings.length > 0) {
-        semantic = {
-            ...semantic,
-            warnings: [...(semantic.warnings || []), ...warnings],
-        };
-    }
-    const schemaWarning = {
-        compatible: schemaCheck.compatible,
-        warnings,
-        client_version: schemaCheck.client_version,
-        server_versions: schemaCheck.versions,
-    };
-    return {
-        ...output,
-        semantic,
-        schema_warning: schemaWarning,
-    };
-}
-function convertBigInts(obj) {
-    if (typeof obj === "bigint")
-        return obj.toString();
-    if (Array.isArray(obj))
-        return obj.map(convertBigInts);
-    if (obj && typeof obj === "object") {
-        const out = {};
-        for (const k of Object.keys(obj))
-            out[k] = convertBigInts(obj[k]);
-        return out;
-    }
-    return obj;
-}
-function runHarnessLoops(context, output, errorCode) {
-    if (!context?.harness || !context?.expected)
-        return undefined;
-    const harness = context.harness;
-    const expected = context.expected;
-    const actualSemantic = output.semantic;
-    const verifyReport = harness.verify({
-        expected,
-        actual: {
-            result_type: output.result.type,
-            semantic: actualSemantic,
-            error_code: output.result.type === "error" ? output.result.error_code : undefined,
-        },
-    });
-    let recovery;
-    const needRecovery = verifyReport.status !== "pass" || output.result.type === "error" || errorCode;
-    if (needRecovery) {
-        const ec = errorCode
-            || (output.result.type === "error" ? output.result.error_code : undefined)
-            || "unknown";
-        recovery = harness.recover(ec, context.operation_id || expected.operation, {
-            operation_type: context.operation_type,
-            data: context.data,
-        });
-    }
-    return {
-        verify: {
-            status: verifyReport.status,
-            mismatches: verifyReport.mismatches.map(m => convertBigInts(m)),
-            summary: verifyReport.summary,
-            timestamp: verifyReport.timestamp,
-        },
-        recovery: recovery ? {
-            strategy: recovery.strategy,
-            should_retry: recovery.should_retry,
-            adjusted_params: recovery.adjusted_params,
-            user_prompt: recovery.user_prompt,
-            max_attempts: recovery.max_attempts,
-            current_attempt: recovery.current_attempt,
-            detail: recovery.detail,
-        } : undefined,
-    };
-}
-export function handleCallResult(result, context) {
-    const safeResult = convertBigInts(result);
-    if (safeResult && "error" in safeResult) {
-        const enrichedError = enrichMoveError(safeResult.error);
-        const classified = classifyError(enrichedError);
-        const output = {
-            message: `Error: ${enrichedError}`,
-            result: {
-                type: "error",
-                error: enrichedError,
-                error_code: classified.error_code,
-                retryable: classified.retryable,
-                recovery_hint: classified.recovery_hint,
-            },
-        };
-        const harnessReport = runHarnessLoops(context, output, classified.error_code);
-        if (harnessReport)
-            output.harness_report = harnessReport;
-        const finalOutput = applySchemaWarning(output, context);
-        return {
-            content: [{ type: "text", text: finalOutput.message }],
-            structuredContent: finalOutput,
-        };
-    }
-    if (safeResult && "digest" in safeResult) {
-        const r = ResponseData(safeResult);
-        const txStatus = safeResult?.effects?.status?.status;
-        const txError = safeResult?.effects?.status?.error;
-        const isSuccess = txStatus === "success";
-        if (!isSuccess) {
-            const enrichedError = enrichMoveError(txError || txStatus || "unknown error");
-            const classified = classifyError(enrichedError);
-            const output = {
-                message: `Transaction failed: ${enrichedError}`,
-                result: {
-                    type: "error",
-                    error: enrichedError,
-                    error_code: classified.error_code,
-                    retryable: classified.retryable,
-                    recovery_hint: classified.recovery_hint,
-                },
-            };
-            const harnessReport = runHarnessLoops(context, output, classified.error_code);
-            if (harnessReport)
-                output.harness_report = harnessReport;
-            const finalOutput = applySchemaWarning(output, context);
-            return {
-                content: [
-                    { type: "text", text: finalOutput.message },
-                    { type: "text", text: JSON.stringify(r) },
-                ],
-                structuredContent: finalOutput,
-            };
-        }
-        const output = {
-            message: "Transaction completed successfully",
-            result: { type: "transaction", ...safeResult },
-            semantic: buildSemantic(safeResult, context),
-        };
-        const harnessReport = runHarnessLoops(context, output);
-        if (harnessReport)
-            output.harness_report = harnessReport;
-        fireSuccessHook(result, context);
-        const finalOutput = applySchemaWarning(output, context);
-        return {
-            content: [
-                { type: "text", text: finalOutput.message },
-                { type: "text", text: JSON.stringify(r) },
-            ],
-            structuredContent: finalOutput,
-        };
-    }
-    if (safeResult && "guard" in safeResult && "submission" in safeResult) {
-        const output = {
-            message: "Submission required for Guard verification",
-            result: { type: "submission", ...safeResult },
-            semantic: context ? {
-                intent: "guard_submission_required",
-                status: "pending_input",
-                summary: "Guard verification required — fill the submission data and resubmit",
-                next_actions: [{
-                        action: "fill guard submission data and resubmit via call_with_submission",
-                        reason: "Guard rejected the call; submission must satisfy the Guard table requirements",
-                        tool: "onchain_operations (with submission field)",
-                        priority: "required",
-                    }],
-            } : undefined,
-        };
-        const harnessReport = runHarnessLoops(context, output);
-        if (harnessReport)
-            output.harness_report = harnessReport;
-        const finalOutput = applySchemaWarning(output, context);
-        return {
-            content: [
-                { type: "text", text: finalOutput.message },
-                { type: "text", text: JSON.stringify(safeResult) },
-            ],
-            structuredContent: finalOutput,
-        };
-    }
-    if (Array.isArray(safeResult)) {
-        const output = {
-            message: "Operation completed",
-            result: { type: "data", data: safeResult },
-        };
-        const harnessReport = runHarnessLoops(context, output);
-        if (harnessReport)
-            output.harness_report = harnessReport;
-        const finalOutput = applySchemaWarning(output, context);
-        return {
-            content: [
-                { type: "text", text: finalOutput.message },
-                { type: "text", text: JSON.stringify(safeResult) },
-            ],
-            structuredContent: finalOutput,
-        };
-    }
-    if (safeResult === undefined || safeResult === null) {
-        const output = {
-            message: "Operation completed",
-            result: { type: "null" },
-        };
-        const harnessReport = runHarnessLoops(context, output);
-        if (harnessReport)
-            output.harness_report = harnessReport;
-        const finalOutput = applySchemaWarning(output, context);
-        return {
-            content: [{ type: "text", text: finalOutput.message }],
-            structuredContent: finalOutput,
-        };
-    }
-    const output = {
-        message: "Operation completed",
-        result: { type: "transaction", ...safeResult },
-        semantic: buildSemantic(safeResult, context),
-    };
-    const harnessReport = runHarnessLoops(context, output);
-    if (harnessReport)
-        output.harness_report = harnessReport;
-    const finalOutput = applySchemaWarning(output, context);
-    return {
-        content: [{ type: "text", text: finalOutput.message }],
-        structuredContent: finalOutput,
-    };
-}
-export function createServerConfig(packageJson, description) {
-    return {
-        name: packageJson.name,
-        version: packageJson.version,
-        description: description || packageJson.description,
-    };
-}
-export function createCapabilitiesConfig() {
-    return {
-        capabilities: {
-            prompts: {},
-            resources: {},
-            tools: { listChanged: true },
-            logging: {},
-        },
-    };
-}
-export function createToolMeta(category, tags) {
-    return {
-        author: "WOWOK Team",
-        createdAt: "2026-02-01",
-        lastUpdated: "2026-02-01",
-        category,
-        tags,
-        requiresAuth: false,
-    };
-}
-export function createToolAnnotations(readOnlyHint = false, destructiveHint = false) {
-    return {
-        readOnlyHint,
-        destructiveHint,
-        idempotentHint: true,
-        openWorldHint: false,
-    };
-}
-export async function transformSubmission(submission) {
-    if (!submission)
-        return undefined;
-    const guardNames = (submission.guard || []).map((g) => g.object).filter(Boolean);
-    const submissionGuardNames = (submission.submission || []).map((s) => s.guard).filter(Boolean);
-    const allNames = [...new Set([...guardNames, ...submissionGuardNames])];
-    const resolvedAddresses = allNames.length > 0
-        ? await LocalMark.Instance().get_many_address(allNames)
-        : [];
-    const nameToAddress = new Map();
-    allNames.forEach((name, index) => {
-        const addr = resolvedAddresses[index];
-        if (addr) {
-            nameToAddress.set(name, addr);
-        }
-    });
-    const getAddress = (name) => {
-        if (nameToAddress.has(name)) {
-            return nameToAddress.get(name);
-        }
-        for (const [n, addr] of nameToAddress.entries()) {
-            if (n === name)
-                return addr;
-        }
-        if (name.startsWith("0x") && name.length === 66) {
-            return name;
-        }
-        throw new Error(`Guard name or address not found: ${name}`);
-    };
-    return {
-        type: "submission",
-        guard: (submission.guard || []).map((g) => ({
-            object: getAddress(g.object),
-            impack: g.impack || false,
-        })),
-        submission: (submission.submission || []).map((s) => ({
-            guard: getAddress(s.guard),
-            submission: s.submission || [],
-        })),
-    };
-}
-export function validateInput(data, schema) {
-    return schema.parse(data);
-}
-export function getEnvConfig(env) {
-    return env ?? {};
-}
+import{ResponseData,LocalMark,enrichMoveError}from'@wowok/wowok';import{classifyError,buildSemantic}from'./semantic.js';let successHook=null;export function registerSuccessHook(a){successHook=a;}function fireSuccessHook(a,b){if(successHook)try{successHook(a,b);}catch{}}function applySchemaWarning(a,b){const c=b?.['schema_check'];if(!c||c['warnings']['length']===0x0&&c['errors']['length']===0x0)return a;const d=[...c['warnings'],...c['errors']];let e=a['semantic'];e&&d['length']>0x0&&(e={...e,'warnings':[...e['warnings']||[],...d]});const f={'compatible':c['compatible'],'warnings':d,'client_version':c['client_version'],'server_versions':c['versions']};return{...a,'semantic':e,'schema_warning':f};}function convertBigInts(a){if(typeof a==='bigint')return a['toString']();if(Array['isArray'](a))return a['map'](convertBigInts);if(a&&typeof a==='object'){const b={};for(const c of Object['keys'](a))b[c]=convertBigInts(a[c]);return b;}return a;}function runHarnessLoops(a,b,c){if(!a?.['harness']||!a?.['expected'])return undefined;const d=a['harness'],e=a['expected'],f=b['semantic'],g=d['verify']({'expected':e,'actual':{'result_type':b['result']['type'],'semantic':f,'error_code':b['result']['type']==='error'?b['result']['error_code']:undefined}});let h;const i=g['status']!=='pass'||b['result']['type']==='error'||c;if(i){const j=c||(b['result']['type']==='error'?b['result']['error_code']:undefined)||'unknown';h=d['recover'](j,a['operation_id']||e['operation'],{'operation_type':a['operation_type'],'data':a['data']});}return{'verify':{'status':g['status'],'mismatches':g['mismatches']['map'](k=>convertBigInts(k)),'summary':g['summary'],'timestamp':g['timestamp']},'recovery':h?{'strategy':h['strategy'],'should_retry':h['should_retry'],'adjusted_params':h['adjusted_params'],'user_prompt':h['user_prompt'],'max_attempts':h['max_attempts'],'current_attempt':h['current_attempt'],'detail':h['detail']}:undefined};}export function handleCallResult(a,b){const c=convertBigInts(a);if(c&&'error'in c){const g=enrichMoveError(c['error']),h=classifyError(g),i={'message':'Error:\x20'+g,'result':{'type':'error','error':g,'error_code':h['error_code'],'retryable':h['retryable'],'recovery_hint':h['recovery_hint']}},j=runHarnessLoops(b,i,h['error_code']);if(j)i['harness_report']=j;const k=applySchemaWarning(i,b);return{'content':[{'type':'text','text':k['message']}],'structuredContent':k};}if(c&&'digest'in c){const l=ResponseData(c),m=c?.['effects']?.['status']?.['status'],n=c?.['effects']?.['status']?.['error'],o=m==='success';if(!o){const t=enrichMoveError(n||m||'unknown\x20error'),u=classifyError(t),v={'message':'Transaction\x20failed:\x20'+t,'result':{'type':'error','error':t,'error_code':u['error_code'],'retryable':u['retryable'],'recovery_hint':u['recovery_hint']}},w=runHarnessLoops(b,v,u['error_code']);if(w)v['harness_report']=w;const x=applySchemaWarning(v,b);return{'content':[{'type':'text','text':x['message']},{'type':'text','text':JSON['stringify'](l)}],'structuredContent':x};}const p={'message':'Transaction\x20completed\x20successfully','result':{'type':'transaction',...c},'semantic':buildSemantic(c,b)},q=runHarnessLoops(b,p);if(q)p['harness_report']=q;fireSuccessHook(a,b);const s=applySchemaWarning(p,b);return{'content':[{'type':'text','text':s['message']},{'type':'text','text':JSON['stringify'](l)}],'structuredContent':s};}if(c&&'guard'in c&&'submission'in c){const y={'message':'Submission\x20required\x20for\x20Guard\x20verification','result':{'type':'submission',...c},'semantic':b?{'intent':'guard_submission_required','status':'pending_input','summary':'Guard\x20verification\x20required\x20—\x20fill\x20the\x20submission\x20data\x20and\x20resubmit','next_actions':[{'action':'fill\x20guard\x20submission\x20data\x20and\x20resubmit\x20via\x20call_with_submission','reason':'Guard\x20rejected\x20the\x20call;\x20submission\x20must\x20satisfy\x20the\x20Guard\x20table\x20requirements','tool':'onchain_operations\x20(with\x20submission\x20field)','priority':'required'}]}:undefined},z=runHarnessLoops(b,y);if(z)y['harness_report']=z;const A=applySchemaWarning(y,b);return{'content':[{'type':'text','text':A['message']},{'type':'text','text':JSON['stringify'](c)}],'structuredContent':A};}if(Array['isArray'](c)){const B={'message':'Operation\x20completed','result':{'type':'data','data':c}},C=runHarnessLoops(b,B);if(C)B['harness_report']=C;const D=applySchemaWarning(B,b);return{'content':[{'type':'text','text':D['message']},{'type':'text','text':JSON['stringify'](c)}],'structuredContent':D};}if(c===undefined||c===null){const E={'message':'Operation\x20completed','result':{'type':'null'}},F=runHarnessLoops(b,E);if(F)E['harness_report']=F;const G=applySchemaWarning(E,b);return{'content':[{'type':'text','text':G['message']}],'structuredContent':G};}const d={'message':'Operation\x20completed','result':{'type':'transaction',...c},'semantic':buildSemantic(c,b)},e=runHarnessLoops(b,d);if(e)d['harness_report']=e;const f=applySchemaWarning(d,b);return{'content':[{'type':'text','text':f['message']}],'structuredContent':f};}export function createServerConfig(a,b){return{'name':a['name'],'version':a['version'],'description':b||a['description']};}export function createCapabilitiesConfig(){return{'capabilities':{'prompts':{},'resources':{},'tools':{'listChanged':!![]},'logging':{}}};}export function createToolMeta(a,b){return{'author':'WOWOK\x20Team','createdAt':'2026-02-01','lastUpdated':'2026-02-01','category':a,'tags':b,'requiresAuth':![]};}export function createToolAnnotations(a=![],b=![]){return{'readOnlyHint':a,'destructiveHint':b,'idempotentHint':!![],'openWorldHint':![]};}export async function transformSubmission(a){if(!a)return undefined;const b=(a['guard']||[])['map'](h=>h['object'])['filter'](Boolean),c=(a['submission']||[])['map'](h=>h['guard'])['filter'](Boolean),d=[...new Set([...b,...c])],e=d['length']>0x0?await LocalMark['Instance']()['get_many_address'](d):[],f=new Map();d['forEach']((h,i)=>{const j=e[i];j&&f['set'](h,j);});const g=h=>{if(f['has'](h))return f['get'](h);for(const [i,j]of f['entries']()){if(i===h)return j;}if(h['startsWith']('0x')&&h['length']===0x42)return h;throw new Error('Guard\x20name\x20or\x20address\x20not\x20found:\x20'+h);};return{'type':'submission','guard':(a['guard']||[])['map'](h=>({'object':g(h['object']),'impack':h['impack']||![]})),'submission':(a['submission']||[])['map'](h=>({'guard':g(h['guard']),'submission':h['submission']||[]}))};}export function validateInput(a,b){return b['parse'](a);}export function getEnvConfig(a){return a??{};}

package/dist/schema/call/index.js

@@ -1,20 +1 @@
-export * from './base.js';
-export * from './handler.js';
-export * from './semantic.js';
-export * from './contact.js';
-export * from './demand.js';
-export * from './guard.js';
-export * from './machine.js';
-export * from './arbitration.js';
-export * from './allocation.js';
-export * from './order.js';
-export * from './payment.js';
-export * from './permission.js';
-export * from './personal.js';
-export * from './proof.js';
-export * from './progress.js';
-export * from './repository.js';
-export * from './reward.js';
-export * from './service.js';
-export * from './treasury.js';
-export * from './bridge.js';
+export*from'./base.js';export*from'./handler.js';export*from'./semantic.js';export*from'./contact.js';export*from'./demand.js';export*from'./guard.js';export*from'./machine.js';export*from'./arbitration.js';export*from'./allocation.js';export*from'./order.js';export*from'./payment.js';export*from'./permission.js';export*from'./personal.js';export*from'./proof.js';export*from'./progress.js';export*from'./repository.js';export*from'./reward.js';export*from'./service.js';export*from'./treasury.js';export*from'./bridge.js';