Draft a Signo agent (Notify or Prepare) for the owner to claim
signo_draft_agentDraft a complete inactive Notify or Prepare agent, without an API key. Name the owner wallet when you know it; omit it and the first wallet to sign on the review page owns the agent. It can watch anything the app can: a price threshold or percent move, portfolio movement, a lending health factor (Aave, Spark, Compound V3, Morpho), the owner's own DeFi positions (PTs, LPs, supplied assets, claimables, APY or value changes, days to expiry), Pendle loops, a daily market brief, a recurring schedule (daily, weekly or monthly at a set time, or hourly checks) or any plain-English condition the compiler accepts. Execute is a separate permission flow with its own supported conditions and typed on-chain triggers; Execute is not available for the app's Portfolio move trigger, boxed Pendle PT loops are notify-only, and recurring schedules are not Execute triggers today. Returns a private review_url plus summary, cadence (hourly or daily checks), autonomy, action and expires_at in unix milliseconds. The owner opens the link, connects that wallet, links Telegram and signs once to create the agent. Set autonomy to prepare for an action request; otherwise it is refused as autonomy_mismatch, not silently downgraded. Prepare builds an unsigned plan on each fire; it never spends automatically. No clarification round trip: an ambiguous or unwatchable request is a 422 with the reason, so rephrase and call again. Keyless has no agent-status read yet: the owner sees fires on the Agents page and on Telegram. Automatic execution is the separate signo_draft_permission tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet | No | Optional. The owner's EVM (0x…) or Solana address, when you know it: then only that wallet can claim the draft. Omit it and the draft is bound to the first wallet that signs on the review page. | |
| request | Yes | The complete condition or recurring schedule in plain English, 8 to 2000 characters, and for Prepare the action to run when it fires. There is no clarification round trip: an ambiguous or unwatchable request is a 422 with the reason, so rephrase and call again. | |
| autonomy | No | notify (default): the owner is told when it fires. prepare: the action in the request is stored and pre-planned on fire as an unsigned plan for the owner to sign. A request that includes an action must explicitly choose prepare; otherwise it is refused as autonomy_mismatch, not silently downgraded. Execute is not available here; it needs a Shield mandate. | notify |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | For a Prepare agent, the step it prepares when it fires. | |
| status | Yes | "draft" for an inactive agent draft, "proposed" for a stored Execute permission proposal. | |
| wallet | No | The owner wallet, or null when the first wallet to sign claims it. | |
| cadence | No | How often the condition is checked. | |
| summary | No | The trigger (and action) in plain English. | |
| autonomy | No | "notify" or "prepare". | |
| activation | No | What the owner must do before anything runs. | |
| expires_at | No | When the draft or proposal expires, in ms since epoch. | |
| review_url | Yes | Private link for the wallet owner: review, connect the wallet, and sign once to turn it on. | |
| proposal_id | Yes | The draft's id. |