HarnessStreamPart

type HarnessStreamPart =
  | {
  id: string;
  type: "text-start";
}
  | {
  delta: string;
  id: string;
  type: "text-delta";
}
  | {
  id: string;
  type: "text-end";
}
  | {
  id: string;
  reason: string;
  type: "text-cancel";
}
  | {
  args: unknown;
  toolCallId?: string;
  toolName: string;
  type: "tool-call";
}
  | {
  result: unknown;
  toolCallId?: string;
  toolName: string;
  type: "tool-result";
}
  | {
  flow: string;
  type: "flow-enter";
}
  | {
  flow: string;
  reason: string;
  type: "flow-end";
}
  | {
  nodeName: string;
  type: "node-enter";
}
  | {
  nodeName: string;
  type: "node-exit";
}
  | {
  from: string;
  to: string;
  type: "flow-transition";
}
  | {
  reason?: string;
  targetAgent: string;
  type: "handoff";
}
  | {
  lastStep: number;
  reason: string;
  type: "interrupted";
}
  | {
  type: "paused";
  waitingFor: string;
}
  | {
  outcome: ConversationOutcome;
  type: "conversation-outcome";
}
  | {
  nodeId: string;
  options: ChoiceOption[];
  prompt: string;
  type: "interactive";
}
  | {
  type: "turn-end";
}
  | {
  rationale: string;
  type: "pipeline-validation-block";
  userFacingMessage?: string;
}
  | {
  handlerOutcome?: "queued" | "connected" | "failed";
  moderator: string;
  rationale: string;
  type: "safety-blocked";
  userFacingMessage: string;
}
  | {
  reason: string;
  type: "wake";
}
  | {
  category?: EscalationReason;
  outcome: "queued" | "connected" | "failed";
  reason: string;
  summary?: string;
  type: "escalation";
}
  | {
  afterTokens: number;
  beforeTokens: number;
  summarizedCount: number;
  type: "context-compacted";
}
  | {
  reason: string;
  type: "compaction-skipped";
}
  | {
  compacted: boolean;
  strippedCount: number;
  type: "context-overflow-recovered";
}
  | {
  error: string;
  type: "error";
}
  | {
  data: unknown;
  name: string;
  type: "custom";
}
  | {
  sessionId: string;
  type: "done";
};

Authoritative runtime stream union (runFlow / Runtime emit). types/voice.ts defines a separate voice/realtime union that intentionally does not include { type: 'interactive' }.

Union Members

Type Literal

{
  id: string;
  type: "text-start";
}

---

Type Literal

{
  delta: string;
  id: string;
  type: "text-delta";
}

---

Type Literal

{
  id: string;
  type: "text-end";
}

---

Type Literal

{
  id: string;
  reason: string;
  type: "text-cancel";
}

---

Type Literal

{
  args: unknown;
  toolCallId?: string;
  toolName: string;
  type: "tool-call";
}

---

Type Literal

{
  result: unknown;
  toolCallId?: string;
  toolName: string;
  type: "tool-result";
}

---

Type Literal

{
  flow: string;
  type: "flow-enter";
}

---

Type Literal

{
  flow: string;
  reason: string;
  type: "flow-end";
}

---

Type Literal

{
  nodeName: string;
  type: "node-enter";
}

---

Type Literal

{
  nodeName: string;
  type: "node-exit";
}

---

Type Literal

{
  from: string;
  to: string;
  type: "flow-transition";
}

---

Type Literal

{
  reason?: string;
  targetAgent: string;
  type: "handoff";
}

---

Type Literal

{
  lastStep: number;
  reason: string;
  type: "interrupted";
}

---

Type Literal

{
  type: "paused";
  waitingFor: string;
}

---

Type Literal

{
  outcome: ConversationOutcome;
  type: "conversation-outcome";
}

---

Type Literal

{
  nodeId: string;
  options: ChoiceOption[];
  prompt: string;
  type: "interactive";
}

---

Type Literal

{
  type: "turn-end";
}

---

Type Literal

{
  rationale: string;
  type: "pipeline-validation-block";
  userFacingMessage?: string;
}

---

Type Literal

{
  handlerOutcome?: "queued" | "connected" | "failed";
  moderator: string;
  rationale: string;
  type: "safety-blocked";
  userFacingMessage: string;
}

---

Type Literal

{
  reason: string;
  type: "wake";
}

reason

reason: string;

type

type: "wake";

An agent-initiated (scheduled wake) turn — there is no new user message.

---

Type Literal

{
  category?: EscalationReason;
  outcome: "queued" | "connected" | "failed";
  reason: string;
  summary?: string;
  type: "escalation";
}

category?

optional category?: EscalationReason;

outcome

outcome: "queued" | "connected" | "failed";

Result of the configured escalation handler.

reason

reason: string;

summary?

optional summary?: string;

The LLM handoff brief included in the request, when generated.

type

type: "escalation";

---

Type Literal

{
  afterTokens: number;
  beforeTokens: number;
  summarizedCount: number;
  type: "context-compacted";
}

afterTokens

afterTokens: number;

beforeTokens

beforeTokens: number;

Estimated history tokens before/after compaction.

summarizedCount

summarizedCount: number;

Number of older messages folded into the summary.

type

type: "context-compacted";

---

Type Literal

{
  reason: string;
  type: "compaction-skipped";
}

---

Type Literal

{
  compacted: boolean;
  strippedCount: number;
  type: "context-overflow-recovered";
}

compacted

compacted: boolean;

Whether the forced post-recovery compaction actually compacted.

strippedCount

strippedCount: number;

Partial assistant/tool messages stripped from the failed turn.

type

type: "context-overflow-recovered";

---

Type Literal

{
  error: string;
  type: "error";
}

---

Type Literal

{
  data: unknown;
  name: string;
  type: "custom";
}

---

Type Literal

{
  sessionId: string;
  type: "done";
}