@wowok/skills 1.0.6 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/README.md +26 -30
  2. package/dist/cli.js +114 -19
  3. package/dist/cli.js.map +1 -1
  4. package/dist/index.d.ts +1 -1
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +11 -1
  7. package/dist/index.js.map +1 -1
  8. package/dist/skills.d.ts +46 -1
  9. package/dist/skills.d.ts.map +1 -1
  10. package/dist/skills.js +154 -16
  11. package/dist/skills.js.map +1 -1
  12. package/dist/types.d.ts +31 -0
  13. package/dist/types.d.ts.map +1 -1
  14. package/package.json +3 -4
  15. package/scripts/install.js +5 -3
  16. package/wowok-arbitrator/SKILL.md +279 -0
  17. package/wowok-guard/SKILL.md +166 -139
  18. package/wowok-machine/SKILL.md +215 -280
  19. package/wowok-order/SKILL.md +290 -404
  20. package/wowok-provider/SKILL.md +453 -0
  21. package/wowok-safety/SKILL.md +176 -279
  22. package/wowok-tools/SKILL.md +329 -344
  23. package/schemas/onchain_operations/_common.md +0 -236
  24. package/schemas/onchain_operations/_index.md +0 -22
  25. package/schemas/onchain_operations/allocation.md +0 -50
  26. package/schemas/onchain_operations/arbitration.md +0 -95
  27. package/schemas/onchain_operations/contact.md +0 -36
  28. package/schemas/onchain_operations/demand.md +0 -52
  29. package/schemas/onchain_operations/gen_passport.md +0 -43
  30. package/schemas/onchain_operations/guard.md +0 -136
  31. package/schemas/onchain_operations/machine.md +0 -70
  32. package/schemas/onchain_operations/order.md +0 -57
  33. package/schemas/onchain_operations/payment.md +0 -32
  34. package/schemas/onchain_operations/permission.md +0 -57
  35. package/schemas/onchain_operations/personal.md +0 -59
  36. package/schemas/onchain_operations/progress.md +0 -35
  37. package/schemas/onchain_operations/repository.md +0 -81
  38. package/schemas/onchain_operations/reward.md +0 -40
  39. package/schemas/onchain_operations/service.md +0 -104
  40. package/schemas/onchain_operations/treasury.md +0 -74
  41. package/schemas/schema-account_operation.md +0 -402
  42. package/schemas/schema-guard2file.md +0 -153
  43. package/schemas/schema-local_info_operation.md +0 -160
  44. package/schemas/schema-local_mark_operation.md +0 -148
  45. package/schemas/schema-machineNode2file.md +0 -155
  46. package/schemas/schema-messenger_operation.md +0 -547
  47. package/schemas/schema-onchain_events.md +0 -201
  48. package/schemas/schema-onchain_table_data.md +0 -334
  49. package/schemas/schema-query_toolkit.md +0 -375
  50. package/schemas/schema-wip_file.md +0 -240
  51. package/schemas/schema-wowok_buildin_info.md +0 -296
  52. package/wowok-build/SKILL.md +0 -606
