@wowok/agent-mcp 2.6.8 → 2.7.0

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

@@ -180,15 +180,15 @@ export declare const CallPayment_CreateSchema: z.ZodObject<{
 export declare const CallPayment_ReceiveSchema: z.ZodObject<{
     object: z.ZodEffects<z.ZodString, string, string>;
     receive: z.ZodLiteral<true>;
-    type_parameter: z.ZodString;
+    type_parameter: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     object: string;
-    type_parameter: string;
     receive: true;
+    type_parameter?: string | undefined;
 }, {
     object: string;
-    type_parameter: string;
     receive: true;
+    type_parameter?: string | undefined;
 }>;
 export declare const CallPayment_DataSchema: z.ZodUnion<[z.ZodObject<{
     object: z.ZodObject<{
@@ -325,15 +325,15 @@ export declare const CallPayment_DataSchema: z.ZodUnion<[z.ZodObject<{
 }>, z.ZodObject<{
     object: z.ZodEffects<z.ZodString, string, string>;
     receive: z.ZodLiteral<true>;
-    type_parameter: z.ZodString;
+    type_parameter: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     object: string;
-    type_parameter: string;
     receive: true;
+    type_parameter?: string | undefined;
 }, {
     object: string;
-    type_parameter: string;
     receive: true;
+    type_parameter?: string | undefined;
 }>]>;
 export declare const CallPayment_InputSchema: z.ZodObject<{
     data: z.ZodUnion<[z.ZodObject<{
@@ -471,15 +471,15 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
     }>, z.ZodObject<{
         object: z.ZodEffects<z.ZodString, string, string>;
         receive: z.ZodLiteral<true>;
-        type_parameter: z.ZodString;
+        type_parameter: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         object: string;
-        type_parameter: string;
         receive: true;
+        type_parameter?: string | undefined;
     }, {
         object: string;
-        type_parameter: string;
         receive: true;
+        type_parameter?: string | undefined;
     }>]>;
     env: z.ZodOptional<z.ZodObject<{
         account: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>>;
@@ -546,8 +546,8 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
         }[];
     } | {
         object: string;
-        type_parameter: string;
         receive: true;
+        type_parameter?: string | undefined;
     };
     env?: {
         account: string;
@@ -590,8 +590,8 @@ export declare const CallPayment_InputSchema: z.ZodObject<{
         }[];
     } | {
         object: string;
-        type_parameter: string;
         receive: true;
+        type_parameter?: string | undefined;
     };
     env?: {
         no_cache?: boolean | undefined;

package/dist/schema/call/payment.js

@@ -19,15 +19,17 @@ export const CallPayment_ReceiveSchema = z.object({
         "but they are NOT spendable coins. This mode unwraps a CoinWrapper into actual coins in your wallet " +
         "via payment::unwrap_to_myself. The caller must be the CoinWrapper's owner (the recipient " +
         "specified in the Allocation's revenue split)."),
-    type_parameter: z.string().describe("Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. " +
-        "Must match the type used when the Allocation created the Payment."),
+    type_parameter: z.string().optional().describe("Coin type of the CoinWrapper, e.g. '0x2::wow::WOW'. " +
+        "OPTIONAL: when omitted it is auto-derived from the CoinWrapper's own on-chain type " +
+        "(the inner T of `CoinWrapper<T>`), so {object, receive:true} alone unwraps to spendable coins. " +
+        "Only provide it explicitly when auto-derivation fails."),
 }).strict().describe("Receive mode: unwrap a CoinWrapper to the caller's wallet. Use after Allocation's alloc_by_guard creates a Payment with your address as a revenue recipient. The CoinWrapper holds your share — call this to convert it to actual coins in your wallet.");
 export const CallPayment_DataSchema = z.union([
     CallPayment_CreateSchema,
     CallPayment_ReceiveSchema,
 ]).describe("On-chain Payment operations. TWO modes:\n" +
     "(1) CREATE: Set 'object' with {name, type_parameter, ...}, 'revenue', and 'info' to create a new Payment.\n" +
-    "(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true, type_parameter: '0x2::wow::WOW'} to unwrap a CoinWrapper to your wallet.\n" +
+    "(2) RECEIVE: Set {object: '<coinwrapper_id_or_name>', receive: true} to unwrap a CoinWrapper to your wallet (type_parameter optional — auto-derived from the CoinWrapper's type).\n" +
     "The 'object' field is CRITICAL and REQUIRED in both modes. STRING for receive (CoinWrapper ID/name), OBJECT for create.");
 export const CallPayment_InputSchema = z.object({
     data: CallPayment_DataSchema,

package/dist/schema/call/semantic.js

@@ -1133,7 +1133,15 @@ function buildCustomerAdvice(operation_type, data, safeResult) {
     const hasArbitration = booleanFromSignals(data?.arb_name !== undefined || data?.arbitration !== undefined, data?.arb === false);
     const hasCompensation = booleanFromSignals(data?.compensation_fund !== undefined || data?.compensation !== undefined, false);
     const hasRefundPath = booleanFromSignals(data?.refund !== undefined, false);
-    const hasMessenger = booleanFromSignals(data?.um_name !== undefined || data?.messenger !== undefined, false);
+    const hasMessenger = booleanFromSignals(data?.um !== undefined ||
+        data?.um_name !== undefined ||
+        data?.messenger !== undefined ||
+        safeResult?.um !== undefined, data?.um === null || data?.um_name === null);
+    const customerRequired = Array.isArray(data?.customer_required)
+        ? data.customer_required.filter((x) => typeof x === "string")
+        : Array.isArray(safeResult?.customer_required)
+            ? safeResult.customer_required.filter((x) => typeof x === "string")
+            : [];
     const noArbitration = hasArbitration === false;
     const noCompensation = hasCompensation === false;
     const riskScore = typeof data?.risk_score === "number" ? data.risk_score
@@ -1166,6 +1174,7 @@ function buildCustomerAdvice(operation_type, data, safeResult) {
         has_compensation: hasCompensation,
         has_refund_path: hasRefundPath,
         has_messenger: hasMessenger,
+        customer_required: customerRequired,
         risk_score: riskScore,
         risk_level: riskLevel,
         user_min_trust_score: userMinTrust,

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

@@ -1464,6 +1464,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     } | {
         coin: string;
     } | undefined;
+    customer_required?: string[] | undefined;
     um?: string | null | undefined;
     owner_receive?: {
         received: {
@@ -1487,7 +1488,6 @@ export declare const CallService_DataSchema: z.ZodObject<{
     } | {
         op: "clear";
     } | undefined;
-    customer_required?: string[] | undefined;
     location?: string | undefined;
     compensation_fund_withdraw?: {
         payment_info: {
@@ -1652,6 +1652,7 @@ export declare const CallService_DataSchema: z.ZodObject<{
     } | {
         coin: string;
     } | undefined;
+    customer_required?: string[] | undefined;
     um?: string | null | undefined;
     owner_receive?: {
         received: {
@@ -1667,7 +1668,6 @@ export declare const CallService_DataSchema: z.ZodObject<{
         content_raw?: any;
     }[] | undefined;
     repositories?: unknown;
-    customer_required?: string[] | undefined;
     location?: string | undefined;
     compensation_fund_withdraw?: {
         payment_info: {
@@ -2717,6 +2717,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
+        customer_required?: string[] | undefined;
         um?: string | null | undefined;
         owner_receive?: {
             received: {
@@ -2740,7 +2741,6 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_withdraw?: {
             payment_info: {
@@ -2905,6 +2905,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
+        customer_required?: string[] | undefined;
         um?: string | null | undefined;
         owner_receive?: {
             received: {
@@ -2920,7 +2921,6 @@ export declare const CallService_InputSchema: z.ZodObject<{
             content_raw?: any;
         }[] | undefined;
         repositories?: unknown;
-        customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_withdraw?: {
             payment_info: {
@@ -3320,6 +3320,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
+        customer_required?: string[] | undefined;
         um?: string | null | undefined;
         owner_receive?: {
             received: {
@@ -3343,7 +3344,6 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             op: "clear";
         } | undefined;
-        customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_withdraw?: {
             payment_info: {
@@ -3550,6 +3550,7 @@ export declare const CallService_InputSchema: z.ZodObject<{
         } | {
             coin: string;
         } | undefined;
+        customer_required?: string[] | undefined;
         um?: string | null | undefined;
         owner_receive?: {
             received: {
@@ -3565,7 +3566,6 @@ export declare const CallService_InputSchema: z.ZodObject<{
             content_raw?: any;
         }[] | undefined;
         repositories?: unknown;
-        customer_required?: string[] | undefined;
         location?: string | undefined;
         compensation_fund_withdraw?: {
             payment_info: {

package/dist/schema/call/service.js

@@ -31,7 +31,11 @@ export const DiscountSchema = z.object({
 export const OrderNewSchema = z.object({
     buy: BuySchema,
     agents: ManyAccountOrMark_AddressSchema.optional().describe("Order agents. Agents can operate the order, such as canceling the order, modifying the order status, etc.; but cannot receive the funds received by the order."),
-    order_required_info: z.string().optional().describe("Contact object ID or WTS Proof object"),
+    order_required_info: z.string().optional().describe("Contact object ID or WTS Proof object, recorded on the Order as proof that the order holder " +
+        "delivered the required private information (service.customer_required) to the merchant. " +
+        "FLOW: when a Service declares customer_required (e.g. phone/email/shipping_address), the order holder " +
+        "MUST send that private information to the Service's Contact (um) via end-to-end encrypted Messenger, " +
+        "then pass the Contact object ID or the generated WTS Proof here so the delivery is verifiable on-chain."),
     transfer: AccountOrMark_AddressSchema.optional().describe("Set the new owner of the order. Requires order owner permission to set."),
     namedNewOrder: NamedObjectSchema.optional().describe("RECOMMENDED: Set a local name for the newly created Order object. " +
         "Without this, the Order is only referenceable by its on-chain address. " +
@@ -84,7 +88,10 @@ export const CallService_DataSchema = z.object({
     machine: z.union([NameOrAddressSchema, z.null()]).optional().describe("Service Machine object ID or name. The Machine object must be in published state."),
     discount: DiscountSchema.optional().describe("Issue discount."),
     discount_destroy: z.array(NameOrAddressSchema).optional().describe("Destroy existing discount object ID list."),
-    customer_required: z.array(NotEmptyNameSchema).optional().describe("Customer required information. Such as phone, email, etc."),
+    customer_required: z.array(NotEmptyNameSchema).optional().describe("Customer required information labels. Such as phone, email, shipping_address, etc. " +
+        "⚠️ HARD LINKAGE (SDK-enforced): if customer_required is set (non-empty), the Service MUST also bind a " +
+        "Contact via `um` — otherwise the customer's private information cannot be delivered through end-to-end " +
+        "encrypted Messenger (which routes to the Contact bound as um). Set `um` together with customer_required."),
     order_allocators: z.union([AllocatorsSchema, z.null()]).optional().describe("Order fund allocator. Max 100 allocators (MAX_ALLOCATOR_COUNT). " +
         "Each allocator has a guard (first matching guard wins) and a sharing list. " +
         "Set to null to clear. " +
@@ -125,7 +132,11 @@ export const CallService_DataSchema = z.object({
         "(all require pause + setting_lock_duration elapsed since pause)."),
     compensation_fund_receive: ReceivedBalanceOrRecentlySchema.optional().describe("Receive order compensation funds from this Service object." + RECEIVE_FORMAT_BLOCK_BALANCE),
     owner_receive: ReceivedObjectsOrRecentlySchema.optional().describe("Unwrap CoinWrapper objects and other objects received by this Service object and send them to the owner of its Permission object." + RECEIVE_FORMAT_BLOCK_OBJECTS),
-    um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name."),
+    um: z.union([NameOrAddressSchema, z.null()]).optional().describe("Contact object ID or name — the Service's customer-service channel. " +
+        "This is the object that Messenger routes encrypted messages to for pre-order negotiation, " +
+        "private-info delivery (see customer_required), and post-sale support. " +
+        "⚠️ REQUIRED whenever customer_required is set: without um, the customer's private information " +
+        "has no channel to reach the merchant."),
     pause: z.boolean().optional().describe("Whether to pause accepting new orders."),
     publish: z.boolean().optional().describe("Whether to publish the Service. After publishing, customers can place orders. " +
         "VERIFIED against Move source service.move + SDK service.ts (4-level immutability matrix):\n" +