| 1 | package agent |
| 2 | |
| 3 | import ( |
| 4 | "context" |
| 5 | "fmt" |
| 6 | |
| 7 | "reasonix/internal/event" |
| 8 | "reasonix/internal/i18n" |
| 9 | "reasonix/internal/provider" |
| 10 | ) |
| 11 | |
| 12 | // UnappliedSteerNotice returns the durable warning shown for guidance that was |
| 13 | // accepted during an abnormal turn exit but never reached a provider request. |
| 14 | // The user's guidance rides the format's trailing %s so fronts can split it |
| 15 | // back out at the first newline. |
| 16 | func UnappliedSteerNotice(text string) string { |
| 17 | return fmt.Sprintf(i18n.M.UnappliedSteerFmt, text) |
| 18 | } |
| 19 | |
| 20 | // RecordUnappliedSteer stores guidance that could not affect its intended |
| 21 | // in-flight turn. The orphan-tool sentinel makes older readers drop the record |
| 22 | // during wire normalization, while current readers use LocalOnly to exclude it |
| 23 | // before every provider request. itemID correlates the notice with the durable |
| 24 | // session inbox entry when one exists. |
| 25 | func (a *Agent) RecordUnappliedSteer(text string, itemID ...string) { |
| 26 | if a == nil || a.sess.conversation == nil { |
| 27 | return |
| 28 | } |
| 29 | id := "" |
| 30 | if len(itemID) > 0 { |
| 31 | id = itemID[0] |
| 32 | } |
| 33 | messageID := NewMessageID() |
| 34 | _ = a.appendCommittedMessages(context.Background(), "unapplied-steer", provider.Message{ |
| 35 | ID: messageID, |
| 36 | Role: provider.RoleTool, |
| 37 | Content: a.withTurnPreferences(midTurnSteerMessage(text)), |
| 38 | ToolCallID: provider.LocalOnlyToolID, |
| 39 | Name: provider.LocalOnlyToolName, |
| 40 | LocalOnly: true, |
| 41 | }) |
| 42 | a.svc.sink.Emit(event.Event{ |
| 43 | Kind: event.Notice, |
| 44 | MessageID: messageID, |
| 45 | Level: event.LevelWarn, |
| 46 | Code: event.NoticeCodeUnappliedSteer, |
| 47 | Text: UnappliedSteerNotice(text), |
| 48 | ItemID: id, |
| 49 | }) |
| 50 | } |
| 51 |