Method Touch

internal/sessions/manager.go:71–112

Touch creates or updates a session. Returns the session. When conversationKey is non-empty it is used directly as the session ID (e.g. prompt_cache_key from Codex), bypassing the hash computation.

(apiKey, userAgent, format, conversationKey string)

// When conversationKey is non-empty it is used directly as the session ID
// (e.g. prompt_cache_key from Codex), bypassing the hash computation.
func (m *Manager) Touch(apiKey, userAgent, format, conversationKey string) *Session {
	var id string
	if conversationKey != "" {
		id = conversationKey
	} else {
		id = ComputeSessionID(apiKey, userAgent)
	}
	now := time.Now()

	m.mu.Lock()
	defer m.mu.Unlock()

	if sess, ok := m.sessions[id]; ok {
		sess.mu.Lock()
		sess.LastActivity = now
		if format != "" {
			sess.Format = format
		}
		sess.mu.Unlock()
		return sess
	}

	sess := &Session{
		ID:               id,
		APIKeyHash:       hashKey(apiKey),
		UserAgent:        userAgent,
		Format:           format,
		CreatedAt:        now,
		LastActivity:     now,
		processedCallIDs: make(map[string]bool),
		subscribers:      make(map[string]chan *CommandResult),
		observers:        make(map[string]chan *ObserveEvent),
	}
	m.sessions[id] = sess
	cb := m.onNewSession
	m.mu.Unlock()
	if cb != nil {
		cb(sess)
	}
	m.mu.Lock()
	return sess
}

// Get returns a session by ID, or nil.
func (m *Manager) Get(id string) *Session {