feat: add set_reminder tool for scheduling inbox notifications

New set_reminder tool lets the agent schedule reminders that fire via
inbox.Append() after a specified delay (Go duration syntax: 30m, 1h, etc.).

- internal/tools/reminder.go: SetReminderTool implementation using time.AfterFunc
- internal/tools/tool.go: add NewSetReminderTool() to Defaults()
- internal/web/chat.go: add set_reminder to system prompt, mightNeedTools
  keywords (remind/timer/alarm/提醒/定时), and shouldRetryWithTools list

Previously the agent refused reminder requests because no scheduling tool
existed; now it can call set_reminder directly.

Author: clawplaza

internal/tools/reminder.go

@@ -0,0 +1,78 @@
+package tools
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"strings"
+	"time"
+
+	"github.com/clawplaza/clawwork-cli/internal/inbox"
+)
+
+// SetReminderTool schedules a one-shot reminder that fires via the inbox.
+// The reminder is in-memory: if the CLI exits before it fires it is lost.
+type setReminderTool struct{}
+
+func NewSetReminderTool() Tool { return &setReminderTool{} }
+
+func (t *setReminderTool) Def() ToolDef {
+	return ToolDef{
+		Name: "set_reminder",
+		Description: "Schedule a one-shot reminder message that will appear in your inbox after a given delay. " +
+			"Use this when the owner asks you to remind them of something in the future (e.g. \"remind me in 30 minutes to check the gig\"). " +
+			"The reminder fires inside the running CLI process; it will be lost if the CLI is stopped before the delay elapses.",
+		Parameters: ToolParameters{
+			Type: "object",
+			Properties: map[string]ToolProperty{
+				"message": {
+					Type:        "string",
+					Description: "The reminder text to deliver (what to remind the owner about).",
+				},
+				"delay": {
+					Type: "string",
+					Description: "How long to wait before firing. Uses Go duration syntax: " +
+						"e.g. \"30m\" (30 minutes), \"1h\" (1 hour), \"2h30m\", \"90s\". Max 24h.",
+				},
+			},
+			Required: []string{"message", "delay"},
+		},
+	}
+}
+
+func (t *setReminderTool) Call(_ context.Context, argsJSON string) string {
+	var args struct {
+		Message string `json:"message"`
+		Delay   string `json:"delay"`
+	}
+	if err := json.Unmarshal([]byte(argsJSON), &args); err != nil {
+		return "error: invalid arguments: " + err.Error()
+	}
+	args.Message = strings.TrimSpace(args.Message)
+	args.Delay = strings.TrimSpace(args.Delay)
+	if args.Message == "" {
+		return "error: message is required"
+	}
+	if args.Delay == "" {
+		return "error: delay is required"
+	}
+
+	d, err := time.ParseDuration(args.Delay)
+	if err != nil {
+		return fmt.Sprintf("error: invalid delay %q — use Go duration syntax like \"30m\", \"1h\", \"2h30m\": %s", args.Delay, err)
+	}
+	if d <= 0 {
+		return "error: delay must be positive"
+	}
+	if d > 24*time.Hour {
+		return "error: delay cannot exceed 24h"
+	}
+
+	msg := args.Message
+	time.AfterFunc(d, func() {
+		_ = inbox.Append("⏰ Reminder", msg, inbox.TagSystem)
+	})
+
+	fireAt := time.Now().Add(d).Format("15:04:05")
+	return fmt.Sprintf("Reminder set. Will appear in your inbox at %s (in %s).", fireAt, args.Delay)
+}

internal/tools/tool.go

@@ -65,9 +65,10 @@ type ChatToolProvider interface {
 // Defaults returns the base built-in tools (no market client).
 func Defaults() []Tool {
 	return []Tool{
-		NewShellExecTool(),  // shell: curl/wget/git/grep/jq/etc.
-		NewHTTPFetchTool(),  // native HTTP GET/POST (no shell required)
-		NewRunScriptTool(),  // execute Python or JavaScript
-		NewFilesystemTool(), // read/write/list/mkdir/move/delete/info
+		NewShellExecTool(),    // shell: curl/wget/git/grep/jq/etc.
+		NewHTTPFetchTool(),    // native HTTP GET/POST (no shell required)
+		NewRunScriptTool(),    // execute Python or JavaScript
+		NewFilesystemTool(),   // read/write/list/mkdir/move/delete/info
+		NewSetReminderTool(),  // schedule a reminder that fires via inbox
 	}
 }

internal/web/chat.go

@@ -639,6 +639,9 @@ func cleanReply(reply string) string {
 // mightNeedTools returns true if the message likely requires a tool call.
 // Simple conversational messages skip the agentic path to save ~300 tokens.
 var toolKeywords = []string{
+	// reminders / scheduling
+	"remind", "reminder", "timer", "alarm", "schedule", "notify", "alert", "in 30", "in 1h", "in an hour",
+	"提醒", "定时", "闹钟", "计时", "通知",
 	// market IDs, URLs, and intent
 	"gig_", "sk_", "/gig/", "/skill/", "clawplaza.ai/gig", "clawplaza.ai/skill",
 	"localhost:5173/gig", "localhost:5173/skill",
@@ -697,7 +700,7 @@ func shouldRetryWithTools(_ string, reply string) bool {
 		"social_dm_send", "social_messages_list", "social_messages_read", "social_moments_read",
 		"social_like_moment", "social_connections",
 		"cw_balance", "cw_transfer", "cw_history",
-		"report_issue",
+		"report_issue", "set_reminder",
 	}
 	for _, t := range toolMentions {
 		if strings.Contains(lower, t) {
@@ -804,7 +807,8 @@ func ChatSystemPrompt(soul string) string {
 	sb.WriteString("- cw_balance: Check your CW balance (both activated and unactivated), staked amount, and transfer allowance.\n")
 	sb.WriteString("- cw_transfer: Transfer CW to another agent (requires owner-granted allowance).\n")
 	sb.WriteString("- cw_history: View your CW transaction history.\n")
-	sb.WriteString("- report_issue: Submit a bug report, question, or suggestion to the platform.\n\n")
+	sb.WriteString("- report_issue: Submit a bug report, question, or suggestion to the platform.\n")
+	sb.WriteString("- set_reminder: Schedule a one-shot reminder that fires in your inbox after a delay (e.g. \"30m\", \"1h\"). Use when the owner asks to be reminded about something later.\n\n")
 	sb.WriteString("Always use these tools directly. Never ask the owner to perform platform actions manually.\n")
 	sb.WriteString("IMPORTANT: Your API key is already embedded in this CLI process and injected automatically into every tool call.\n")
 	sb.WriteString("You MUST NEVER ask the owner for an API key, credentials, or tokens — you already have them. Just call the tool.\n\n")