picoclaw/pkg/bus/types.go

package bus

// Peer identifies the routing peer for a message (direct, group, channel, etc.)
type Peer struct {
	Kind string `json:"kind"` // "direct" | "group" | "channel" | ""
	ID   string `json:"id"`
}

type InboundMessage struct {
	Channel    string            `json:"channel"`
	SenderID   string            `json:"sender_id"`
	ChatID     string            `json:"chat_id"`
	Content    string            `json:"content"`
	Media      []string          `json:"media,omitempty"`
	Peer       Peer              `json:"peer"`                  // routing peer
	MessageID  string            `json:"message_id,omitempty"`  // platform message ID
	MediaScope string            `json:"media_scope,omitempty"` // media lifecycle scope
	SessionKey string            `json:"session_key"`
	Metadata   map[string]string `json:"metadata,omitempty"`
}

type OutboundMessage struct {
	Channel string `json:"channel"`
	ChatID  string `json:"chat_id"`
	Content string `json:"content"`
}

type MessageHandler func(InboundMessage) error
* First commit 2026-02-04 11:06:13 +00:00			`package bus`

refactor(bus,channels): promote peer and messageID from metadata to structured fields Add bus.Peer struct and explicit Peer/MessageID fields to InboundMessage, replacing the implicit peer_kind/peer_id/message_id metadata convention. - Add Peer{Kind, ID} type to pkg/bus/types.go - Extend InboundMessage with Peer and MessageID fields - Change BaseChannel.HandleMessage signature to accept peer and messageID - Adapt all 12 channel implementations to pass structured peer/messageID - Simplify agent extractPeer() to read msg.Peer directly - extractParentPeer unchanged (parent_peer still via metadata) 2026-02-22 13:57:12 +00:00			`// Peer identifies the routing peer for a message (direct, group, channel, etc.)`
			`type Peer struct {`
			Kind string `json:"kind"` // "direct" \| "group" \| "channel" \| ""
			ID string `json:"id"`
			`}`

* First commit 2026-02-04 11:06:13 +00:00			`type InboundMessage struct {`
			Channel string `json:"channel"`
			SenderID string `json:"sender_id"`
			ChatID string `json:"chat_id"`
			Content string `json:"content"`
			Media []string `json:"media,omitempty"`
refactor(media): add MediaStore for unified media file lifecycle management Channels previously deleted downloaded media files via defer os.Remove, racing with the async Agent consumer. Introduce MediaStore to decouple file ownership: channels register files on download, Agent releases them after processing via ReleaseAll(scope). - New pkg/media with MediaStore interface + FileMediaStore implementation - InboundMessage gains MediaScope field for lifecycle tracking - BaseChannel gains SetMediaStore/GetMediaStore + BuildMediaScope helper - Manager injects MediaStore into channels; AgentLoop releases on completion - Telegram, Discord, Slack, OneBot, LINE channels migrated from defer os.Remove to store.Store() with media:// refs 2026-02-22 15:27:55 +00:00			Peer Peer `json:"peer"` // routing peer
			MessageID string `json:"message_id,omitempty"` // platform message ID
			MediaScope string `json:"media_scope,omitempty"` // media lifecycle scope
* First commit 2026-02-04 11:06:13 +00:00			SessionKey string `json:"session_key"`
			Metadata map[string]string `json:"metadata,omitempty"`
			`}`

			`type OutboundMessage struct {`
			Channel string `json:"channel"`
			ChatID string `json:"chat_id"`
			Content string `json:"content"`
			`}`

			`type MessageHandler func(InboundMessage) error`