@ai-agent-forge/agent-forge 0.85.0

package/dist/core/extensions/lifecycle-catalog.d.ts

@@ -0,0 +1,584 @@
+import type { AssistantMessage, ImageContent, TextContent, ToolResultMessage } from "@agent-forge/ai/compat";
+import type { BuildSystemPromptOptions } from "../system-prompt.ts";
+import type { ContextOperationOptions, LifecycleEventDefinition, PluginConfigValue, SessionRevisionV1 } from "./public-api.ts";
+export declare const PLUGIN_DISPOSE_EVENT_ID = "plugin.dispose";
+export declare const PLUGIN_DISPOSE_EVENT_VERSION = 1;
+export declare const PLUGIN_READY_EVENT_ID = "plugin.ready";
+export declare const PLUGIN_READY_EVENT_VERSION = 1;
+export declare const SESSION_CONTEXT_REPLACED_EVENT_ID = "session.context.replaced";
+export declare const SESSION_CONTEXT_REPLACED_EVENT_VERSION = 1;
+export declare const SESSION_RELOAD_EVENT_ID = "session.reload";
+export declare const SESSION_RELOAD_EVENT_VERSION = 1;
+export declare const AGENT_START_EVENT_ID = "agent.start";
+export declare const AGENT_START_EVENT_VERSION = 1;
+export declare const AGENT_SETTLED_EVENT_ID = "agent.settled";
+export declare const AGENT_SETTLED_EVENT_VERSION = 1;
+export declare const TURN_START_EVENT_ID = "turn.start";
+export declare const TURN_START_EVENT_VERSION = 1;
+export declare const TURN_END_EVENT_ID = "turn.end";
+export declare const TURN_END_EVENT_VERSION = 1;
+export declare const MESSAGE_START_EVENT_ID = "message.start";
+export declare const MESSAGE_START_EVENT_VERSION = 1;
+export declare const MESSAGE_END_EVENT_ID = "message.end";
+export declare const MESSAGE_END_EVENT_VERSION = 1;
+export declare const TOOL_EXECUTION_START_EVENT_ID = "tool.execution.start";
+export declare const TOOL_EXECUTION_START_EVENT_VERSION = 1;
+export declare const MODEL_SELECT_EVENT_ID = "model.select";
+export declare const MODEL_SELECT_EVENT_VERSION = 1;
+export declare const THINKING_LEVEL_SELECT_EVENT_ID = "thinking_level.select";
+export declare const THINKING_LEVEL_SELECT_EVENT_VERSION = 1;
+export declare const SESSION_INFO_CHANGED_EVENT_ID = "session.info.changed";
+export declare const SESSION_INFO_CHANGED_EVENT_VERSION = 1;
+export declare const SESSION_ENTRY_APPENDED_EVENT_ID = "session.entry.appended";
+export declare const SESSION_ENTRY_APPENDED_EVENT_VERSION = 1;
+export declare const AGENT_END_EVENT_ID = "agent.end";
+export declare const AGENT_END_EVENT_VERSION = 1;
+export declare const BEFORE_AGENT_START_EVENT_ID = "before.agent.start";
+export declare const BEFORE_AGENT_START_EVENT_VERSION = 1;
+export declare const BEFORE_AGENT_START_EVENT_VERSION_V2 = 2;
+export declare const UI_PROMPT_START_EVENT_ID = "ui.prompt.start";
+export declare const UI_PROMPT_START_EVENT_VERSION = 1;
+export declare const UI_PROMPT_END_EVENT_ID = "ui.prompt.end";
+export declare const UI_PROMPT_END_EVENT_VERSION = 1;
+export declare const RESOURCES_DISCOVER_EVENT_ID = "resources.discover";
+export declare const RESOURCES_DISCOVER_EVENT_VERSION = 1;
+export declare const RESOURCES_DISCOVER_EVENT_VERSION_V2 = 2;
+export declare const CONTEXT_ASSEMBLED_EVENT_ID = "context.assembled";
+export declare const CONTEXT_ASSEMBLED_EVENT_VERSION = 1;
+export declare const INPUT_RECEIVED_EVENT_ID = "input.received";
+export declare const INPUT_RECEIVED_EVENT_VERSION = 1;
+export declare const USER_BASH_EVENT_ID = "user.bash";
+export declare const USER_BASH_EVENT_VERSION = 1;
+export declare const SESSION_START_EVENT_ID = "session.start";
+export declare const SESSION_START_EVENT_VERSION = 1;
+export declare const MODEL_RESPONSE_EVENT_ID = "model.response";
+export declare const MODEL_RESPONSE_EVENT_VERSION = 1;
+export declare const MODEL_STREAM_EVENT_ID = "model.stream";
+export declare const MODEL_STREAM_EVENT_VERSION = 1;
+export type ModelStreamEventNameV1 = "start" | "text_start" | "text_delta" | "text_end" | "thinking_start" | "thinking_delta" | "thinking_end" | "toolcall_start" | "toolcall_delta" | "toolcall_end" | "done" | "error";
+export interface ModelStreamEventDataV1 {
+    version: 1;
+    sessionId: string;
+    streamId: string;
+    sequence: number;
+    phase: "raw" | "candidate" | "committed";
+    event: ModelStreamEventNameV1;
+    partial: unknown | null;
+    terminal: boolean;
+    error: {
+        code: string;
+        message: string;
+        name?: string;
+    } | null;
+}
+export declare const TOOL_RESULT_EVENT_ID = "tool.result";
+export declare const TOOL_RESULT_EVENT_VERSION = 1;
+export declare const TOOL_CALL_EVENT_ID = "tool.call";
+export declare const TOOL_CALL_EVENT_VERSION = 1;
+export declare const TOOL_RESULT_RAW_EVENT_ID = "tool.result.raw";
+export declare const TOOL_RESULT_RAW_EVENT_VERSION = 1;
+export declare const TOOL_EXECUTE_EVENT_ID = "tool.execute";
+export declare const TOOL_EXECUTE_EVENT_VERSION = 1;
+export declare const TOOL_COMMIT_EVENT_ID = "tool.commit";
+export declare const TOOL_COMMIT_EVENT_VERSION = 1;
+export declare const TOOL_GATE_BLOCKED_EVENT_ID = "tool.gate.blocked";
+export declare const TOOL_GATE_BLOCKED_EVENT_VERSION = 1;
+export declare const INPUT_GATE_BLOCKED_EVENT_ID = "input.gate.blocked";
+export declare const INPUT_GATE_BLOCKED_EVENT_VERSION = 1;
+export declare const OPERATION_END_EVENT_ID = "operation.end";
+export declare const OPERATION_END_EVENT_VERSION = 1;
+export interface PluginDisposeEventDataV1 {
+    version: 1;
+    pluginId: string;
+    pluginVersion: string;
+    status: "disposed" | "failed";
+}
+/** A plugin factory has completed and its public registrations are active. */
+export interface PluginReadyEventDataV1 {
+    version: 1;
+    pluginId: string;
+    pluginVersion: string;
+}
+/** A context projection has become the session's active runtime context. */
+export interface SessionContextReplacedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    reason: NonNullable<ContextOperationOptions["reason"]>;
+    messageCount: number;
+    strategyName?: string;
+}
+/** A session runtime has been completely rebuilt and its reload work committed. */
+export interface SessionReloadEventDataV1 {
+    version: 1;
+    sessionId: string;
+    generation: number;
+    reason: "reload";
+}
+/** A finalized assistant response after its session entry has been appended. */
+export interface ModelResponseEventDataV1 {
+    version: 1;
+    sessionId: string;
+    entryId: string;
+    revision: {
+        version: 1;
+        sessionId: string;
+        sequence: number;
+        leafId: string | null;
+    };
+    provider: string;
+    model: string;
+    stopReason: "pending" | "stop" | "length" | "toolUse" | "error" | "aborted" | "deferred";
+    message: AssistantMessage;
+    errorMessage?: string;
+}
+/** A finalized tool result after its session entry has been appended. */
+export interface ToolResultEventDataV1 {
+    version: 1;
+    sessionId: string;
+    entryId: string;
+    revision: {
+        version: 1;
+        sessionId: string;
+        sequence: number;
+        leafId: string | null;
+    };
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    message: ToolResultMessage;
+}
+/** A validated tool candidate immediately before execution. */
+export interface ToolCallEventDataV1 {
+    version: 1;
+    sessionId: string;
+    revision: SessionRevisionV1;
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+/** A raw result from an executed tool, before legacy result transforms run. */
+export interface ToolResultRawEventDataV1 {
+    version: 1;
+    sessionId: string;
+    revision: SessionRevisionV1;
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    content: readonly (TextContent | ImageContent)[];
+}
+/** A settled registered-tool invocation before result transforms and session commit. */
+export interface ToolExecuteEventDataV1 {
+    version: 1;
+    sessionId: string;
+    revision: SessionRevisionV1;
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    isError: boolean;
+    content: readonly (TextContent | ImageContent)[];
+}
+/** A tool result after its session message has been appended. */
+export interface ToolCommitEventDataV1 {
+    version: 1;
+    sessionId: string;
+    entryId: string;
+    revision: SessionRevisionV1;
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+}
+/** A terminal fact for an operation registered through CapabilityAPI. */
+export interface OperationEndEventDataV1 {
+    version: 1;
+    operationId: string;
+    operationKind: string;
+    status: "succeeded" | "failed" | "cancelled";
+    errorMessage?: string;
+    reason?: string;
+}
+export declare function validatePluginDisposeEventDataV1(value: unknown): PluginDisposeEventDataV1;
+export declare function pluginDisposeEventDefinition(): LifecycleEventDefinition<PluginDisposeEventDataV1>;
+export declare function validatePluginReadyEventDataV1(value: unknown): PluginReadyEventDataV1;
+export declare function pluginReadyEventDefinition(): LifecycleEventDefinition<PluginReadyEventDataV1>;
+export declare const PLUGIN_REJECTED_EVENT_ID = "plugin.rejected";
+export declare const PLUGIN_REJECTED_EVENT_VERSION = 1;
+export interface PluginRejectedEventDataV1 {
+    version: 1;
+    /** Plugin id when the manifest could be parsed; otherwise absent. */
+    pluginId?: string;
+    manifestPath: string;
+    code: "invalid_manifest" | "duplicate_plugin_id" | "missing_dependency" | "plugin_load_failed";
+    message: string;
+}
+export declare function validatePluginRejectedEventDataV1(value: unknown): PluginRejectedEventDataV1;
+export declare function pluginRejectedEventDefinition(): LifecycleEventDefinition<PluginRejectedEventDataV1>;
+export declare function validateSessionContextReplacedEventDataV1(value: unknown): SessionContextReplacedEventDataV1;
+export declare function sessionContextReplacedEventDefinition(): LifecycleEventDefinition<SessionContextReplacedEventDataV1>;
+export declare function validateSessionReloadEventDataV1(value: unknown): SessionReloadEventDataV1;
+export declare function sessionReloadEventDefinition(): LifecycleEventDefinition<SessionReloadEventDataV1>;
+export interface AgentLifecycleEventDataV1 {
+    version: 1;
+    sessionId: string;
+}
+export declare function validateAgentLifecycleEventDataV1(value: unknown): AgentLifecycleEventDataV1;
+export declare function agentStartEventDefinition(): LifecycleEventDefinition<AgentLifecycleEventDataV1>;
+export declare function agentSettledEventDefinition(): LifecycleEventDefinition<AgentLifecycleEventDataV1>;
+export interface TurnStartEventDataV1 {
+    version: 1;
+    sessionId: string;
+    turnIndex: number;
+}
+export declare function validateTurnStartEventDataV1(value: unknown): TurnStartEventDataV1;
+/**
+ * One finished turn. A turn that ended in a deviation carries the turn-level
+ * `outcome` ("aborted" | "error", judged from the turn's assistant message
+ * stopReason); a completed turn omits the key entirely — normal stays silent,
+ * deviation is recorded.
+ */
+export interface TurnEndEventDataV1 {
+    version: 1;
+    sessionId: string;
+    turnIndex: number;
+    messageCount: number;
+    outcome?: "aborted" | "error";
+}
+export declare function validateTurnEndEventDataV1(value: unknown): TurnEndEventDataV1;
+export interface MessageBoundaryEventDataV1 {
+    version: 1;
+    sessionId: string;
+    role: string;
+}
+export declare function validateMessageBoundaryEventDataV1(value: unknown): MessageBoundaryEventDataV1;
+export declare function turnStartEventDefinition(): LifecycleEventDefinition<TurnStartEventDataV1>;
+export declare function turnEndEventDefinition(): LifecycleEventDefinition<TurnEndEventDataV1>;
+export declare function messageStartEventDefinition(): LifecycleEventDefinition<MessageBoundaryEventDataV1>;
+export declare function messageEndEventDefinition(): LifecycleEventDefinition<MessageBoundaryEventDataV1>;
+export interface ToolExecutionStartEventDataV1 {
+    version: 1;
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+}
+export declare function validateToolExecutionStartEventDataV1(value: unknown): ToolExecutionStartEventDataV1;
+export declare function toolExecutionStartEventDefinition(): LifecycleEventDefinition<ToolExecutionStartEventDataV1>;
+export interface ModelSelectEventDataV1 {
+    version: 1;
+    sessionId: string;
+    provider: string;
+    id: string;
+    source: "set" | "cycle" | "restore";
+}
+export declare function validateModelSelectEventDataV1(value: unknown): ModelSelectEventDataV1;
+export interface ThinkingLevelSelectEventDataV1 {
+    version: 1;
+    sessionId: string;
+    level: string;
+    previousLevel: string;
+}
+export declare function validateThinkingLevelSelectEventDataV1(value: unknown): ThinkingLevelSelectEventDataV1;
+export declare function modelSelectEventDefinition(): LifecycleEventDefinition<ModelSelectEventDataV1>;
+export declare function thinkingLevelSelectEventDefinition(): LifecycleEventDefinition<ThinkingLevelSelectEventDataV1>;
+export interface SessionInfoChangedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    /** Current normalized session name. Absent when the name is cleared. */
+    name?: string;
+}
+export declare function validateSessionInfoChangedEventDataV1(value: unknown): SessionInfoChangedEventDataV1;
+export interface SessionEntryAppendedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    entryId: string;
+    entryType: string;
+}
+export declare function validateSessionEntryAppendedEventDataV1(value: unknown): SessionEntryAppendedEventDataV1;
+export declare function sessionInfoChangedEventDefinition(): LifecycleEventDefinition<SessionInfoChangedEventDataV1>;
+export declare function sessionEntryAppendedEventDefinition(): LifecycleEventDefinition<SessionEntryAppendedEventDataV1>;
+export interface AgentEndEventDataV1 {
+    version: 1;
+    sessionId: string;
+    messageCount: number;
+}
+export declare function validateAgentEndEventDataV1(value: unknown): AgentEndEventDataV1;
+export interface BeforeAgentStartEventDataV1 {
+    version: 1;
+    sessionId: string;
+    hasImages: boolean;
+}
+export declare function validateBeforeAgentStartEventDataV1(value: unknown): BeforeAgentStartEventDataV1;
+export declare function agentEndEventDefinition(): LifecycleEventDefinition<AgentEndEventDataV1>;
+export declare function beforeAgentStartEventDefinition(): LifecycleEventDefinition<BeforeAgentStartEventDataV1>;
+/**
+ * Candidate-phase sibling of before.agent.start@1: the effective base system
+ * prompt and its build options enter the envelope so capability transforms
+ * (system-prompt customizers) can rewrite the prompt before the first model
+ * call. A transform returns the full data with a replaced `systemPrompt`;
+ * returning the input verbatim means "no replacement".
+ */
+export interface BeforeAgentStartEventDataV2 {
+    version: 2;
+    sessionId: string;
+    systemPrompt: string;
+    systemPromptOptions: BuildSystemPromptOptions;
+}
+export declare function validateBeforeAgentStartEventDataV2(value: unknown): BeforeAgentStartEventDataV2;
+export declare function beforeAgentStartV2EventDefinition(): LifecycleEventDefinition<BeforeAgentStartEventDataV2>;
+export interface UIPromptBoundaryEventDataV1 {
+    version: 1;
+    sessionId: string;
+    kind: string;
+    title?: string;
+}
+export declare function validateUIPromptBoundaryEventDataV1(value: unknown): UIPromptBoundaryEventDataV1;
+export interface ResourcesDiscoverEventDataV1 {
+    version: 1;
+    sessionId: string;
+    cwd: string;
+    reason: "startup" | "reload";
+}
+export declare function validateResourcesDiscoverEventDataV1(value: unknown): ResourcesDiscoverEventDataV1;
+export declare function uiPromptStartEventDefinition(): LifecycleEventDefinition<UIPromptBoundaryEventDataV1>;
+export declare function uiPromptEndEventDefinition(): LifecycleEventDefinition<UIPromptBoundaryEventDataV1>;
+export declare function resourcesDiscoverEventDefinition(): LifecycleEventDefinition<ResourcesDiscoverEventDataV1>;
+/** One contributed resource path, shaped identically to the legacy collection. */
+export interface ResourcesDiscoverContributionV2 {
+    path: string;
+    extensionPath: string;
+}
+/**
+ * Candidate-phase sibling of resources.discover@1: same envelope with the
+ * version bumped to 2, plus optional transform contributions. A transform
+ * returns the full data with any of the three contribution arrays attached;
+ * each entry keeps the legacy `{ path, extensionPath }` collection shape.
+ */
+export interface ResourcesDiscoverEventDataV2 {
+    version: 2;
+    sessionId: string;
+    cwd: string;
+    reason: "startup" | "reload";
+    skillPaths?: ResourcesDiscoverContributionV2[];
+    promptPaths?: ResourcesDiscoverContributionV2[];
+    themePaths?: ResourcesDiscoverContributionV2[];
+}
+export declare function validateResourcesDiscoverEventDataV2(value: unknown): ResourcesDiscoverEventDataV2;
+export declare function resourcesDiscoverV2EventDefinition(): LifecycleEventDefinition<ResourcesDiscoverEventDataV2>;
+export interface ContextAssembledEventDataV1 {
+    version: 1;
+    sessionId: string;
+    messageCount: number;
+}
+export declare function validateContextAssembledEventDataV1(value: unknown): ContextAssembledEventDataV1;
+export interface InputReceivedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    source: string;
+    textLength: number;
+}
+export declare function validateInputReceivedEventDataV1(value: unknown): InputReceivedEventDataV1;
+export interface UserBashEventDataV1 {
+    version: 1;
+    sessionId: string;
+    cwd: string;
+    excludeFromContext: boolean;
+}
+export declare function validateUserBashEventDataV1(value: unknown): UserBashEventDataV1;
+export declare function contextAssembledEventDefinition(): LifecycleEventDefinition<ContextAssembledEventDataV1>;
+export declare function inputReceivedEventDefinition(): LifecycleEventDefinition<InputReceivedEventDataV1>;
+export declare function userBashEventDefinition(): LifecycleEventDefinition<UserBashEventDataV1>;
+export interface SessionStartEventDataV1 {
+    version: 1;
+    sessionId: string;
+    reason: "startup" | "reload" | "new" | "resume" | "fork";
+    previousSessionFile?: string;
+}
+export declare function validateSessionStartEventDataV1(value: unknown): SessionStartEventDataV1;
+export declare function sessionStartEventDefinition(): LifecycleEventDefinition<SessionStartEventDataV1>;
+export declare function validateModelResponseEventDataV1(value: unknown): ModelResponseEventDataV1;
+export declare function modelResponseEventDefinition(): LifecycleEventDefinition<ModelResponseEventDataV1>;
+export declare function validateModelStreamEventDataV1(value: unknown): ModelStreamEventDataV1;
+export declare function modelStreamEventDefinition(): LifecycleEventDefinition<ModelStreamEventDataV1>;
+export declare function validateToolResultEventDataV1(value: unknown): ToolResultEventDataV1;
+export declare function toolResultEventDefinition(): LifecycleEventDefinition<ToolResultEventDataV1>;
+export declare function validateToolCallEventDataV1(value: unknown): ToolCallEventDataV1;
+export declare function toolCallEventDefinition(): LifecycleEventDefinition<ToolCallEventDataV1>;
+export declare function validateToolExecuteEventDataV1(value: unknown): ToolExecuteEventDataV1;
+export declare function toolExecuteEventDefinition(): LifecycleEventDefinition<ToolExecuteEventDataV1>;
+export declare function validateToolCommitEventDataV1(value: unknown): ToolCommitEventDataV1;
+export declare function toolCommitEventDefinition(): LifecycleEventDefinition<ToolCommitEventDataV1>;
+export declare function validateToolResultRawEventDataV1(value: unknown): ToolResultRawEventDataV1;
+export declare function toolResultRawEventDefinition(): LifecycleEventDefinition<ToolResultRawEventDataV1>;
+export declare const TOOL_RESULT_TRANSFORM_EVENT_ID = "tool.result.transform";
+export declare const TOOL_RESULT_TRANSFORM_EVENT_VERSION = 1;
+export interface ToolResultTransformEventDataV1 {
+    version: 1;
+    sessionId: string;
+    revision: SessionRevisionV1;
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    content: readonly (TextContent | ImageContent)[];
+}
+export declare function validateToolResultTransformEventDataV1(value: unknown): ToolResultTransformEventDataV1;
+export declare function toolResultTransformEventDefinition(): LifecycleEventDefinition<ToolResultTransformEventDataV1>;
+export declare function validateOperationEndEventDataV1(value: unknown): OperationEndEventDataV1;
+export declare function operationEndEventDefinition(): LifecycleEventDefinition<OperationEndEventDataV1>;
+export declare const CAPABILITY_CALL_EVENT_ID = "capability.call";
+export declare const CAPABILITY_CALL_EVENT_VERSION = 1;
+export type CapabilityCallEventNameV1 = "start" | "cancel" | "end";
+export type CapabilityCallStatusV1 = "succeeded" | "failed" | "cancelled";
+export interface CapabilityCallEventDataV1 {
+    version: 1;
+    operationId: string;
+    capabilityId: string;
+    capabilityVersion: number;
+    capabilityKind: "service" | "contribution" | "transform";
+    callerPluginId: string;
+    providerPluginId: string;
+    event: CapabilityCallEventNameV1;
+    status?: CapabilityCallStatusV1;
+    error?: {
+        code: string;
+        message: string;
+        name?: string;
+    };
+}
+export declare function validateCapabilityCallEventDataV1(value: unknown): CapabilityCallEventDataV1;
+export declare function capabilityCallEventDefinition(): LifecycleEventDefinition<CapabilityCallEventDataV1>;
+export declare const OPERATION_START_EVENT_ID = "operation.start";
+export declare const OPERATION_START_EVENT_VERSION = 1;
+export declare const OPERATION_STEP_EVENT_ID = "operation.step";
+export declare const OPERATION_STEP_EVENT_VERSION = 1;
+export interface OperationStartEventDataV1 {
+    version: 1;
+    operationId: string;
+    operationKind: string;
+}
+export declare function validateOperationStartEventDataV1(value: unknown): OperationStartEventDataV1;
+export declare function operationStartEventDefinition(): LifecycleEventDefinition<OperationStartEventDataV1>;
+export interface OperationStepEventDataV1 {
+    version: 1;
+    operationId: string;
+    operationKind: string;
+    step: number;
+    message?: string;
+    data?: PluginConfigValue;
+}
+export declare function validateOperationStepEventDataV1(value: unknown): OperationStepEventDataV1;
+export declare function operationStepEventDefinition(): LifecycleEventDefinition<OperationStepEventDataV1>;
+export declare const OPERATION_CANCEL_EVENT_ID = "operation.cancel";
+export declare const OPERATION_CANCEL_EVENT_VERSION = 1;
+export interface OperationCancelEventDataV1 {
+    version: 1;
+    operationId: string;
+    operationKind: string;
+}
+export declare function validateOperationCancelEventDataV1(value: unknown): OperationCancelEventDataV1;
+export declare function operationCancelEventDefinition(): LifecycleEventDefinition<OperationCancelEventDataV1>;
+export declare const SESSION_AUTO_RETRY_EVENT_ID = "session.auto.retry";
+export declare const SESSION_AUTO_RETRY_EVENT_VERSION = 1;
+export declare const SESSION_COMPACTION_DECISION_EVENT_ID = "session.compaction.decision";
+export declare const SESSION_COMPACTION_DECISION_EVENT_VERSION = 1;
+export declare const SESSION_COMPACTION_FAILED_EVENT_ID = "session.compaction.failed";
+export declare const SESSION_COMPACTION_FAILED_EVENT_VERSION = 1;
+/** The host entered the actual retry path after a retryable agent failure. */
+export interface SessionAutoRetryEventDataV1 {
+    version: 1;
+    sessionId: string;
+    attempt: number;
+    maxAttempts: number;
+    delayMs: number;
+    errorMessage: string;
+}
+export type SessionCompactionDecisionReasonV1 = "overflow" | "threshold";
+/**
+ * One compaction policy decision observed by the host, including the negative
+ * pre-check verdicts. The threshold triplet is present only when the host
+ * measured it (threshold paths); the overflow path's policy request carries no
+ * contextUsage, so the fields are omitted rather than fabricated.
+ */
+export interface SessionCompactionDecisionEventDataV1 {
+    version: 1;
+    sessionId: string;
+    reason: SessionCompactionDecisionReasonV1;
+    compact: boolean;
+    willRetry: boolean;
+    contextTokens?: number;
+    contextWindow?: number;
+    reserveTokens?: number;
+    failureMessage?: string;
+}
+export type SessionCompactionFailedReasonV1 = "manual" | "overflow" | "threshold";
+/** A compaction that genuinely failed; extension/user cancellation stays unreported. */
+export interface SessionCompactionFailedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    reason: SessionCompactionFailedReasonV1;
+    errorMessage: string;
+}
+export declare function validateSessionAutoRetryEventDataV1(value: unknown): SessionAutoRetryEventDataV1;
+export declare function sessionAutoRetryEventDefinition(): LifecycleEventDefinition<SessionAutoRetryEventDataV1>;
+export declare function validateSessionCompactionDecisionEventDataV1(value: unknown): SessionCompactionDecisionEventDataV1;
+export declare function sessionCompactionDecisionEventDefinition(): LifecycleEventDefinition<SessionCompactionDecisionEventDataV1>;
+export declare function validateSessionCompactionFailedEventDataV1(value: unknown): SessionCompactionFailedEventDataV1;
+export declare function sessionCompactionFailedEventDefinition(): LifecycleEventDefinition<SessionCompactionFailedEventDataV1>;
+export declare const SESSION_END_EVENT_ID = "session.end";
+export declare const SESSION_END_EVENT_VERSION = 1;
+/**
+ * Terminal fact of a session dispose. A reload does not dispatch this event:
+ * a reload is covered by session.start(reason:"reload") plus session.reload@1.
+ */
+export interface SessionEndEventDataV1 {
+    version: 1;
+    sessionId: string;
+}
+export declare function validateSessionEndEventDataV1(value: unknown): SessionEndEventDataV1;
+export declare function sessionEndEventDefinition(): LifecycleEventDefinition<SessionEndEventDataV1>;
+export declare const AGENT_TASK_SETTLED_EVENT_ID = "agent.task.settled";
+export declare const AGENT_TASK_SETTLED_EVENT_VERSION = 1;
+/** Scheduler-authoritative settlement status; mirrors SubagentRuntimeStatus verbatim. */
+export type AgentTaskSettledStatusV1 = "queued" | "admitted" | "running" | "succeeded" | "failed" | "cancelled" | "timed_out" | "drain_timeout" | "runner_lost";
+/**
+ * One settled background delegation task. `sessionId` is the parent session
+ * that owns the task; `taskSessionId` is the child session the task ran in.
+ */
+export interface AgentTaskSettledEventDataV1 {
+    version: 1;
+    sessionId: string;
+    taskSessionId: string;
+    taskId: string;
+    status: AgentTaskSettledStatusV1;
+    reasonCode?: string;
+}
+export declare function validateAgentTaskSettledEventDataV1(value: unknown): AgentTaskSettledEventDataV1;
+export declare function agentTaskSettledEventDefinition(): LifecycleEventDefinition<AgentTaskSettledEventDataV1>;
+/**
+ * Observed fact of one beforeToolCall chain link returning a block
+ * short-circuit. The blocking plugin's identity is deliberately absent: the
+ * hook chain has no identity surface.
+ */
+export interface ToolGateBlockedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    toolCallId: string;
+    toolName: string;
+    reason?: string;
+}
+export declare function validateToolGateBlockedEventDataV1(value: unknown): ToolGateBlockedEventDataV1;
+export declare function toolGateBlockedEventDefinition(): LifecycleEventDefinition<ToolGateBlockedEventDataV1>;
+/**
+ * Observed fact of one beforeInput chain link returning a block short-circuit
+ * (输入 gate 拒绝，扩展位盘点 A3). Facts only — the rejected input's text never
+ * enters the envelope, matching input.received@1's privacy posture. The
+ * blocking plugin's identity is deliberately absent: the hook chain has no
+ * identity surface.
+ */
+export interface InputGateBlockedEventDataV1 {
+    version: 1;
+    sessionId: string;
+    source: string;
+    textLength: number;
+    reason?: string;
+}
+export declare function validateInputGateBlockedEventDataV1(value: unknown): InputGateBlockedEventDataV1;
+export declare function inputGateBlockedEventDefinition(): LifecycleEventDefinition<InputGateBlockedEventDataV1>;
+//# sourceMappingURL=lifecycle-catalog.d.ts.map