/**
 * EventMeta + shared event vocabulary.
 *
 * Pattern: Domain-Driven Design value objects (Evans, 2003).
 * Role:    Shared vocabulary for the typed events in registry.ts.
 * Emits:   (types only — no runtime behavior here).
 */
export type ContextSlot = 'system-prompt' | 'messages' | 'tools';
/**
 * The origin / flavor of a context injection.
 *
 * BASELINE sources (regular LLM-API flow — NOT context engineering):
 *   - `user`        → the user's message (current turn or history replay)
 *   - `tool-result` → tool return for a tool call (current or history)
 *   - `assistant`   → prior-turn assistant output replayed as history
 *   - `base`        → static system prompt configured at build time
 *   - `registry`    → static tool registry configured at build time
 *
 * ENGINEERED sources (context engineering flavors — the teaching layer):
 *   - `rag`          → retrieval-augmented injection
 *   - `skill`        → skill activation (LLM-guided via read_skill)
 *   - `memory`       → memory strategy re-injection
 *   - `instructions` → rule-based behavior guidance
 *   - `steering`     → always-on policy / persona / format rule
 *   - `fact`         → developer-supplied data (user profile, env, …)
 *   - `custom`       → consumer-defined (anything bespoke)
 *
 * Adding a new source is NOT a breaking change; removing one IS.
 */
export type ContextSource = 'rag' | 'skill' | 'memory' | 'instructions' | 'steering' | 'fact' | 'custom' | 'user' | 'tool-result' | 'assistant' | 'base' | 'registry';
export type ContextRole = 'system' | 'user' | 'assistant' | 'tool';
export type ContextRecency = 'latest' | 'earlier';
export type ContextLifetime = 'iteration' | 'turn' | 'run' | 'persistent';
export type LLMProviderName = 'anthropic' | 'openai' | 'google' | 'cohere' | 'local' | 'custom' | 'mock' | (string & {});
export type ToolProtocol = 'native' | 'mcp' | 'http' | 'python-fn';
export type CompositionKind = 'Sequence' | 'Parallel' | 'Conditional' | 'Loop';
/**
 * Metadata attached by the dispatcher to every event. Consumers never
 * construct this manually — the dispatcher fills it in.
 */
export interface EventMeta {
    /** Wall-clock ms — for external correlation / dashboards. */
    readonly wallClockMs: number;
    /** ms since run start — deterministic replay. */
    readonly runOffsetMs: number;
    /** footprintjs universal stage key. */
    readonly runtimeStageId: string;
    /** Subflow path parsed from runtimeStageId. */
    readonly subflowPath: readonly string[];
    /** Composition ancestry — e.g. ['Sequence:pipeline','Agent:ethics']. */
    readonly compositionPath: readonly string[];
    /** Turn index (Agent context only). */
    readonly turnIndex?: number;
    /** Iteration index (Agent context only). */
    readonly iterIndex?: number;
    /** OTEL trace id (when env.traceId is set). */
    readonly traceId?: string;
    /** OTEL span id for the current composition boundary. */
    readonly spanId?: string;
    /** Domain correlation id — ties retrieval → injection → LLM. */
    readonly correlationId?: string;
    /** Run id — demultiplex concurrent runs sharing one dispatcher. */
    readonly runId: string;
}
/** Discriminated-union envelope every event implements. */
export interface AgentfootprintEventEnvelope<TType extends string, TPayload> {
    readonly type: TType;
    readonly payload: TPayload;
    readonly meta: EventMeta;
}
//# sourceMappingURL=types.d.ts.map