effect-agent 0.1.0-beta.85 → 0.1.0-beta.87

package/dist/RunEvent-DIrzkjLr.d.mts

@@ -0,0 +1,460 @@
+import { r as Update } from "./AgentUpdates-DMJ-_xow.mjs";
+import { c as Selection } from "./ToolExposure-r2eOWk4F.mjs";
+import { s as RunTotals } from "./Usage-Dx0aknfk.mjs";
+import { Schema } from "effect";
+declare namespace RunEvent_d_exports {
+  export { AgentUpdateEmitted, ApprovalRequested, BudgetWarning, CompactionPerformed, ExhaustedLimit, ModelStarted, ReasoningDelta, RunCompleted, RunEvent, RunFailed, RunInterrupted, RunStarted, RunSuspended, SubagentCompleted, SubagentFailed, SubagentInterrupted, SubagentJoined, SubagentProgress, SubagentRequested, SubagentStarted, TextDelta, ToolCallDeclared, ToolCallFailed, ToolCallStarted, ToolCallSucceeded, ToolFailureHandling, ToolProgress, TurnCompleted, TurnStarted };
+}
+declare const AgentUpdateEmitted_base: Schema.Class<AgentUpdateEmitted, Schema.TaggedStruct<"AgentUpdateEmitted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly update: typeof Update;
+}>, {}>;
+/** A schema-encoded Agent update accepted by the owning Run. */
+declare class AgentUpdateEmitted extends AgentUpdateEmitted_base {}
+declare const RunStarted_base: Schema.Class<RunStarted, Schema.TaggedStruct<"RunStarted", {
+  eventVersion: Schema.Literal<1>;
+  runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  sequence: Schema.Natural;
+  timestamp: Schema.DateTimeUtcFromString;
+  turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+}>, {}>;
+/** Signals that the runtime has created a run and assigned its identities. */
+declare class RunStarted extends RunStarted_base {}
+declare const TurnStarted_base: Schema.Class<TurnStarted, Schema.TaggedStruct<"TurnStarted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly turn: Schema.Int;
+}>, {}>;
+/** Signals the start of a positive-numbered model turn. */
+declare class TurnStarted extends TurnStarted_base {}
+declare const ModelStarted_base: Schema.Class<ModelStarted, Schema.TaggedStruct<"ModelStarted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly turn: Schema.Int;
+}>, {}>;
+/** Signals that the model request for a turn is starting. */
+declare class ModelStarted extends ModelStarted_base {}
+declare const TextDelta_base: Schema.Class<TextDelta, Schema.TaggedStruct<"TextDelta", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly text: Schema.String;
+}>, {}>;
+/** Carries one live assistant text delta. */
+declare class TextDelta extends TextDelta_base {}
+declare const ReasoningDelta_base: Schema.Class<ReasoningDelta, Schema.TaggedStruct<"ReasoningDelta", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly text: Schema.String;
+}>, {}>;
+/** Carries reasoning content explicitly exposed by the provider. */
+declare class ReasoningDelta extends ReasoningDelta_base {}
+declare const ToolCallDeclared_base: Schema.Class<ToolCallDeclared, Schema.TaggedStruct<"ToolCallDeclared", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+  readonly parameters: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly providerExecuted: Schema.Boolean;
+}>, {}>;
+/** Reports a complete model-declared Tool Call and its execution boundary. */
+declare class ToolCallDeclared extends ToolCallDeclared_base {}
+declare const ToolCallStarted_base: Schema.Class<ToolCallStarted, Schema.TaggedStruct<"ToolCallStarted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+}>, {}>;
+/** Signals that a validated Tool Call handler has started. */
+declare class ToolCallStarted extends ToolCallStarted_base {}
+declare const ToolProgress_base: Schema.Class<ToolProgress, Schema.TaggedStruct<"ToolProgress", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+  readonly result: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly providerExecuted: Schema.Boolean;
+}>, {}>;
+/** Carries a preliminary Tool result that is not the call's terminal outcome. */
+declare class ToolProgress extends ToolProgress_base {}
+declare const ToolCallSucceeded_base: Schema.Class<ToolCallSucceeded, Schema.TaggedStruct<"ToolCallSucceeded", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+  readonly toolSelection: Schema.optionalKey<typeof Selection>;
+  readonly result: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly providerExecuted: Schema.Boolean;
+}>, {}>;
+/** Records the successful terminal result of a Tool Call. */
+declare class ToolCallSucceeded extends ToolCallSucceeded_base {}
+/**
+ * How this boundary handled a failed invocation, independently of its native failure mode.
+ * `returned-to-model` records the result path; delivery still requires the complete batch to
+ * commit and a later model call. A sibling, policy or later operation can still fail the Run.
+ * This classification never implies that side effects were rolled back.
+ */
+declare const ToolFailureHandling: Schema.Literals<readonly ["propagated", "returned-to-model", "returned-to-caller"]>;
+type ToolFailureHandling = typeof ToolFailureHandling.Type;
+declare const ToolCallFailed_base: Schema.Class<ToolCallFailed, Schema.TaggedStruct<"ToolCallFailed", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+  readonly errorTag: Schema.NonEmptyString;
+  readonly message: Schema.String;
+  readonly providerExecuted: Schema.Boolean;
+  /** Native configuration when a local Tool is known; absent on provider results and old events. */
+  readonly failureMode: Schema.optionalKey<Schema.Literals<readonly ["error", "return"]>>;
+  /** Actual route at this boundary. Absence on older events means unknown, never recoverable. */
+  readonly failureHandling: Schema.optionalKey<Schema.Literals<readonly ["propagated", "returned-to-model", "returned-to-caller"]>>;
+  /** Synthetic policy rejection; no handler ran and the failure streak is unchanged. */
+  readonly budgetRejected: Schema.optionalKey<Schema.Literal<true>>;
+}>, {}>;
+/** Records a terminal Tool Call failure using safe, serializable diagnostics. */
+declare class ToolCallFailed extends ToolCallFailed_base {}
+declare const ApprovalRequested_base: Schema.Class<ApprovalRequested, Schema.TaggedStruct<"ApprovalRequested", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly toolName: Schema.NonEmptyString;
+}>, {}>;
+/** Signals that a decoded Tool Call requires approval before execution. */
+declare class ApprovalRequested extends ApprovalRequested_base {}
+declare const TurnCompleted_base: Schema.Class<TurnCompleted, Schema.TaggedStruct<"TurnCompleted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly turn: Schema.Int;
+  readonly finishReason: Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>;
+}>, {}>;
+/** Records the normalized finish reason for a completed assistant turn. */
+declare class TurnCompleted extends TurnCompleted_base {}
+declare const BudgetWarning_base: Schema.Class<BudgetWarning, Schema.TaggedStruct<"BudgetWarning", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly limit: Schema.Literals<readonly ["tokens", "tool-calls", "turns", "duration", "context"]>;
+  readonly consumed: Schema.Natural;
+  readonly limitValue: Schema.Natural;
+}>, {}>;
+/** Advisory that one policy limit crossed its warning fraction; emitted once per limit per run. */
+declare class BudgetWarning extends BudgetWarning_base {}
+declare const CompactionPerformed_base: Schema.Class<CompactionPerformed, Schema.TaggedStruct<"CompactionPerformed", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly turn: Schema.Int;
+  readonly kind: Schema.Literals<readonly ["clear-tool-results", "summarize", "rollover"]>;
+  readonly tokensBeforeEstimate: Schema.Natural;
+  readonly tokensAfterEstimate: Schema.Natural;
+}>, {}>;
+/** Records that the engine reduced model context at a Turn seam without erasing source history. */
+declare class CompactionPerformed extends CompactionPerformed_base {}
+/**
+ * Dimension that bound when a Run settled through the final-answer resolution
+ * (RUN-018; the token dimension per RUN-025). This is the exhausted marker
+ * the re-delegation grant flow (RUN-021) consumes and the durable
+ * `SubmissionSettled` record persists (RUN-011).
+ */
+declare const ExhaustedLimit: Schema.Literals<readonly ["tokens", "tool-calls", "turns"]>;
+type ExhaustedLimit = typeof ExhaustedLimit.Type;
+declare const RunCompleted_base: Schema.Class<RunCompleted, Schema.Struct<{
+  readonly _tag: Schema.tag<"RunCompleted">;
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly output: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+  readonly runDisposition: Schema.optionalKey<Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+  readonly turns: Schema.Int;
+  readonly finishReason: Schema.Literals<readonly ["completed", "model-stop", "budget-exhausted"]>;
+  readonly exhausted: Schema.optionalKey<Schema.Literals<readonly ["tokens", "tool-calls", "turns"]>>;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+}>, {}>;
+/**
+ * Successful terminal event carrying Schema-compatible output and the completed turn count.
+ * `"budget-exhausted"` marks a Run that settled through the policy's final-answer resolution
+ * after Turn, Tool Call, or token exhaustion — never a plain `"model-stop"` (RUN-011); its
+ * `turns` count may exceed `maxTurns` by the single grace Turn, and `exhausted` names the
+ * dimension that bound.
+ *
+ * Invariant: `exhausted` is present exactly when `finishReason` is
+ * `"budget-exhausted"`, and a budget-exhausted completion has no application
+ * run disposition. The checked Struct enforces both rules during construction,
+ * decoding, and encoding without replacing the class in `RunEvent`.
+ */
+declare class RunCompleted extends RunCompleted_base {}
+declare const RunFailed_base: Schema.Class<RunFailed, Schema.TaggedStruct<"RunFailed", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+  readonly errorTag: Schema.NonEmptyString;
+  readonly message: Schema.String;
+}>, {}>;
+/** Terminal event for a run that failed with an expected error. */
+declare class RunFailed extends RunFailed_base {}
+declare const RunInterrupted_base: Schema.Class<RunInterrupted, Schema.TaggedStruct<"RunInterrupted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly message: Schema.String;
+}>, {}>;
+/** Terminal event for a run stopped by interruption. */
+declare class RunInterrupted extends RunInterrupted_base {}
+declare const RunSuspended_base: Schema.Class<RunSuspended, Schema.TaggedStruct<"RunSuspended", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">>;
+  readonly toolCallId: Schema.optionalKey<Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">>;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+  readonly reason: Schema.String;
+}>, {}>;
+/** Terminal event for a run awaiting resumable external input. */
+declare class RunSuspended extends RunSuspended_base {}
+declare const SubagentRequested_base: Schema.Class<SubagentRequested, Schema.TaggedStruct<"SubagentRequested", {
+  eventVersion: Schema.Literal<1>;
+  runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  sequence: Schema.Natural;
+  timestamp: Schema.DateTimeUtcFromString;
+  turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  depth: Schema.Int;
+}>, {}>;
+/** Signals that a delegation Tool Call passed preflight with preallocated child identity. */
+declare class SubagentRequested extends SubagentRequested_base {}
+declare const SubagentStarted_base: Schema.Class<SubagentStarted, Schema.TaggedStruct<"SubagentStarted", {
+  eventVersion: Schema.Literal<1>;
+  runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  sequence: Schema.Natural;
+  timestamp: Schema.DateTimeUtcFromString;
+  turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  depth: Schema.Int;
+}>, {}>;
+/** Signals that the child run has started inside its parent-owned scoped region. */
+declare class SubagentStarted extends SubagentStarted_base {}
+declare const SubagentProgress_base: Schema.Class<SubagentProgress, Schema.TaggedStruct<"SubagentProgress", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  readonly childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly depth: Schema.Int;
+  readonly summary: Schema.String;
+}>, {}>;
+/** Carries a bounded child progress summary without duplicating the child event stream. */
+declare class SubagentProgress extends SubagentProgress_base {}
+declare const SubagentCompleted_base: Schema.Class<SubagentCompleted, Schema.Struct<{
+  readonly _tag: Schema.tag<"SubagentCompleted">;
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  readonly childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly depth: Schema.Int;
+  readonly turns: Schema.Int;
+  readonly finishReason: Schema.Literals<readonly ["completed", "model-stop", "budget-exhausted"]>;
+  readonly exhausted: Schema.optionalKey<Schema.Literals<readonly ["tokens", "tool-calls", "turns"]>>;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+}>, {}>;
+/**
+ * Records the child run's successful terminal outcome before the parent join.
+ * Same invariant as `RunCompleted`: `exhausted` is present exactly when
+ * `finishReason` is `"budget-exhausted"` (the pair travels verbatim from the
+ * child's terminal event); consumers treat a divergent pair fail-safe.
+ */
+declare class SubagentCompleted extends SubagentCompleted_base {}
+declare const SubagentFailed_base: Schema.Class<SubagentFailed, Schema.TaggedStruct<"SubagentFailed", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  readonly childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly depth: Schema.Int;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+  readonly errorTag: Schema.NonEmptyString;
+  readonly message: Schema.String;
+}>, {}>;
+/** Records the child run's expected terminal failure using safe, serializable diagnostics. */
+declare class SubagentFailed extends SubagentFailed_base {}
+declare const SubagentInterrupted_base: Schema.Class<SubagentInterrupted, Schema.TaggedStruct<"SubagentInterrupted", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  readonly childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly depth: Schema.Int;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+  readonly reason: Schema.String;
+}>, {}>;
+/** Records that the child run was stopped by interruption before a terminal outcome. */
+declare class SubagentInterrupted extends SubagentInterrupted_base {}
+declare const SubagentJoined_base: Schema.Class<SubagentJoined, Schema.TaggedStruct<"SubagentJoined", {
+  readonly eventVersion: Schema.Literal<1>;
+  readonly runId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly threadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly agentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly sequence: Schema.Natural;
+  readonly timestamp: Schema.DateTimeUtcFromString;
+  readonly turnId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/TurnId">;
+  readonly toolCallId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ToolCallId">;
+  readonly delegationId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/DelegationId">;
+  readonly childThreadId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/ThreadId">;
+  readonly childRunId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/RunId">;
+  readonly targetAgentId: Schema.brand<Schema.NonEmptyString, "@effect-agent/core/AgentId">;
+  readonly depth: Schema.Int;
+  readonly usage: Schema.optionalKey<typeof RunTotals>;
+  readonly delegatedUsage: Schema.optionalKey<typeof RunTotals>;
+}>, {}>;
+/** Records that the child's terminal outcome was joined into its parent delegation Tool Call. */
+declare class SubagentJoined extends SubagentJoined_base {}
+/** Versioned union of stable semantic run events, excluding raw provider chunks. */
+declare const RunEvent: Schema.Union<readonly [typeof AgentUpdateEmitted, typeof RunStarted, typeof TurnStarted, typeof ModelStarted, typeof TextDelta, typeof ReasoningDelta, typeof ToolCallDeclared, typeof ToolCallStarted, typeof ToolProgress, typeof ToolCallSucceeded, typeof ToolCallFailed, typeof ApprovalRequested, typeof TurnCompleted, typeof BudgetWarning, typeof CompactionPerformed, typeof RunCompleted, typeof RunFailed, typeof RunInterrupted, typeof RunSuspended, typeof SubagentRequested, typeof SubagentStarted, typeof SubagentProgress, typeof SubagentCompleted, typeof SubagentFailed, typeof SubagentInterrupted, typeof SubagentJoined]>;
+type RunEvent = typeof RunEvent.Type;
+//#endregion
+export { TurnStarted as A, ToolCallDeclared as C, ToolFailureHandling as D, ToolCallSucceeded as E, ToolProgress as O, TextDelta as S, ToolCallStarted as T, SubagentInterrupted as _, ExhaustedLimit as a, SubagentRequested as b, RunCompleted as c, RunFailed as d, RunInterrupted as f, SubagentFailed as g, SubagentCompleted as h, CompactionPerformed as i, TurnCompleted as k, RunEvent as l, RunSuspended as m, ApprovalRequested as n, ModelStarted as o, RunStarted as p, BudgetWarning as r, ReasoningDelta as s, AgentUpdateEmitted as t, RunEvent_d_exports as u, SubagentJoined as v, ToolCallFailed as w, SubagentStarted as x, SubagentProgress as y };
+//# sourceMappingURL=RunEvent-DIrzkjLr.d.mts.map

