Henry
e75c8b37c8
Co-authored-by: nova28 <17953305+nova28@users.noreply.github.com> Co-authored-by: Carlos Florencio <carlosmflorencio@gmail.com>
57 lines
2.2 KiB
Go
57 lines
2.2 KiB
Go
package instance
|
|
|
|
import "github.com/kandev/kandev/internal/agentctl/types/streams"
|
|
|
|
// RetainTurnOutcome assigns a fresh turn identifier and records event as the
|
|
// named instance's new last terminal outcome (AC-EXECUTORS-SURVIVAL-004.1).
|
|
// Returns ok=false without allocating an identifier when the instance is not
|
|
// found, so a caller racing instance teardown never burns an identifier for
|
|
// an outcome nobody can retrieve.
|
|
func (m *Manager) RetainTurnOutcome(instanceID string, event streams.AgentEvent) (turnID int64, ok bool) {
|
|
inst, found := m.GetInstance(instanceID)
|
|
if !found {
|
|
return 0, false
|
|
}
|
|
turnID = m.turnIDSeq.Add(1)
|
|
inst.turnOutcome.Retain(turnID, event)
|
|
return turnID, true
|
|
}
|
|
|
|
// PeekTurnOutcome returns the named instance's retained outcome without
|
|
// discarding it (AC-EXECUTORS-SURVIVAL-004.6). instanceFound distinguishes
|
|
// "no such instance" from "instance exists, nothing retained" so the HTTP
|
|
// handler can 404 only on the former.
|
|
func (m *Manager) PeekTurnOutcome(instanceID string) (outcome TurnOutcome, hasOutcome, instanceFound bool) {
|
|
inst, found := m.GetInstance(instanceID)
|
|
if !found {
|
|
return TurnOutcome{}, false, false
|
|
}
|
|
outcome, hasOutcome = inst.turnOutcome.Peek()
|
|
return outcome, hasOutcome, true
|
|
}
|
|
|
|
// AckTurnOutcome discards the named instance's retained outcome only if
|
|
// turnID names the one currently retained. Naming any other identifier --
|
|
// including one for an instance that no longer exists -- is accepted and
|
|
// changes nothing (AC-EXECUTORS-SURVIVAL-004.6), so a retried acknowledgement
|
|
// is always safe to call again.
|
|
func (m *Manager) AckTurnOutcome(instanceID string, turnID int64) {
|
|
inst, found := m.GetInstance(instanceID)
|
|
if !found {
|
|
return
|
|
}
|
|
inst.turnOutcome.Ack(turnID)
|
|
}
|
|
|
|
// ClearTurnOutcome retires the prior terminal outcome before a new prompt is
|
|
// accepted. The prompt generation floor prevents a terminal event from an
|
|
// older turn, still waiting in the process manager's output path, from
|
|
// repopulating the slot after it was cleared.
|
|
func (m *Manager) ClearTurnOutcome(instanceID string, promptGeneration uint64) {
|
|
inst, found := m.GetInstance(instanceID)
|
|
if !found {
|
|
return
|
|
}
|
|
inst.turnOutcome.Clear(promptGeneration)
|
|
}
|