@wowok/agent-mcp 2.3.14 → 2.3.18

package/dist/schema/query/index.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { TokenTypeInfoSchema, QueryLocalMarkListResultSchema, QueryAccountListResultSchema, QueryLocalInfoListResultSchema, QueryLocalTokenListResultSchema, QueryAccountResultSchema } from "../local/index.js";
 import { AccountOrMark_AddressSchema, BalanceTypeSchema, CacheExpireTypeSchema, EntrypointSchema, GuardIdentifierSchema, GuardTableItemSchema, NameOrAddressSchema, ObjectBaseSchema, ObjectTypeSchema, QueryIdSchema, SupportedValueSchema, ValueTypeSchema, QueryReceivedResultSchema, LongNameSchema, DescriptionSchema } from "../common/index.js";
-const SemanticSummarySchema = z.any();
+import { SemanticSummarySchema } from "../call/index.js";
 import { isValidPermissionIndex } from '../utils/permission-index-utils.js';
 import { isValidGuardQueryId, isValidGuardQueryIdOrName } from '../utils/guard-query-utils.js';
 import { ENTITY_LINKER_ADDRESS, ENTITY_REGISTRAR_ADDRESS, isWitnessType, } from "@wowok/wowok";
@@ -9,6 +9,9 @@ import { DiscountType as WDiscountType } from "@wowok/wowok";
 import { QueryEnvSchema } from "../common/index.js";
 const MAX_MULTI_OPERANDS = 8;
 const VALUE_TYPE_DESCRIPTION = "Value type: can be specified as a string name (e.g., 'U64', 'Address', 'String') or a number (0-18). Supported types: Bool=0/'Bool', Address=1/'Address', String=2/'String', U8=3/'U8', U16=4/'U16', U32=5/'U32', U64=6/'U64', U128=7/'U128', U256=8/'U256', VecBool=9/'VecBool', VecAddress=10/'VecAddress', VecString=11/'VecString', VecU8=12/'VecU8', VecU16=13/'VecU16', VecU32=14/'VecU32', VecU64=15/'VecU64', VecU128=16/'VecU128', VecU256=17/'VecU256', VecVecU8=18/'VecVecU8'. Note: Value=19 is an INTERNAL type for wowok system use only and should NOT be used directly by users. String format is recommended for better readability.";