@@ -1,70 +0,0 @@
1
- # onchain_operations / machine
2
-
3
- Design and deploy automated workflow templates (Machines) that define how services are delivered.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallMachine_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object: WithPermissionObject;
11
-
12
- // Generate new Progress
13
- progress_new?: {
14
- task?: string | null; // Task ID
15
- repository?: ObjectsOp; // Repository list
16
- progress_namedOperator?: { // Manage namespace operators
17
- op: "add" | "set" | "remove";
18
- name: string;
19
- operators: ManyAccountOrMark_Address;
20
- };
21
- namedNew?: NamedObject; // Name for new Progress
22
- };
23
-
24
- description?: string; // Machine description
25
- repository?: ObjectsOp; // Consensus repositories
26
-
27
- // Node operations - TWO MODES (mutually exclusive)
28
- node?:
29
- // Mode 1: Incremental operations
30
- | {
31
- op: "add" | "set";
32
- nodes: MachineNode[];
33
- bReplace?: boolean;
34
- }
35
- | { op: "remove"; nodes: string[] }
36
- | { op: "clear" }
37
- | { op: "exchange"; node_one: string; node_other: string }
38
- | { op: "rename"; node_name_old: string; node_name_new: string }
39
- | { op: "remove prior node"; pairs: NodeRemovePriorNodeData[] }
40
- | { op: "add forward"; data: NodeAddForwardData[] }
41
- | { op: "remove forward"; data: NodeRemoveForwardData[] }
42
- // Mode 2: Complete replacement from file
43
- | { json_or_markdown_file: string };
44
-
45
- pause?: boolean; // Pause new Progress
46
- publish?: boolean; // Publish (nodes immutable)
47
- owner_receive?: ReceivedObjectsOrRecently;
48
- um?: string | null; // Contact object
49
- }
50
-
51
- // MachineNode definition
52
- MachineNode {
53
- name: string; // Node name (initial is "")
54
- pairs: {
55
- prior_node: string; // Previous node ("" for entry)
56
- forwards: {
57
- name: string; // Forward name
58
- namedOperator?: string; // Per-Progress namespace
59
- permissionIndex?: number; // Shared permission index
60
- weight: number; // Forward weight
61
- guard?: string; // Optional Guard
62
- }[];
63
- threshold?: number; // Weight threshold
64
- }[];
65
- }
66
- ```
67
-
68
- ---
69
-
70
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ObjectsOp, NamedObject, ManyAccountOrMark_Address, ReceivedObjectsOrRecently.
@@ -1,57 +0,0 @@
1
- # onchain_operations / order
2
-
3
- Manage the order lifecycle, including arbitration, progress advancement, refunds, and setting agents.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallOrder_Data {
9
- object: string; // Order ID or name (required)
10
-
11
- // Manage agents
12
- agents?: ManyAccountOrMark_Address;
13
-
14
- // Set required info (Contact or WTS)
15
- required_info?: string | null;
16
-
17
- // Advance progress
18
- progress?: {
19
- operation: {
20
- next_node_name: string;
21
- forward: string;
22
- };
23
- hold?: boolean;
24
- adminUnhold?: boolean;
25
- message?: string;
26
- };
27
-
28
- // Submit compensation request
29
- arb_confirm?: {
30
- arb: string; // Arb object ID
31
- confirm: boolean; // Confirm materials valid
32
- description?: string;
33
- proposition?: string[]; // Compensation claims
34
- };
35
-
36
- // Appeal arbitration result
37
- arb_objection?: {
38
- arb: string;
39
- objection: string; // Appeal reason
40
- };
41
-
42
- // Claim compensation
43
- arb_claim_compensation?: {
44
- arb: string;
45
- };
46
-
47
- // Receive funds/objects
48
- receive?: QueryReceivedResult;
49
-
50
- // Transfer order ownership
51
- transfer_to?: AccountOrMark_Address;
52
- }
53
- ```
54
-
55
- ---
56
-
57
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, AccountOrMark_Address, ManyAccountOrMark_Address.
@@ -1,32 +0,0 @@
1
- # onchain_operations / payment
2
-
3
- Send instant, irreversible coin transfers to any wallet address.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallPayment_Data {
9
- // Object reference — create new only (Payment is immutable)
10
- object: {
11
- name?: string; // Object name
12
- tags?: string[]; // Tags
13
- onChain?: boolean; // Public on-chain name
14
- replaceExistName?: boolean; // Force claim name
15
- type_parameter?: string; // Token type (default: "0x2::wow::WOW")
16
- };
17
-
18
- revenue: { // Array of payment recipients
19
- recipient: AccountOrMark_Address; // Who receives payment
20
- amount: CoinParam; // Payment amount
21
- }[];
22
-
23
- info: { // Payment metadata
24
- remark?: string; // Payment remark
25
- index?: number; // Payment index
26
- };
27
- }
28
- ```
29
-
30
- ---
31
-
32
- See [_common.md](./_common.md) for shared types: CallEnv, CoinParam, AccountOrMark_Address.
@@ -1,57 +0,0 @@
1
- # onchain_operations / permission
2
-
3
- Define who can perform which operations on WoWok objects.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallPermission_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object?: NormalObject;
11
-
12
- description?: string; // Permission description
13
-
14
- // Permission table operations
15
- table?: {
16
- op: "add perm by index" | "set perm by index" | "remove perm by index";
17
- index: number; // Permission index
18
- entity: ManyAccountOrMark_Address;
19
- } | {
20
- op: "add perm by entity" | "set perm by entity" | "remove perm by entity";
21
- entity: AccountOrMark_Address;
22
- index: number[];
23
- };
24
-
25
- // Advanced entity operations (requires admin)
26
- entity?: {
27
- op: "swap" | "replace" | "copy";
28
- entity1: AccountOrMark_Address;
29
- entity2: AccountOrMark_Address;
30
- } | {
31
- op: "del";
32
- entity: AccountOrMark_Address;
33
- };
34
-
35
- // Admin management (builder only)
36
- admin?: {
37
- op: "add" | "remove" | "set";
38
- addresses: ManyAccountOrMark_Address;
39
- };
40
-
41
- // Remark operations
42
- remark?: {
43
- op: "set" | "remove" | "clear";
44
- index?: number;
45
- remark?: string;
46
- };
47
-
48
- apply?: string[]; // Objects to apply permission to
49
- builder?: AccountOrMark_Address; // Set/transfer ownership
50
- owner_receive?: ReceivedObjectsOrRecently;
51
- um?: string | null; // Contact object
52
- }
53
- ```
54
-
55
- ---
56
-
57
- See [_common.md](./_common.md) for shared types: CallEnv, NormalObject, AccountOrMark_Address, ManyAccountOrMark_Address, ReceivedObjectsOrRecently.
@@ -1,59 +0,0 @@
1
- # onchain_operations / personal
2
-
3
- Establish and manage your on-chain public identity. **CRITICAL: Everything here is PERMANENTLY PUBLIC on the blockchain!**
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallPersonal_Data {
9
- description?: string; // Public description
10
-
11
- referrer?: string | AccountOrMark_Address | null; // Referrer for joining network
12
-
13
- // PUBLIC on-chain personal info (discriminated union)
14
- information?: {
15
- op: "add";
16
- data: { // Records to add
17
- name: string; // Record name (social handle, URL, etc.)
18
- value_type: ValueType; // Value type
19
- value: SupportedValue; // Value
20
- }[];
21
- } | {
22
- op: "remove";
23
- name: string[]; // Record names to remove
24
- } | {
25
- op: "clear";
26
- };
27
-
28
- // PUBLIC on-chain identity mark (discriminated union)
29
- mark?: {
30
- op: "add";
31
- data: {
32
- address: string; // Address to mark
33
- name?: string; // Mark name
34
- tags?: string[]; // Tags
35
- }[];
36
- } | {
37
- op: "remove";
38
- data: {
39
- address: string;
40
- tags?: string[];
41
- }[];
42
- } | {
43
- op: "clear";
44
- address: ManyAccountOrMark_Address;
45
- } | {
46
- op: "transfer"; // Transfer mark to another address
47
- to: AccountOrMark_Address;
48
- } | {
49
- op: "replace"; // Replace with new mark object
50
- new_mark_object: string;
51
- } | {
52
- op: "destroy"; // Permanently destroy mark
53
- };
54
- }
55
- ```
56
-
57
- ---
58
-
59
- See [_common.md](./_common.md) for shared types: CallEnv, AccountOrMark_Address, ManyAccountOrMark_Address.
@@ -1,35 +0,0 @@
1
- # onchain_operations / progress
2
-
3
- Track and manage active workflows in real-time.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallProgress_Data {
9
- object: string; // Progress ID or name (required)
10
- task?: string | null; // Target task ID
11
- repository?: ObjectsOp; // Context repositories
12
-
13
- // Manage namespace operators
14
- progress_namedOperator?: {
15
- op: "add" | "set" | "remove";
16
- name: string;
17
- operators: ManyAccountOrMark_Address;
18
- };
19
-
20
- // Advance workflow
21
- operate?: {
22
- operation: {
23
- next_node_name: string; // Target node
24
- forward: string; // Forward name
25
- };
26
- hold?: boolean; // Lock permission
27
- adminUnhold?: boolean; // Allow admin unlock
28
- message?: string; // Operation note
29
- };
30
- }
31
- ```
32
-
33
- ---
34
-
35
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, ObjectsOp, ManyAccountOrMark_Address.
@@ -1,81 +0,0 @@
1
- # onchain_operations / repository
2
-
3
- Read/write database with consensus field + address as key, strongly-typed data as value.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallRepository_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object: WithPermissionObject;
11
-
12
- description?: string; // Repository description
13
-
14
- // Policy rules (discriminated by op)
15
- policies?: {
16
- op: "add" | "set";
17
- policy: PolicyRule[];
18
- } | {
19
- op: "remove";
20
- policy: string[]; // Policy names to remove
21
- } | {
22
- op: "clear";
23
- };
24
-
25
- // Add data (discriminated union)
26
- data_add?: {
27
- name: string;
28
- write_guard?: string;
29
- data: SupportedValue;
30
- } | {
31
- name: string;
32
- items: {
33
- data: {
34
- id: string | number;
35
- data: SupportedValue;
36
- }[];
37
- write_guard?: string;
38
- }[];
39
- };
40
-
41
- // Remove data (discriminated union)
42
- data_remove?: {
43
- name: string;
44
- write_guard?: string;
45
- } | {
46
- name: string;
47
- items: {
48
- id: (string | number)[];
49
- write_guard?: string;
50
- }[];
51
- };
52
-
53
- rewards?: ObjectsOp; // Reward operations
54
- owner_receive?: ReceivedObjectsOrRecently;
55
- um?: string | null; // Contact object
56
- }
57
- ```
58
-
59
- ### PolicyRule
60
-
61
- ```typescript
62
- PolicyWriteGuard {
63
- guard: string; // Guard object ID
64
- id_from_submission?: number; // Guard table index for data ID (omit = user specifies)
65
- data_from_submission?: number; // Guard table index for data value (omit = user specifies)
66
- }
67
-
68
- PolicyRule {
69
- name: string; // Policy rule name
70
- description: string; // Policy rule description
71
- write_guard: PolicyWriteGuard[]; // Guard list for write verification
72
- quote_guard?: string | null; // Guard for on-chain quote verification (null = no verification required)
73
- id_from: 0 | 1 | 2 | "None" | "Clock" | "Signer" | "none" | "clock" | "signer";
74
- // Data ID source: 0/None = user-specified, 1/Clock = timestamp, 2/Signer = signer ID
75
- value_type: ValueType; // Type of data value
76
- }
77
- ```
78
-
79
- ---
80
-
81
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, WithPermissionObject, ValueType, ObjectsOp, ReceivedObjectsOrRecently.
@@ -1,40 +0,0 @@
1
- # onchain_operations / reward
2
-
3
- Create reward pools and set claim conditions by Guard verification.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallReward_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object: TypedPermissionObject;
11
-
12
- claim?: string; // Guard object ID for claiming
13
- description?: string; // Reward description
14
- coin_add?: CoinParam; // Add funds
15
- receive?: ReceivedBalanceOrRecently; // Unwrap CoinWrapper
16
-
17
- // Add reward Guards (each specifies a claim condition)
18
- guard_add?: {
19
- guard: string; // Guard object ID to verify
20
- recipient: Recipient; // Who receives reward
21
- amount: { // Amount (discriminated union)
22
- type: "GuardU64Identifier";
23
- value: number; // Identifier 0-255 in Guard table
24
- } | {
25
- type: "Fixed";
26
- value: number; // Fixed amount
27
- };
28
- expiration_time?: number; // Expiration timestamp (ms)
29
- store_from_id?: number | null; // Guard table storage identifier
30
- }[];
31
-
32
- guard_remove_expired?: boolean; // Remove expired Guards
33
- guard_expiration_time?: number | null; // Lock adding new Guards until this time (ms)
34
- owner_receive?: ReceivedObjectsOrRecently;
35
- um?: string | null; // Contact object
36
- }
37
-
38
- ---
39
-
40
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently, Recipient.
@@ -1,104 +0,0 @@
1
- # onchain_operations / service
2
-
3
- Create and manage product/service listings with transparent promises, bind workflow templates, set pricing, issue discount coupons.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallService_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object: TypedPermissionObject;
11
-
12
- // Create new order (customer purchase)
13
- order_new?: {
14
- buy: {
15
- items: {
16
- name: string; // Product name
17
- stock: number; // Quantity
18
- wip_hash: string; // WIP file hash
19
- }[];
20
- total_pay: CoinParam; // Payment amount
21
- discount?: string; // Discount object ID
22
- payment_remark?: string;
23
- payment_index?: number;
24
- };
25
- agents?: ManyAccountOrMark_Address; // Order agents
26
- order_required_info?: string; // Contact or WTS proof
27
- transfer?: AccountOrMark_Address; // New order owner
28
- namedNewOrder?: NamedObject; // Name for new Order
29
- namedNewAllocation?: NamedObject; // Name for new Allocation
30
- namedNewProgress?: NamedObject; // Name for new Progress
31
- };
32
-
33
- description?: string; // Service description
34
- location?: string; // Service location
35
-
36
- // Sales operations (discriminated union)
37
- sales?: {
38
- op: "add" | "set";
39
- sales: { // Array of sale items (REQUIRED)
40
- name: string; // Product name
41
- price: number; // Price
42
- stock: number; // Stock quantity
43
- suspension: boolean; // Whether suspended
44
- wip: string; // WIP file URL
45
- wip_hash: string; // WIP hash
46
- }[];
47
- } | {
48
- op: "remove";
49
- sales_name: string[]; // Sale names to remove (REQUIRED)
50
- } | {
51
- op: "clear";
52
- };
53
-
54
- repositories?: ObjectsOp; // Repository operations
55
- rewards?: ObjectsOp; // Reward operations
56
- arbitrations?: ObjectsOp; // Arbitration operations
57
- machine?: string | null; // Machine object ID
58
-
59
- // Discount coupon
60
- discount?: {
61
- name: string;
62
- discount_type: 0 | 1; // 0 = RATES (percentage), 1 = FIXED (fixed amount)
63
- discount_value: number;
64
- benchmark?: number;
65
- time_ms_start?: number;
66
- time_ms_end?: number;
67
- count?: number;
68
- recipient: ManyAccountOrMark_Address;
69
- transferable?: boolean;
70
- };
71
-
72
- discount_destroy?: string[]; // Discount IDs to destroy
73
- customer_required?: string[]; // Required info (phone, email, etc.)
74
-
75
- // Order fund allocators
76
- order_allocators?: {
77
- description: string;
78
- threshold: number;
79
- allocators: {
80
- guard: string; // Guard object ID
81
- sharing: {
82
- who: Recipient; // Recipient specification
83
- sharing: number; // Amount or rate
84
- mode: "Amount" | "Rate" | "Surplus";
85
- }[];
86
- fix?: number; // Fixed amount
87
- max?: number; // Maximum amount
88
- }[];
89
- } | null;
90
-
91
- buy_guard?: string | null; // Purchase Guard
92
- compensation_fund_add?: CoinParam;
93
- setting_locked_time_add?: number;
94
- compensation_fund_receive?: ReceivedBalanceOrRecently;
95
- owner_receive?: ReceivedObjectsOrRecently;
96
- um?: string | null; // Contact object
97
- pause?: boolean; // Pause new orders
98
- publish?: boolean; // Publish service (immutable)
99
- }
100
- ```
101
-
102
- ---
103
-
104
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, ObjectsOp, CoinParam, NamedObject, AccountOrMark_Address, ManyAccountOrMark_Address, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently, Recipient.
@@ -1,74 +0,0 @@
1
- # onchain_operations / treasury
2
-
3
- Create and manage treasury for team funds with deposit/withdrawal rules.
4
-
5
- ## Data Schema
6
-
7
- ```typescript
8
- CallTreasury_Data {
9
- // Object reference - string (existing) or object (create new)
10
- object: TypedPermissionObject;
11
-
12
- description?: string; // Treasury description
13
- receive?: ReceivedBalanceOrRecently; // Receive CoinWrapper
14
-
15
- // Deposit funds
16
- deposit?: {
17
- coin: CoinParam;
18
- by_external_deposit_guard?: string;
19
- payment_info: {
20
- remark?: string;
21
- index?: number;
22
- };
23
- namedNewPayment?: NamedObject;
24
- };
25
-
26
- // Withdraw funds
27
- withdraw?: {
28
- amount: { fixed: number } | { by_external_withdraw_guard: string };
29
- recipient: AccountOrMark_Address;
30
- payment_info: {
31
- remark?: string;
32
- index?: number;
33
- };
34
- namedNewPayment?: NamedObject;
35
- };
36
-
37
- // External deposit Guards (discriminated union)
38
- external_deposit_guard?: {
39
- op: "add" | "set";
40
- guards: { // Array of Guard configs (REQUIRED for add/set)
41
- guard: string; // Guard object ID or name
42
- identifier?: number | null; // Guard table index for deposit amount limit (null = unlimited)
43
- store_from_id?: number | null; // Guard table index for record storage
44
- }[];
45
- } | {
46
- op: "remove";
47
- guards: string[]; // Guard IDs/names to remove (REQUIRED)
48
- } | {
49
- op: "clear";
50
- };
51
-
52
- // External withdraw Guards (discriminated union)
53
- external_withdraw_guard?: {
54
- op: "add" | "set";
55
- guards: { // Array of Guard configs (REQUIRED for add/set)
56
- guard: string; // Guard object ID or name
57
- identifier?: number | null; // Guard table index for withdrawal amount limit (null = unlimited)
58
- store_from_id?: number | null; // Guard table index for record storage
59
- }[];
60
- } | {
61
- op: "remove";
62
- guards: string[]; // Guard IDs/names to remove (REQUIRED)
63
- } | {
64
- op: "clear";
65
- };
66
-
67
- owner_receive?: ReceivedObjectsOrRecently;
68
- um?: string | null; // Contact object
69
- }
70
- ```
71
-
72
- ---
73
-
74
- See [_common.md](./_common.md) for shared types: CallEnv, SubmissionCall, TypedPermissionObject, CoinParam, NamedObject, AccountOrMark_Address, ReceivedBalanceOrRecently, ReceivedObjectsOrRecently.