effect-agent 0.1.0-beta.10 → 0.1.0-beta.101

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