package/dist/RunEventSink-D5aVhISG.d.mts

@@ -0,0 +1,108 @@
+import { d as ToolCallId, r as DelegationId, s as RunId, t as AgentId, u as ThreadId } from "./Identifiers-CN2s30fF.mjs";
+import { n as DelegationDepth } from "./SubagentContract-DdT7Cqe6.mjs";
+import { s as RunTotals } from "./Usage-Dx0aknfk.mjs";
+import { Context, Effect, Schema } from "effect";
+declare namespace RunEventSink_d_exports {
+  export { RunEventSink, RunEventSinkClosedError, RunEventSinkService, SubagentCompletedPayload, SubagentEventBasePayload, SubagentEventPayload, SubagentFailedPayload, SubagentInterruptedPayload, SubagentJoinedPayload, SubagentProgressPayload, SubagentRequestedPayload, SubagentStartedPayload };
+}
+/**
+ * Shared identity carried by every pre-base Subagent event payload. The
+ * emitting Tool handler supplies delegation lineage and its own Tool Call
+ * identity; the engine stamps the remaining fields it is authoritative for
+ * (`eventVersion`, `runId`, `threadId`, `agentId`, `sequence`,
+ * `timestamp`, and the emitting batch's `turnId`) when the payload is woven
+ * into the parent stream.
+ */
+interface SubagentEventBasePayload {
+  readonly toolCallId: ToolCallId;
+  readonly delegationId: DelegationId;
+  readonly childThreadId: ThreadId;
+  readonly childRunId: RunId;
+  readonly targetAgentId: AgentId;
+  readonly depth: DelegationDepth;
+}
+/** Pre-base payload for the core `SubagentRequested` event. */
+interface SubagentRequestedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentRequested";
+}
+/** Pre-base payload for the core `SubagentStarted` event. */
+interface SubagentStartedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentStarted";
+}
+/** Pre-base payload for the core `SubagentProgress` event; `summary` is at most 4096 characters. */
+interface SubagentProgressPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentProgress";
+  readonly summary: string;
+}
+/** Pre-base payload for the core `SubagentCompleted` event; `turns` is a positive integer. */
+interface SubagentCompletedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentCompleted";
+  readonly turns: number;
+  readonly finishReason: "completed" | "model-stop" | "budget-exhausted";
+  /** Dimension that bound when the child settled budget-exhausted (the RUN-021 grant-flow marker). */
+  readonly exhausted?: "tokens" | "tool-calls" | "turns" | undefined;
+  /** What the child spent, so a parent can account for delegated work. */
+  readonly usage?: RunTotals | undefined;
+  readonly delegatedUsage?: RunTotals | undefined;
+}
+/** Pre-base payload for the core `SubagentFailed` event; `message` is at most 4096 characters. */
+interface SubagentFailedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentFailed";
+  readonly usage?: RunTotals | undefined;
+  readonly delegatedUsage?: RunTotals | undefined;
+  readonly errorTag: string;
+  readonly message: string;
+}
+/** Pre-base payload for the core `SubagentInterrupted` event; `reason` is at most 4096 characters. */
+interface SubagentInterruptedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentInterrupted";
+  readonly usage?: RunTotals | undefined;
+  readonly delegatedUsage?: RunTotals | undefined;
+  readonly reason: string;
+}
+/** Pre-base payload for the core `SubagentJoined` event. */
+interface SubagentJoinedPayload extends SubagentEventBasePayload {
+  readonly _tag: "SubagentJoined";
+  readonly usage?: RunTotals | undefined;
+  readonly delegatedUsage?: RunTotals | undefined;
+}
+/**
+ * Discriminated union of pre-base Subagent lifecycle event payloads accepted
+ * by `RunEventSink.emit`. Each variant is the corresponding core `RunEvent`
+ * class minus the base fields the engine stamps. The stamped event is
+ * constructed through the core Schema class, so core field checks (bounded
+ * text, positive turns) still apply; violating them is a defect of the
+ * emitting handler, not an expected failure.
+ */
+type SubagentEventPayload = SubagentRequestedPayload | SubagentStartedPayload | SubagentProgressPayload | SubagentCompletedPayload | SubagentFailedPayload | SubagentInterruptedPayload | SubagentJoinedPayload;
+declare const RunEventSinkClosedError_base: Schema.Class<RunEventSinkClosedError, Schema.TaggedStruct<"RunEventSinkClosedError", {
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A handler emitted a Subagent event after its Tool batch had already settled. */
+declare class RunEventSinkClosedError extends RunEventSinkClosedError_base {}
+/**
+ * Service value accepted by Tool handlers to emit first-class Subagent
+ * lifecycle events into the parent Run's semantic stream.
+ *
+ * The sink is backed by a bounded queue drained by the Run's own event stream.
+ * A burst may suspend the emitting handler until that internal stream drains
+ * capacity, but an external detached observer cannot backpressure the Tool
+ * batch. Emitting after the owning Tool batch has settled — or outside any
+ * Tool batch — fails closed with `RunEventSinkClosedError`.
+ */
+interface RunEventSinkService {
+  readonly emit: (payload: SubagentEventPayload) => Effect.Effect<void, RunEventSinkClosedError>;
+}
+declare const RunEventSink_base: Context.ServiceClass<RunEventSink, "@effect-agent/engine/RunEventSink", RunEventSinkService>;
+/**
+ * Engine-owned seam through which Tool handlers emit Subagent lifecycle
+ * events onto the parent Run stream.
+ *
+ * The engine provides this service locally to every Tool batch, bound to that
+ * batch's Run identity and Turn; it is never satisfied from an application
+ * Layer and is excluded from the runtime's public requirements.
+ */
+declare class RunEventSink extends RunEventSink_base {}
+//#endregion
+export { SubagentCompletedPayload as a, SubagentFailedPayload as c, SubagentProgressPayload as d, SubagentRequestedPayload as f, RunEventSink_d_exports as i, SubagentInterruptedPayload as l, RunEventSinkClosedError as n, SubagentEventBasePayload as o, SubagentStartedPayload as p, RunEventSinkService as r, SubagentEventPayload as s, RunEventSink as t, SubagentJoinedPayload as u };
+//# sourceMappingURL=RunEventSink-D5aVhISG.d.mts.map