52 lines
2.2 KiB
Go
52 lines
2.2 KiB
Go
// This file provides the cli-layer helper that runs the SessionStart hook event
|
|
// (US-010, FR-1) synchronously at the run-start seam. It lives in the cli layer
|
|
// alongside the other hook assembly (hooks_install.go) because it bridges the
|
|
// resolved Dispatcher and the runtime.RunConfig, which runtime itself must not
|
|
// know about.
|
|
//
|
|
// SessionStart is dispatched SYNCHRONOUSLY at run start rather than through the
|
|
// async OnEvent notifier: an async dispatch could land after the first turn's
|
|
// request is built, so its additionalContext would miss the first turn (SPEC
|
|
// §11.2). Dispatching inline before the loop starts guarantees the injected
|
|
// context is present for the very first turn.
|
|
//
|
|
// Only injection is supported (there is nothing to block at session start): any
|
|
// additionalContext is registered as a ONE-SHOT reminder on cfg.Reminders so the
|
|
// text is injected into the first turn's provider context via the existing
|
|
// TransformContext seam, then never again. It is not written to the persisted
|
|
// message history (the reminder mechanism is ephemeral by construction).
|
|
package run
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/smallnest/pigo/internal/hooks"
|
|
"github.com/smallnest/pigo/internal/runtime"
|
|
)
|
|
|
|
// DispatchSessionStart runs the SessionStart event once at run start. source is
|
|
// "startup" for a fresh run or "resume" when continuing an existing session; it
|
|
// is carried in the HookInput so hooks can differentiate. Any additionalContext
|
|
// returned by the hook is registered as a one-shot reminder on cfg.Reminders
|
|
// (allocating a registry when cfg.Reminders is nil) so it is injected into the
|
|
// first turn only.
|
|
//
|
|
// A nil dispatcher (no hooks configured) is a no-op.
|
|
func DispatchSessionStart(ctx context.Context, d *hooks.Dispatcher, cfg *runtime.RunConfig, deps HookDeps, source string) {
|
|
if d == nil {
|
|
return
|
|
}
|
|
dec := d.Dispatch(ctx, "SessionStart", "", hooks.HookInput{
|
|
EventType: "SessionStart",
|
|
SessionID: deps.SessionID,
|
|
ProjectDir: deps.ProjectDir,
|
|
Source: source,
|
|
})
|
|
if dec.AdditionalContext != "" && cfg != nil {
|
|
if cfg.Reminders == nil {
|
|
cfg.Reminders = runtime.NewReminderRegistry()
|
|
}
|
|
cfg.Reminders.Register(runtime.NewOneShotReminder("session-start", dec.AdditionalContext))
|
|
}
|
|
}
|