+const tolerantNumber = z.union([z.number(), z.string()]);
+const tolerantStringNullable = z.union([z.string(), z.null(), z.undefined()]);
+const tolerantNumberNullable = z.union([z.number(), z.string(), z.null(), z.undefined()]);
 export const AmountTypeSchema = z.enum(["GuardU64Identifier", "Fixed"]).describe("Amount type. GuardU64Identifier indicates the amount comes from U64 type data defined in Guard table (Identifier index), Fixed indicates using a fixed amount.");
 export const GuardQuerySchema = z.object({
     id: QueryIdSchema,
@@ -44,7 +47,7 @@ export const VoteInEntityLinkerSchema = z.object({
     like: z.boolean().optional().describe("Whether liked"),
     dislike: z.boolean().optional().describe("Whether disliked"),
     affiliation: z.boolean().optional().describe("Whether affiliated"),
-    time: z.number().describe("Time"),
+    time: tolerantNumber.describe("Time"),
 }).describe("Follow record");
 export const ObjectEntityRegistrarSchema = ObjectBaseSchema.extend({
     entity_count: z.number().describe("Entity count. Number of entities registered in the entity registrar table. Use 'query_table' or 'query_table_item' to get 'EntityRegistrar' table items."),
@@ -57,16 +60,16 @@ export const ObjectResourceSchema = ObjectBaseSchema.extend({
 }).describe("On-chain address tag manager");
 export const TableItem_EntityLinkerSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Followed ID"),
-    pos: z.number().describe("Current follow information position"),
-    count: z.number().describe("Follower count. Number of entities who have been followed others. Use 'query_table' or 'query_table_item' to get 'EntityLinker' table items."),
+    pos: tolerantNumber.describe("Current follow information position"),
+    count: tolerantNumber.describe("Follower count. Number of entities who have been followed others. Use 'query_table' or 'query_table_item' to get 'EntityLinker' table items."),
     votes: z.array(VoteInEntityLinkerSchema).describe("Follow records"),
 }).describe("On-chain followed object data");
 export const TableItem_EntityRegistrarSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Entity ID"),
     description: z.string().describe("Entity description"),
-    time: z.number().describe("On-chain registration time"),
-    referrer: z.union([z.string(), z.null()]).describe("Referrer"),
-    mark_object: z.union([z.string(), z.null()]).describe("Your on-chain address mark object by entity ID"),
+    time: tolerantNumber.describe("On-chain registration time"),
+    referrer: tolerantStringNullable.describe("Referrer"),
+    mark_object: tolerantStringNullable.describe("Your on-chain address mark object by entity ID"),
     records: z.array(RecordsInEntitySchema).describe("Information records"),
 }).describe("On-chain entity data");
 export const TableItem_AddressMarkSchema = ObjectBaseSchema.extend({
@@ -135,13 +138,13 @@ export const ProgressSessionHolderSchema = z.object({
     retained_submission: z.array(GuardSubmissionSchema).describe("Used to define submitted data after Guard verification"),
     msg: z.string().describe("Information submitted to complete operation"),
     accomplished: z.boolean().describe("Whether completed"),
-    time: z.number().describe("Session creation time"),
+    time: tolerantNumber.describe("Session creation time"),
 }).describe("An operation in Progress session");
 export const ProgressSessionSchema = z.object({
     next_node: z.string().describe("Next node ID"),
     forwards: z.array(ProgressSessionHolderSchema).describe("Operation list in Progress session"),
-    weights: z.number().describe("Total operation weight"),
-    threshold: z.number().describe("Operation threshold. When total operation weight exceeds threshold, session is considered completed and Progress moves from current node to next node."),
+    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."),
 }).describe("Progress session");
 export const ObjectProgressSchema = ObjectBaseSchema.extend({
     machine: z.string().describe("Machine ID that Progress object belongs to"),
@@ -336,8 +339,8 @@ export const TableItem_RewardRecordSchema = ObjectBaseSchema.extend({
     total: BalanceTypeSchema.describe("Total reward amount"),
     record: z.array(z.object({
         amount: BalanceTypeSchema.describe("Reward amount"),
-        time: z.number().describe("Reward time"),
-        store_from_id: z.union([z.string(), z.null()]).describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
+        time: tolerantNumber.describe("Reward time"),
+        store_from_id: tolerantStringNullable.describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
     })).describe("Reward record list"),
 }).describe("Reward object's reward record");
 export const ObjectRepositorySchema = ObjectBaseSchema.extend({
@@ -821,31 +824,31 @@ export const ObjectPassportSchema = ObjectBaseSchema.extend({
 }).describe("Passport object");
 export const TableItem_PermissionPermSchema = ObjectBaseSchema.extend({
     address: z.string().describe("User ID or Guard ID"),
-    perm: z.array(PermissionIndexTypeSchema).describe("Permission list obtained after user or Guard object verification"),
+    perm: z.array(PermissionIndexTypeSchema.nullable().or(z.number())).describe("Permission list obtained after user or Guard object verification"),
 }).describe("Permission object's permission record");
 export const TableItem_DemandPresenterSchema = ObjectBaseSchema.extend({
     address: z.string().describe("Referrer ID"),
     recommend: z.string().describe("Recommendation letter"),
-    service: z.union([z.string(), z.null()]).describe("Recommended service object ID"),
-    update_time: z.number().describe("Last update time"),
-    acceptance_score: z.union([z.number(), z.null()]).describe("Demand object feedback score"),
+    service: tolerantStringNullable.describe("Recommended service object ID"),
+    update_time: tolerantNumber.describe("Last update time"),
+    acceptance_score: tolerantNumberNullable.describe("Demand object feedback score"),
     feedback: z.string().describe("Demand object feedback information"),
-    feedback_time: z.number().describe("Demand object feedback time"),
+    feedback_time: tolerantNumber.describe("Demand object feedback time"),
 }).describe("Demand object's Service recommendation record");
 export const MachineForwardGuardSchema = z.object({
     guard: z.string().describe("Guard object ID"),
-    retained_submission: z.array(z.number()).optional().describe("Data submitted by user during Guard object verification"),
+    retained_submission: z.array(tolerantNumber).nullable().optional().describe("Data submitted by user during Guard object verification"),
 }).strict().describe("Record of Guard object in MachineForwardGuard object");
 export const MachineForwardSchema = z.object({
     name: z.string().describe("Forward name"),
-    namedOperator: z.string().optional().describe("Forward operation permission 1: Namespace (one of the two must be specified); recommended if Progress object operators are different (e.g., different delivery personnel for different orders)."),
-    permissionIndex: PermissionIndexTypeSchema.optional().describe("Forward operation permission 2: Permission index (one of the two must be specified); recommended if all Progress object operators are the same (e.g., same reward reviewers for all orders)."),
-    weight: z.number().int().min(0).max(65535).describe("Forward weight"),
-    guard: MachineForwardGuardSchema.optional().describe("Guard object ID, if defined, Guard verification must also pass to complete Forward (e.g., completed promised supply chain sub-order)."),
+    namedOperator: tolerantStringNullable.describe("Forward operation permission 1: Namespace (one of the two must be specified); recommended if Progress object operators are different (e.g., different delivery personnel for different orders)."),
+    permissionIndex: tolerantNumberNullable.describe("Forward operation permission 2: Permission index (one of the two must be specified); recommended if all Progress object operators are the same (e.g., same reward reviewers for all orders)."),
+    weight: tolerantNumber.describe("Forward weight"),
+    guard: MachineForwardGuardSchema.nullable().optional().describe("Guard object ID, if defined, Guard verification must also pass to complete Forward (e.g., completed promised supply chain sub-order)."),
 }).strict().describe("Forward in Machine object");
 export const MachineNodePairSchema = z.object({
     prev_node: z.string().describe("Previous node name"),
-    threshold: z.number().int().min(0).max(4294967295).describe("Threshold to trigger node advancement. If total Forward weight is greater than or equal to threshold, node advancement is triggered."),
+    threshold: tolerantNumber.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({
@@ -857,20 +860,20 @@ export const TableItem_MachineNodeSchema = ObjectBaseSchema.extend({
     value: z.array(MachineNodePairSchema).describe("Node pair list"),
 }).describe("Node record in Machine object");
 export const TableItem_ProgressHistorySchema = ObjectBaseSchema.extend({
-    index: z.number().int().describe("Progress record index (starting from 0)"),
+    index: tolerantNumber.describe("Progress record index (starting from 0)"),
     node: z.string().describe("Previous node name"),
     next_node: z.string().describe("Next node name"),
     session: z.array(ProgressSessionSchema).describe("Progress session list"),
-    time: z.number().describe("Progress record completion time (Unix timestamp)"),
+    time: tolerantNumberNullable.describe("Progress record completion time (Unix timestamp)"),
 }).describe("Completed progress record in Progress object");
 export const TableItem_TreasuryHistorySchema = ObjectBaseSchema.extend({
     payment: NameOrAddressSchema.describe("Payment object ID"),
     op: TreasuryOpSchema.describe("Operation type"),
     signer: z.string().describe("Operator ID"),
-    external_guard: z.union([z.string(), z.null()]).describe("Guard object ID verified during operation (none if operated through Permission)"),
+    external_guard: tolerantStringNullable.describe("Guard object ID verified during operation (none if operated through Permission)"),
     amount: BalanceTypeSchema.describe("Payment amount"),
-    time: z.number().describe("Payment time (Unix timestamp)"),
-    store_from_id: z.union([z.string(), z.null()]).describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
+    time: tolerantNumber.describe("Payment time (Unix timestamp)"),
+    store_from_id: tolerantStringNullable.describe("Stored value from Guard table. This stores the value (address or number converted to address, including submitted values) from the Guard table at the specified index for Guard verification purposes."),
 }).describe("Payment record in Treasury object");
 export const ObjectsQuerySchema = QueryEnvSchema.extend({
     objects: z.array(NameOrAddressSchema).describe("List of object IDs to query"),
@@ -1032,7 +1035,7 @@ export const OnchainEventsInputSchema = z.object({
     order: z.union([z.literal("ascending"), z.literal("descending"), z.null()]).optional().describe("Sort order for results: 'ascending' (oldest first) or 'descending' (newest first). Use null for default order"),
     no_cache: z.boolean().optional().describe("Whether to bypass cache and fetch fresh data from the blockchain"),
     network: EntrypointSchema.optional().describe("Network to query: 'mainnet' or 'testnet'. Uses default network if not specified"),
-}).describe("Input parameters for querying on-chain WOWOK events");
+}).strict().describe("Input parameters for querying on-chain WOWOK events");
 export const OnchainEventsResultSchema = z.object({
     result: z.union([EventAnswerSchema, z.null()]).describe("Event query result containing list of events and pagination info, or null if no data found"),
     semantic: SemanticSummarySchema.optional().describe("Business semantic summary for the event query"),
@@ -1200,24 +1203,24 @@ export const BridgeTokenInfoSchema = z.object({
 export const ProtocolInfoQuerySchema = z.discriminatedUnion('info', [
     z.object({
         info: z.literal('constants')
-    }).describe('Constants query'),
+    }).strict().describe('Constants query'),
     z.object({
         info: z.literal('built-in permissions'),
         filter: z.optional(PermissionFilterSchema).describe('Filter for built-in permissions')
-    }).describe('Built-in permissions query'),
+    }).strict().describe('Built-in permissions query'),
     z.object({
         info: z.literal('guard instructions'),
         filter: z.optional(GuardInstructFilterOptionsSchema).describe('Filter for guard instructions')
-    }).describe('Guard instructions and wowok object queries'),
+    }).strict().describe('Guard instructions and wowok object queries'),
     z.object({
         info: z.literal('current network')
-    }).describe('Current network entrypoint'),
+    }).strict().describe('Current network entrypoint'),
     z.object({
         info: z.literal('value types')
-    }).describe('Value types query - returns all supported value types with their numeric and string representations'),
+    }).strict().describe('Value types query - returns all supported value types with their numeric and string representations'),
     z.object({
         info: z.literal('mainnet bridge tokens')
-    }).describe('Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description')
+    }).strict().describe('Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description')
 ]).describe('WoWok Build-in infomation query');
 export const BuiltinPermissionSchema = z.object({
     result: z.array(PermissionInfoTypeSchema).describe('Built-in permissions result')

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

@@ -0,0 +1,33 @@
+import { z } from "zod";
+export declare const SchemaQueryInputSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "get", "get_output", "search", "list_operations"]>;
+    name: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "get" | "search" | "list" | "get_output" | "list_operations";
+    name?: string | undefined;
+    query?: string | undefined;
+}, {
+    action: "get" | "search" | "list" | "get_output" | "list_operations";
+    name?: string | undefined;
+    query?: string | undefined;
+}>;
+export declare const SchemaQueryOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    action: z.ZodString;
+    data: z.ZodAny;
+    message: z.ZodString;
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    success: boolean;
+    action: string;
+    data?: any;
+    suggestions?: string[] | undefined;
+}, {
+    message: string;
+    success: boolean;
+    action: string;
+    data?: any;
+    suggestions?: string[] | undefined;
+}>;

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

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export const SchemaQueryInputSchema = z
+    .object({
+    action: z
+        .enum([
+        "list",
+        "get",
+        "get_output",
+        "search",
+        "list_operations",
+    ])
+        .describe("Action to perform: 'list' to see all available schemas, 'get' to retrieve a specific input schema, 'get_output' to retrieve a tool's output schema, 'search' to find schemas by keyword, 'list_operations' to list all on-chain operations"),
+    name: z
+        .string()
+        .optional()
+        .describe("Schema/tool name for 'get'/'get_output' action (e.g., 'onchain_operations', 'account_operation', 'onchain_operations_permission')"),
+    query: z
+        .string()
+        .optional()
+        .describe("Search query for 'search' action"),
+})
+    .strict();
+export const SchemaQueryOutputSchema = z
+    .object({
+    success: z.boolean().describe("Whether the request was successful"),
+    action: z.string().describe("The action that was performed"),
+    data: z
+        .any()
+        .describe("Response data - JSON Schema object for 'get'/'get_output', array of schema info for 'list'/'search'/'list_operations'"),
+    message: z.string().describe("Human-readable message describing the result"),
+    suggestions: z
+        .array(z.string())
+        .optional()
+        .describe("Suggested next steps or alternatives"),
+})
+    .strict();

package/dist/schema/schema-version.d.ts

@@ -0,0 +1,25 @@
+export declare const MCP_SCHEMA_VERSION = "1.0.0";
+export interface SchemaVersions {
+    sdk: string;
+    mcp: string;
+}
+export declare function getSchemaVersions(): SchemaVersions;
+export type SchemaCompatibilityMode = "warn" | "strict";
+export interface SchemaCheckOptions {
+    mode?: SchemaCompatibilityMode;
+}
+export interface SchemaCheckResult {
+    compatible: boolean;
+    warnings: string[];
+    errors: string[];
+    versions: SchemaVersions;
+    client_version?: string;
+}
+export declare function checkClientSchemaCompatibility(clientSchemaVersion: string | undefined, options?: SchemaCheckOptions): SchemaCheckResult;
+export declare function attachSchemaWarning<T extends {
+    result?: unknown;
+    message?: string;
+    semantic?: {
+        warnings?: string[];
+    };
+}>(output: T, schemaCheck: SchemaCheckResult): T;

package/dist/schema/schema-version.js

@@ -0,0 +1,76 @@
+import * as wowok from "@wowok/wowok";
+const SDK_SCHEMA_VERSION = wowok.SCHEMA_VERSION ?? "1.0.0";
+const checkSchemaCompatibility = wowok
+    .checkSchemaCompatibility ??
+    ((_client, _server) => ({ compatible: true }));
+export const MCP_SCHEMA_VERSION = "1.0.0";
+export function getSchemaVersions() {
+    return {
+        sdk: SDK_SCHEMA_VERSION,
+        mcp: MCP_SCHEMA_VERSION,
+    };
+}
+export function checkClientSchemaCompatibility(clientSchemaVersion, options = {}) {
+    const versions = getSchemaVersions();
+    const result = {
+        compatible: true,
+        warnings: [],
+        errors: [],
+        versions,
+        client_version: clientSchemaVersion,
+    };
+    if (!clientSchemaVersion) {
+        return result;
+    }
+    const sdkCheck = checkSchemaCompatibility(clientSchemaVersion, versions.sdk);
+    if (!sdkCheck.compatible) {
+        result.compatible = false;
+        const message = `SDK schema incompatibility: ${sdkCheck.reason}`;
+        if (options.mode === "strict") {
+            result.errors.push(message);
+        }
+        else {
+            result.warnings.push(message);
+        }
+    }
+    const mcpCheck = checkSchemaCompatibility(clientSchemaVersion, versions.mcp);
+    if (!mcpCheck.compatible) {
+        result.compatible = false;
+        const message = `MCP schema incompatibility: ${mcpCheck.reason}`;
+        if (options.mode === "strict") {
+            result.errors.push(message);
+        }
+        else {
+            result.warnings.push(message);
+        }
+    }
+    return result;
+}
+export function attachSchemaWarning(output, schemaCheck) {
+    if (schemaCheck.warnings.length === 0 && schemaCheck.errors.length === 0) {
+        return output;
+    }
+    const warnings = [];
+    if (schemaCheck.warnings.length > 0) {
+        warnings.push(...schemaCheck.warnings);
+    }
+    if (schemaCheck.errors.length > 0) {
+        warnings.push(...schemaCheck.errors);
+    }
+    const semantic = output.semantic
+        ? {
+            ...output.semantic,
+            warnings: [...(output.semantic.warnings || []), ...warnings],
+        }
+        : undefined;
+    return {
+        ...output,
+        semantic,
+        schema_warning: {
+            compatible: schemaCheck.compatible,
+            warnings,
+            client_version: schemaCheck.client_version,
+            server_versions: schemaCheck.versions,
+        },
+    };
+}