agentfootprint/dist/types/status.d.ts

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

/**
 * status — chat-bubble status surface.
 *
 * Pattern: pure projection. `selectStatus` walks the typed
 *          event log forward, tracking active pause / tool / LLM state,
 *          and returns the CURRENT thinking state (or null when the
 *          bubble should hide).
 * Role:    Outer ring. Consumers (Lens, custom chat UIs, embedded
 *          widgets) call this to drive a "what is the agent doing
 *          right now?" indicator. Output feeds `renderStatusLine`
 *          which resolves a template + variables to a final string.
 *
 * Future home for extended-thinking primitives (Anthropic `thinking_delta` /
 * `redacted_thinking` blocks). Adding them here is non-breaking; consumers
 * already importing from `agentfootprint/observe` get the new state surface
 * for free.
 *
 * Prose lives elsewhere: the `defaultStatusTemplates` catalog's canonical home
 * is `src/locales/` (the single i18n home for all prose — commentary,
 * thinking, status). It is re-exported here for convenience. Both come out of
 * the `agentfootprint/observe` door; these are NOT on the main `agentfootprint`
 * barrel.
 *
 * State machine (4 states + null):
 *
 *      ┌──────────┐  llm.start, no tools yet
 *  ────┤  idle    ├────────────────────────────► "Thinking…"
 *      └──────────┘
 *
 *      ┌──────────┐  stream.token chunks accumulate
 *  ────┤streaming ├────────────────────────────► "{{partial}}"
 *      └──────────┘
 *
 *      ┌──────────┐  tool.start, no tool.end yet
 *  ────┤   tool   ├────────────────────────────► "Working on `weather`…"
 *      └──────────┘                               (or per-tool override)
 *
 *      ┌──────────┐  pause.request, no resume yet
 *  ────┤  paused  ├────────────────────────────► "Waiting on you: …"
 *      └──────────┘
 *
 *      (null)        run done / between calls   → bubble hidden
 *
 * Not an import path of its own since 9.0.0. This is the implementation barrel
 * behind `agentfootprint/observe`, which re-exports every name here — same
 * symbols, one door. Import from the door.
 */
export { selectStatus, renderStatusLine, type StatusState, type StatusKind, type StatusTemplates, type StatusContext, } from './recorders/observability/status/statusTemplates.js';
//# sourceMappingURL=status.d.ts.map