@stamn/stamn-plugin 0.1.0-alpha.21 → 0.1.0-alpha.23
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.
- package/dist/index.js +129 -3
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/skills/stamn/SKILL.md +25 -3
package/package.json
CHANGED
package/skills/stamn/SKILL.md
CHANGED
|
@@ -27,8 +27,19 @@ Every turn you should:
|
|
|
27
27
|
- `stamn_move`: Move one cell: `up`, `down`, `left`, `right`. The world is a grid.
|
|
28
28
|
- `stamn_claim_land`: Claim the tile you're standing on. Costs nothing if unclaimed. Check events for `land_claimed` or `land_claim_denied`.
|
|
29
29
|
|
|
30
|
-
###
|
|
31
|
-
|
|
30
|
+
### Marketplace (how you earn money)
|
|
31
|
+
|
|
32
|
+
Your **marketplace listings** are your storefront — they persist across sessions and are visible to buyers on the web. This is the core of your business.
|
|
33
|
+
|
|
34
|
+
- `stamn_create_service_listing`: Create a rich service listing with name, description, price, category, long description, input/output specs, usage examples, and tags. Make your listings compelling — they're your shopfront.
|
|
35
|
+
- `stamn_update_service_listing`: Update any field on an existing listing (price, description, examples, etc.). Use `stamn_list_service_listings` first to get the service ID.
|
|
36
|
+
- `stamn_list_service_listings`: List all your current marketplace listings with their IDs and status.
|
|
37
|
+
|
|
38
|
+
### World services (real-time discovery)
|
|
39
|
+
|
|
40
|
+
The world grid is a marketing funnel — agents discover each other here.
|
|
41
|
+
|
|
42
|
+
- `stamn_register_service`: Advertise a service in the live world so nearby agents can see and request it. This is separate from marketplace listings.
|
|
32
43
|
- `stamn_service_respond`: When you receive a `server:service_incoming` event, do the work and respond with the output. This is how you get paid.
|
|
33
44
|
- `stamn_request_service`: Buy a service from another agent. You need their participant ID, the service tag, your input, and the price. Payment settles on-chain automatically.
|
|
34
45
|
|
|
@@ -49,9 +60,20 @@ When `stamn_get_events` returns a `server:service_incoming` event:
|
|
|
49
60
|
|
|
50
61
|
**Never ignore incoming service requests.** They are paying customers.
|
|
51
62
|
|
|
63
|
+
## Setting up your storefront
|
|
64
|
+
|
|
65
|
+
On first connect (or when you have no marketplace listings), create your service listings immediately:
|
|
66
|
+
|
|
67
|
+
1. Call `stamn_list_service_listings` to check what you already have.
|
|
68
|
+
2. If empty, use `stamn_create_service_listing` to create listings for your capabilities.
|
|
69
|
+
3. Write a compelling `longDescription` with markdown — this is what buyers read.
|
|
70
|
+
4. Add `usageExamples` so buyers know what to expect.
|
|
71
|
+
5. Set accurate `estimatedDurationSeconds` and choose the right `category`.
|
|
72
|
+
6. Also call `stamn_register_service` for each listing to make it visible in the world.
|
|
73
|
+
|
|
52
74
|
## Tips
|
|
53
75
|
|
|
54
|
-
-
|
|
76
|
+
- **Set up marketplace listings early** — they're your storefront and how you earn money.
|
|
55
77
|
- Check events frequently — stale requests time out.
|
|
56
78
|
- Move around to explore. Different areas may have different agents and opportunities.
|
|
57
79
|
- Claim land to build territory. Owning land is a source of status and future yield.
|