tmrland-personal-demo

TMR Land personal agent for an AI business marketplace. Use when: (1) searching for AI/data businesses, (2) publishing purchase intentions, (3) placing and managing escrow orders, (4) evaluating business credit scores, (5) browsing Grand Apparatus predictions.

TMR Land — Personal Skill

Connect your agent to TMR Land, a bilingual (zh/en) AI business marketplace. As a personal user you search businesses, publish Intentions, place escrow orders, and evaluate business quality via credit scoring.

Setup

Set TMR_API_KEY — create one via POST /api/v1/api-keys with role: "personal".

Optionally set TMR_BASE_URL (default: https://tmrland.com/api/v1).

Scripts

bash

# Search active businesses
node {baseDir}/scripts/search-businesses.mjs --limit 10

# Create an intention (structured need)
node {baseDir}/scripts/create-intention.mjs --content "Need a fine-tuned Chinese NLP model for sentiment analysis" [--locale zh]

# List your intentions
node {baseDir}/scripts/list-intentions.mjs [--limit N]

# Get intention details
node {baseDir}/scripts/get-intention.mjs <intention-id>

# Publish a draft intention
node {baseDir}/scripts/publish-intention.mjs <intention-id>

# Cancel an intention
node {baseDir}/scripts/cancel-intention.mjs <intention-id>

# One-shot search (create + profile + match + return results)
node {baseDir}/scripts/quick-search.mjs --content "Need an NLP model for sentiment analysis"

# Trigger multi-path matching (rules + BM25 + vector + RRF fusion)
node {baseDir}/scripts/trigger-match.mjs <intention-id>

# Check matching status (pending/running/completed/failed)
node {baseDir}/scripts/match-status.mjs <intention-id>

# Get matched business candidates
node {baseDir}/scripts/get-matches.mjs <intention-id>

# Start negotiations with matched businesses
node {baseDir}/scripts/start-negotiation.mjs --intention <id> --businesses <id1,id2,...>

# List your negotiation sessions
node {baseDir}/scripts/list-negotiations.mjs [--intention <id>]

# View/send messages in a negotiation
node {baseDir}/scripts/negotiation-messages.mjs <session-id> [--send "message text"]

# Accept a final_deal proposal (creates order)
node {baseDir}/scripts/accept-deal.mjs <session-id>

# Reject a proposal
node {baseDir}/scripts/reject-deal.mjs <session-id>

# Cancel a negotiation session
node {baseDir}/scripts/cancel-negotiation.mjs <session-id>

# Check order status
node {baseDir}/scripts/order-status.mjs <order-id>

# List all your orders
node {baseDir}/scripts/list-orders.mjs [--limit N]

# Cancel an order (before payment)
node {baseDir}/scripts/cancel-order.mjs <order-id>

# Pay for an order (escrow)
node {baseDir}/scripts/pay-order.mjs <order-id> [--currency USD|USDC]

# View order messages
node {baseDir}/scripts/get-messages.mjs <order-id>

# Send a message in an order
node {baseDir}/scripts/send-message.mjs <order-id> --content "message text"

# Accept delivery (releases escrow, moves to pending_rating)
node {baseDir}/scripts/accept-delivery.mjs <order-id>

# Request revision (sends order back to business for rework)
node {baseDir}/scripts/request-revision.mjs <order-id> --feedback "Please fix..."

# Submit a review
node {baseDir}/scripts/submit-review.mjs --order <id> --rating <1-5> [--comment "..."]

# Check wallet balances
node {baseDir}/scripts/get-wallet.mjs

# Get a specific business profile
node {baseDir}/scripts/get-business.mjs <business-id>

# Get a business's A2A agent card
node {baseDir}/scripts/get-agent-card.mjs <business-id>

# Update a draft intention
node {baseDir}/scripts/update-intention.mjs <intention-id> [--title "..."] [--description "..."]

# Delete an intention
node {baseDir}/scripts/delete-intention.mjs <intention-id>

# Re-describe intention and re-match
node {baseDir}/scripts/redescribe-intention.mjs <intention-id> --content "..." [--locale zh]

# Get negotiation session details
node {baseDir}/scripts/get-negotiation.mjs <session-id>

# Mark negotiation messages as read
node {baseDir}/scripts/mark-negotiation-read.mjs <session-id>

# Withdraw a proposal
node {baseDir}/scripts/withdraw-proposal.mjs <session-id>

# Request revision on a delivery
node {baseDir}/scripts/request-revision.mjs <order-id> --feedback "Please fix..."

# Get order receipt
node {baseDir}/scripts/get-receipt.mjs <order-id>

# Open a dispute on an order
node {baseDir}/scripts/create-dispute.mjs <order-id> --reason "..." [--refund-type full|partial] [--refund-amount N]

# Charge wallet (add funds)
node {baseDir}/scripts/charge-wallet.mjs --amount 100 [--currency USD]

# Withdraw from wallet
node {baseDir}/scripts/withdraw-wallet.mjs --amount 50 [--currency USD]

# List wallet transactions
node {baseDir}/scripts/list-transactions.mjs [--limit N]

# Submit KYC verification
node {baseDir}/scripts/submit-kyc.mjs --name "..." --id-type passport --id-number "..."

# List order message conversations
node {baseDir}/scripts/list-conversations.mjs [--limit N]

# Mark order messages as read
node {baseDir}/scripts/mark-messages-read.mjs <order-id>

# List notifications
node {baseDir}/scripts/list-notifications.mjs

# Mark a notification as read
node {baseDir}/scripts/mark-notification-read.mjs <notification-id>

# Mark all notifications as read
node {baseDir}/scripts/mark-all-read.mjs

# Get reviews for a business
node {baseDir}/scripts/get-reviews.mjs <business-id>

# Get reputation scores for a business
node {baseDir}/scripts/get-reputation.mjs <business-id>

# Get review leaderboard
node {baseDir}/scripts/get-leaderboard.mjs

# List Grand Apparatus questions
node {baseDir}/scripts/list-questions.mjs [--limit N]

# Vote on a Grand Apparatus answer
node {baseDir}/scripts/vote-answer.mjs <answer-id> --direction like|dislike

# Get credit summary for a business
node {baseDir}/scripts/get-credit.mjs <business-id>

# Get credit profile (agent-friendly vector data)
node {baseDir}/scripts/get-credit-profile.mjs <business-id>

# Get credit review dimension details
node {baseDir}/scripts/get-credit-reviews.mjs <business-id>

# Get credit dispute dimension details
node {baseDir}/scripts/get-credit-disputes.mjs <business-id>

# List contracts
node {baseDir}/scripts/list-contracts.mjs [--limit N]

# Get KYC verification status
node {baseDir}/scripts/get-kyc.mjs

# Get unread notification count
node {baseDir}/scripts/unread-count.mjs

# Get reviews for a specific order
node {baseDir}/scripts/get-order-reviews.mjs <order-id>

# Get a specific contract
node {baseDir}/scripts/get-contract.mjs <contract-id>

# Get question answer leaderboard
node {baseDir}/scripts/get-question-leaderboard.mjs <question-id>

# List disputes
node {baseDir}/scripts/list-disputes.mjs [--limit N]

Personal Workflow

1. Register & fund — Create account, complete KYC, charge wallet
2. Publish intention — Describe your need via --content
3. Match — Trigger multi-path business matching
4. Review candidates — Check match scores, reputation, credit profiles, Apparatus track records
5. Negotiate — Start negotiation sessions with candidate businesses, exchange messages, review proposals
6. Accept deal — Accept a final_deal proposal, which creates a contract and order
7. Pay — Debits funds from your wallet for escrow (USD or USDC)
8. Communicate — Message the business via order chat
9. Accept delivery — Review deliverables, accept (releases escrow) or request revision
10. Review — Rate the business during the pending_rating window

Agent Behavioral Guide

Parameter Autonomy Levels

Three levels define how the agent handles each parameter:

• AUTO — Agent can infer directly without asking (IDs, locale, pagination).
• CONFIRM — Agent may draft a value but MUST show it to the user for approval before submitting.
• ASK — Agent MUST ask the user directly. Never guess or generate.

Operation	Parameter	Level	Notes
create_intention	content	CONFIRM	Agent may draft from conversation context; show draft before submitting
create_intention	locale	AUTO	Detect from content language (zh/en)
quick_search	content	CONFIRM	Same as create_intention content
publish_intention	intention_id	AUTO	Use ID from previous create step
update_intention	title, description	CONFIRM	Agent may suggest edits
redescribe_intention	content	CONFIRM	Agent may draft; warn about side effects first
redescribe_intention	locale	AUTO	Detect from content language
delete_intention	intention_id	ASK	Must confirm deletion intent
trigger_matching	intention_id	AUTO	Use ID from current workflow
start_negotiations	business_ids	ASK	Present match candidates; user selects
send_negotiation_message	content	CONFIRM	Agent may draft; user confirms
accept_deal	session_id	ASK	Must explain consequences and confirm
reject_deal	session_id	ASK	Must confirm rejection
cancel_negotiation	session_id	ASK	Must confirm cancellation
pay_order	currency	ASK	Must ask USD or USDC
pay_order	order_id	AUTO	Use ID from deal acceptance
send_message	content	CONFIRM	Agent may draft; user confirms
accept_delivery	order_id	ASK	Must explain escrow release and confirm
submit_review	rating	ASK	Never generate a rating
submit_review	comment	CONFIRM	Agent may suggest; user confirms
cancel_order	order_id	ASK	Must confirm cancellation
cancel_intention	intention_id	ASK	Must confirm cancellation

Destructive Operations

These operations have significant side effects. The agent MUST warn the user and obtain explicit confirmation before calling.

Operation	Side Effects	Required Confirmation
accept_delivery	⚠️ IRREVERSIBLE. Releases escrowed funds to business. Moves order to pending_rating. Cannot be undone except via dispute.	"Are you sure you want to accept delivery and release [amount] [currency] to [business]?"
accept_deal	⚠️ IRREVERSIBLE. Creates a binding contract and order. Cancels ALL other active negotiations for this intention.	"Accepting creates an order for [amount] with [business] and cancels all other negotiations. Proceed?"
pay_order	Debits funds from wallet for escrow. Funds held until delivery confirmation or dispute resolution.	"This will debit [amount] [currency] from your wallet. Pay with USD or USDC?"
redescribe_intention	⚠️ DESTRUCTIVE. Cancels all active negotiations. Replaces content and triggers re-matching. Previous negotiation history lost.	"This will cancel all current negotiations and start fresh. All negotiation progress will be lost. Continue?"
delete_intention	⚠️ DESTRUCTIVE. Permanently deletes intention and all associated data.	"This will permanently delete this intention. This cannot be undone. Confirm?"
cancel_order	Cancels order before payment. No financial impact.	"Cancel this order?"
cancel_negotiation	Ends negotiation session. History preserved but no further interaction.	"Cancel negotiation with [business]?"
reject_deal	Rejects proposal. Negotiation remains active for revised proposals.	"Reject this proposal? The business can send a revised offer."
cancel_intention	Cancels intention. Associated negotiations may be affected.	"Cancel this intention?"

State Machine Reference

Intention Lifecycle

text

draft → published → matching → matched → negotiating → contracted
  ↓         ↓                      ↓           ↓
cancelled cancelled              cancelled   gated → expired

Status	Allowed Operations
draft	update_intention, publish_intention, delete_intention, cancel_intention
published	trigger_matching, redescribe_intention, cancel_intention
matching	(wait for completion — poll via get_match_status)
matched	get_matches, start_negotiations, redescribe_intention, cancel_intention
negotiating	send_negotiation_message, accept_deal, reject_deal, cancel_negotiation, redescribe_intention
contracted	(order created — manage via order tools)
gated	(awaiting platform review)
cancelled	delete_intention
expired	delete_intention

Order Lifecycle

text

pending_payment → delivering → pending_review → pending_rating → completed
       ↓                           ↕ revision_requested
   cancelled                    disputed
                                   ↓
                                refunded

Status	Allowed Operations (Personal)
pending_payment	pay_order, cancel_order
delivering	send_message, (wait for delivery)
pending_review	accept_delivery, request_revision, dispute, send_message
revision_requested	send_message, (wait for business resubmission)
pending_rating	submit_review
completed	(terminal)
disputed	get_dispute_votes (view Congress results)
cancelled	(terminal)
refunded	(terminal)

Negotiation Lifecycle

text

active → contracted (creates contract + order)
  ↓  ↑
  ↓  rejected (stays active, can re-propose)
  ↓
cancelled (terminal)
closed (terminal — order completed or cancelled)

Status	Allowed Operations (Personal)
active	send_negotiation_message, accept_deal, reject_deal, cancel_negotiation
contracted	(order created — use order tools)
rejected	(terminal for that proposal; session may remain active)
cancelled	(terminal)
closed	(terminal)

Async Flow Patterns

Standard Matching Flow

text

create_intention(content) → publish_intention(id)
  → trigger_matching(id)
  → poll get_match_status(id) until 'completed'
  → get_matches(id) → present candidates to user
  → start_negotiations(id, user_selected_ids)

Quick Search Shortcut

text

quick_search(content) → returns matches directly (synchronous)

Combines create + profile + match in one call. Use when user wants fast results without managing the intention lifecycle.

Negotiation → Order Flow

text

(in active negotiation)
  → business sends proposal (send_proposal with status='final_deal')
  → user reviews proposal
  → accept_deal(session_id) → creates contract + order
  → pay_order(order_id, currency)
  → (wait for delivery)
  → accept_delivery(order_id) → releases escrow, moves to pending_rating
  → submit_review(order_id, rating)

API Overview

Auth: Authorization: Bearer <TMR_API_KEY>. All paths prefixed with /api/v1. UUIDs for all IDs. Bilingual fields use _zh/_en suffixes. Pagination via offset+limit.

Key domains: auth, wallet, intentions, businesses, orders, contracts, credit, reviews, disputes, messages, notifications, apparatus.

See references/ for detailed request/response schemas per domain.

Error Summary

Status	Meaning
400	Bad request — validation failed
401	Unauthorized — invalid or missing token
403	Forbidden — insufficient role/permissions
404	Not found
409	Conflict — duplicate or invalid state transition
422	Unprocessable entity — schema validation error
500	Internal server error