X-Git-Url: https://git.giacomolli.uk/onechat/blobdiff_plain/7b6d0a81e0f3c8e33b1b76d5ecbc5bdb25a87249..d9fddc0f506eb4ead7049f5638674b2b8773fcaa:/turn.go diff --git a/turn.go b/turn.go index 1593f43..40645b1 100644 --- a/turn.go +++ b/turn.go @@ -2,21 +2,19 @@ package main import ( "context" - "encoding/json" "errors" "fmt" + "log" "path/filepath" - "strings" "sync" "time" ) -// errTurnLogWrite marks an error of a log write, which ends the loop. -var errTurnLogWrite = errors.New("log write failed") - -// newTurnLoop returns the loop of agent with its memory. Its calls go through -// client, and notify gets each event. The clock gives the date of a turn. -func newTurnLoop(agent *Agent, memory *Memory, client TurnClient, clock func() time.Time, notify func(Event)) (*TurnLoop, error) { +// newTurnLoop returns the loop of agent with its memory, its subagents, and the +// WhatsApp link and the schedules of its tools. Its calls go through client, +// and notify gets each event. The clock gives the date of a turn. logger gets +// the failed turns and the ends of the subagents. +func newTurnLoop(agent *Agent, memory *Memory, subagents *Subagents, whatsapp *WhatsApp, schedules *Schedules, client ChainClient, clock func() time.Time, logger *log.Logger, notify func(Event)) (*TurnLoop, error) { layout, err := loadViewLayout(filepath.Join(agent.dir, viewLayoutFileName)) if err != nil { return nil, err @@ -28,65 +26,80 @@ func newTurnLoop(agent *Agent, memory *Memory, client TurnClient, clock func() t client: client, layout: layout, clock: clock, + logger: logger, notify: notify, wake: make(chan struct{}, 1), } - l.tools = &toolbox{ - log: l, - chat: memory, - workdir: agent.config.Workdir, + l.runs = &SubagentRuns{ + agent: agent, + memory: memory, + subagents: subagents, + layout: layout, + client: client, + state: l.state, + report: l.Report, + note: l.note, + fail: l.fail, + logger: logger, + notify: notify, + running: make(map[string]*SubagentRun), } - return l, nil -} + l.tools = &Toolbox{ + log: l, + chat: memory, + subagents: subagents, + runs: l.runs, + whatsapp: whatsapp, + schedules: schedules, + workdir: agent.config.Workdir, + } -// TurnClient sends model calls. -type TurnClient interface { - Create(ctx context.Context, request ModelRequest) (ModelResponse, error) + return l, nil } // Event tells the clients what the agent does as it happens. Kind is the kind -// of a logged message (user, reply, tool, echo), or one of ready, busy, idle, -// and error. ID is the ID of a logged message. Source names the client that -// sent a user message, such as terminal or telegram, so that each client can -// show the messages of the others. +// of a logged message (user, reply, tool, echo, note, work), or one of ready, +// busy, idle, error, and subagent, which tells that the subagent Text starts a +// run. ID is the ID of a logged message. Source names the client that sent a +// user message, such as terminal or telegram, so that each client can show the +// messages of the others, or the subagent of a report. Status tells how the run +// of a report ended: finished, stopped, or failed. type Event struct { Kind string `json:"kind"` ID int `json:"id,omitempty"` Text string `json:"text,omitempty"` Source string `json:"source,omitempty"` + Status string `json:"status,omitempty"` } // TurnLoop runs the turns of one agent. A user message goes to the log when it // comes, and it wakes the loop. A turn waits until every message before it is -// summarized. Then its first request holds the prompt, the tools, and the input -// of turnInput. The loop runs the tool calls of each response and sends their -// results back, until a response has no tool call: the final answer. +// summarized. Then the turn runs a Chain whose first request holds the prompt, +// the tools, and the input of turnInput. // // The view goes out as the messages of a ViewLayout, so the first request of a -// turn reads the view of the turn before from the prompt cache. -// -// Each later request of a turn begins with the whole input of the request -// before it, then its output items, then the tool results. The output items -// hold the reasoning with its encrypted content, because the calls do not -// store it. So each request begins with all of the previous one and reads it -// from the prompt cache. User messages that come during a turn join the next -// request after the tool results. The replies, the tool calls, and the results -// go to the log as they happen. The thoughts never do. +// turn reads the view of the turn before from the prompt cache. User messages +// that come during a turn join the next request of its chain after the tool +// results, and so do the reports of the subagents. The subagents run until the +// loop ends. type TurnLoop struct { agent *Agent memory *Memory - client TurnClient - tools *toolbox + client ChainClient + tools *Toolbox + runs *SubagentRuns layout *ViewLayout clock func() time.Time + logger *log.Logger notify func(Event) wake chan struct{} mutex sync.Mutex pending []Message cancel context.CancelFunc + failure error } // Submit logs a user message from the client source and wakes the loop. The @@ -110,6 +123,65 @@ func (l *TurnLoop) Submit(source, text string) (Message, error) { return message, nil } +// Report logs the report text of the subagent name as a work message and tells +// the clients, with the status of the run. Unless the subagent was stopped, the +// report joins the waiting messages and wakes the loop, as a user message of +// Submit does. A failed write stops the loop, because the log refuses all +// writes after it. +func (l *TurnLoop) Report(name, text, status string) { + message, err := l.Work(name, text, status) + switch { + case err != nil: + l.fail(fmt.Errorf("%w: %w", errChainLogWrite, err)) + case status != subagentStopped: + l.Wake(message) + } +} + +// Work logs text as a work message of source, such as the name of a subagent, +// and tells the clients, with status. The message starts no turn until it goes +// to Wake. +func (l *TurnLoop) Work(source, text, status string) (Message, error) { + message, err := l.memory.Append("work", text) + if err != nil { + return Message{}, err + } + + l.notify(Event{ + Kind: "work", + ID: message.ID, + Text: text, + Source: source, + Status: status, + }) + + return message, nil +} + +// Wake adds the logged messages to the waiting messages and wakes the loop +// once, as a user message of Submit does. They join the first request of a new +// turn together, or the next request of a running turn after the tool results. +func (l *TurnLoop) Wake(messages ...Message) { + if len(messages) == 0 { + return + } + + l.mutex.Lock() + l.pending = append(l.pending, messages...) + l.mutex.Unlock() + + select { + case l.wake <- struct{}{}: + default: + } +} + +// StopSubagent ends the run of the subagent name and tells if it ran. Its +// report is logged, but it starts no turn. +func (l *TurnLoop) StopSubagent(name string) (bool, error) { + return l.runs.Stop(name) +} + // Interrupt ends the running turn. A running tool is killed, and the turn sends // no further request. func (l *TurnLoop) Interrupt() bool { @@ -144,9 +216,18 @@ func (l *TurnLoop) Flush(ctx context.Context) error { return l.memory.Flush(ctx) } -// Run runs a turn each time user messages wait, until ctx ends. It returns the -// error of a failed log write, which stops the agent. +// Run runs a turn each time user messages or reports wait, until ctx ends. It +// returns the error of a failed log write, which stops the agent. At its start +// it resumes the subagents that a stop of the daemon cut, and at its end it +// ends the runs of the subagents and waits for them. func (l *TurnLoop) Run(ctx context.Context) error { + defer l.runs.Close() + + err := l.runs.Resume(ctx) + if err != nil { + return fmt.Errorf("resume subagents: %w", err) + } + for { for l.waiting() { err := l.turn(ctx) @@ -160,9 +241,21 @@ func (l *TurnLoop) Run(ctx context.Context) error { case <-ctx.Done(): return ctx.Err() } + + err := l.failed() + if err != nil { + return err + } } } +// note logs a note and tells the clients. A note starts no turn. +func (l *TurnLoop) note(text string) error { + _, err := l.record("note", "", text) + + return err +} + // record logs a message and tells the clients, with the client source of a user // message. func (l *TurnLoop) record(kind, source, text string) (Message, error) { @@ -181,7 +274,7 @@ func (l *TurnLoop) record(kind, source, text string) (Message, error) { return message, nil } -// waiting tells if user messages wait for a request. +// waiting tells if user messages or reports wait for a request. func (l *TurnLoop) waiting() bool { l.mutex.Lock() defer l.mutex.Unlock() @@ -189,10 +282,32 @@ func (l *TurnLoop) waiting() bool { return len(l.pending) > 0 } +// fail stops the loop with err. +func (l *TurnLoop) fail(err error) { + l.mutex.Lock() + l.failure = errors.Join(l.failure, err) + l.mutex.Unlock() + + select { + case l.wake <- struct{}{}: + default: + } +} + +// failed returns the error of a failed write of a report. +func (l *TurnLoop) failed() error { + l.mutex.Lock() + defer l.mutex.Unlock() + + return l.failure +} + // turn runs one turn. A failed or interrupted model call ends the turn and -// tells the clients. The messages of the turn stay in the log and the view, and -// the next turn starts only with a new message, so a lasting failure such as a -// needed login does not repeat. Only a failed log write is an error of turn. +// tells the clients. A failure also goes to the logger, so that it is not lost +// when no client is connected, but an interrupt does not. The messages of the +// turn stay in the log and the view, and the next turn starts only with a new +// message, so a lasting failure such as a needed login does not repeat. Only a +// failed log write is an error of turn. func (l *TurnLoop) turn(ctx context.Context) error { ctx, cancel := context.WithCancel(ctx) defer cancel() @@ -212,7 +327,11 @@ func (l *TurnLoop) turn(ctx context.Context) error { }) err := l.chain(ctx) - if err != nil && !errors.Is(err, errTurnLogWrite) { + if err != nil && !errors.Is(err, errChainLogWrite) { + if ctx.Err() == nil { + l.logger.Printf("turn failed: %v", err) + } + l.notify(Event{ Kind: "error", Text: turnError(ctx, err), @@ -255,29 +374,21 @@ func (l *TurnLoop) chain(ctx context.Context) error { return err } - input := turnInput(view, l.state(), messages) - for turn := "first"; ; turn = "next" { - response, err := l.client.Create(ctx, ModelRequest{ + chain := &Chain{ + client: l.client, + tools: l.tools, + request: ModelRequest{ Model: l.agent.config.Model, Effort: l.agent.config.Effort, Instructions: instructions, - Tools: agentTools(), - Input: input, - Turn: turn, - }) - if err != nil { - return err - } + Tools: promptTools(), + }, + take: l.take, + } - input, err = l.handle(ctx, input, response) - if err != nil { - return err - } + _, err = chain.Run(ctx, turnInput(view, l.state(), messages)) - if len(input) == 0 { - return nil - } - } + return err } // take returns the user messages that wait for a request, and removes them. @@ -297,83 +408,6 @@ func (l *TurnLoop) state() string { return "\n\nNow: " + l.clock().Format("Monday 2006-01-02 15:04 -07:00") } -// handle logs the replies of response and runs its tool calls. It returns the -// input of the next request: input, the output items, the tool results, and -// the user messages that came in the meantime. After the final answer it -// returns no input. -func (l *TurnLoop) handle(ctx context.Context, input []any, response ModelResponse) ([]any, error) { - var outputs []any - for _, raw := range response.Output { - item, err := turnInputItem(raw) - if err != nil { - return nil, err - } - - input = append(input, item) - - var call TurnFunctionCall - err = json.Unmarshal(raw, &call) - if err != nil { - return nil, fmt.Errorf("decode output item: %w", err) - } - - switch call.Type { - case "message": - text, err := modelOutputText([]json.RawMessage{raw}) - if err != nil { - return nil, err - } - - text = strings.TrimSpace(text) - if text == "" { - continue - } - - _, err = l.Append("reply", text) - if err != nil { - return nil, fmt.Errorf("%w: %w", errTurnLogWrite, err) - } - case "function_call": - output, err := l.tools.Call(ctx, call.Name, call.Arguments) - if err != nil { - return nil, fmt.Errorf("%w: %w", errTurnLogWrite, err) - } - - outputs = append(outputs, TurnFunctionCallOutput{ - Type: "function_call_output", - CallID: call.CallID, - Output: output, - }) - } - } - - if len(outputs) == 0 { - return nil, nil - } - - input = append(input, outputs...) - for _, message := range l.take() { - input = append(input, modelUserMessage(message.Text)) - } - - return input, nil -} - -// TurnFunctionCall holds the fields of a function call output item. -type TurnFunctionCall struct { - Type string `json:"type"` - Name string `json:"name"` - Arguments string `json:"arguments"` - CallID string `json:"call_id"` -} - -// TurnFunctionCallOutput is the input item with the result of a function call. -type TurnFunctionCallOutput struct { - Type string `json:"type"` - CallID string `json:"call_id"` - Output string `json:"output"` -} - // turnError returns the text of the error that ended a turn. func turnError(ctx context.Context, err error) string { if ctx.Err() != nil { @@ -400,18 +434,3 @@ func turnInput(view []string, state string, messages []Message) []any { return input } - -// turnInputItem returns an output item as an input item for the next request. -// The calls do not store their items, so the item goes back whole, without its -// id. -func turnInputItem(raw json.RawMessage) (map[string]any, error) { - var item map[string]any - err := json.Unmarshal(raw, &item) - if err != nil { - return nil, fmt.Errorf("decode output item: %w", err) - } - - delete(item, "id") - - return item, nil -}