@inflexa-ai/harness 0.44.0 → 0.45.1

package/dist/contracts/chat-events.d.ts

@@ -1,7 +1,7 @@
 /**
  * Chat-stream events — the harness wire vocabulary.
  *
- * Distinct from the 15 `data-*` chat parts (`chat-parts.ts`): those are UI
+ * Distinct from the `data-*` chat parts (`chat-parts.ts`): those are UI
  * presentation payloads a tool emits; these are the agent-loop stream events
  * the host chat route frames as SSE. Together they are the sole
  * host↔frontend wire contract — there is no AI SDK UI Message Stream
@@ -20,6 +20,8 @@ import type { TokenUsageRollup } from "./usage.js";
 export interface EventSource {
     agentId: string;
     callPath: string[];
+    /** The id of the tool call that runs this loop. For a data profile, the workflow id of its attempt. */
+    invocationId?: string;
 }
 /** A run of assistant text. Deltas accumulate into the turn's reply. */
 export interface TextDeltaEvent {
@@ -140,8 +142,18 @@ export interface ChatErrorEvent {
     reason?: string;
     source: EventSource;
 }
+/**
+ * The id that the stored display gives a message of the turn. The frames after it belong to that message, up to
+ * the next `message-start` of the same role.
+ */
+export interface MessageStartEvent {
+    type: "message-start";
+    messageId: string;
+    role: "user" | "assistant";
+    source: EventSource;
+}
 /** The discriminated union of all chat-stream events. */
-export type ChatEvent = TextDeltaEvent | IterationEvent | ToolStartedEvent | ToolFinishedEvent | FinishEvent | ChatErrorEvent;
+export type ChatEvent = TextDeltaEvent | IterationEvent | ToolStartedEvent | ToolFinishedEvent | FinishEvent | ChatErrorEvent | MessageStartEvent;
 /** A `data-*` part as a frame, with the source of its emitter when the emitter stamped one. */
 export type ChatPartFrame = ChatPart & {
     source?: EventSource;

package/dist/contracts/chat-events.js

@@ -1,7 +1,7 @@
 /**
  * Chat-stream events — the harness wire vocabulary.
  *
- * Distinct from the 15 `data-*` chat parts (`chat-parts.ts`): those are UI
+ * Distinct from the `data-*` chat parts (`chat-parts.ts`): those are UI
  * presentation payloads a tool emits; these are the agent-loop stream events
  * the host chat route frames as SSE. Together they are the sole
  * host↔frontend wire contract — there is no AI SDK UI Message Stream

package/dist/contracts/chat-frame.d.ts

@@ -16,6 +16,13 @@ export type ChatPartCheck = {
     readonly ok: false;
     readonly error: string;
 };
+/**
+ * The wire shape of a data part, `{ ...data, type }`, which is the flat shape of the part contracts. The chat stream
+ * and the run streams use this one rule.
+ */
+export declare function flattenDataPart(part: Pick<ChatDataPart, "type" | "data">): {
+    type: `data-${string}`;
+} & Record<string, unknown>;
 /**
  * The frame of one emitted event, or `null` for `done` and for an `iteration` of the root agent. A frame of a sub-agent
  * keeps its source, thus a consumer can filter it. A `text-delta` has no source, thus its frame gets `fallbackSource`,

package/dist/contracts/chat-frame.js

@@ -3,7 +3,22 @@ import { isReconciling, PART_REGISTRY } from "./part-registry.js";
 import { EventSourceSchema } from "./schemas/chat-events.js";
 import { ChatPartSchema } from "./schemas/chat-parts.js";
 function toSource(source) {
-    return { agentId: source.agentId, callPath: [...source.callPath] };
+    return {
+        agentId: source.agentId,
+        callPath: [...source.callPath],
+        ...(source.invocationId === undefined ? {} : { invocationId: source.invocationId }),
+    };
+}
+/**
+ * The wire shape of a data part, `{ ...data, type }`, which is the flat shape of the part contracts. The chat stream
+ * and the run streams use this one rule.
+ */
+export function flattenDataPart(part) {
+    // The payload is `unknown`, and the spread is not checked here. The chat stream checks each frame with `checkChatPart`.
+    // On the run stream the producer builds the payload with the fields of its part contract, and the synthesis-sink test
+    // parses the result with `RunSynthesisPartSchema`.
+    const data = (part.data ?? {});
+    return { ...data, type: part.type };
 }
 /**
  * The frame of one emitted event, or `null` for `done` and for an `iteration` of the root agent. A frame of a sub-agent
@@ -38,11 +53,12 @@ export function toChatFrame(event, fallbackSource) {
             };
         case "text-delta":
             return { type: "text-delta", text: event.text, source: toSource(fallbackSource) };
+        case "message-start":
+            return { type: "message-start", messageId: event.messageId, role: event.role, source: toSource(event.source) };
         default: {
-            // A `ChatDataPart`, whose payload the emitter types as `unknown`. The wire part is flat: `{ type, ...data }`.
             // The cast names the frame that the type claims. `checkChatPart` is the check.
-            const data = (event.data ?? {});
-            return { ...data, type: event.type, ...(event.source === undefined ? {} : { source: toSource(event.source) }) };
+            const part = flattenDataPart(event);
+            return { ...part, ...(event.source === undefined ? {} : { source: toSource(event.source) }) };
         }
     }
 }
@@ -103,7 +119,7 @@ export function applyChatFrame(messages, frame, assistantId) {
     if (frame.type === "error") {
         return { messages, terminal: { error: frame } };
     }
-    if (frame.type === "iteration")
+    if (frame.type === "iteration" || frame.type === "message-start")
         return { messages, terminal: null };
     const partFrame = frame;
     const next = updateAssistant(messages, assistantId, (parts) => applyPartFrame(parts, partFrame));
@@ -143,9 +159,11 @@ function applyPartFrame(parts, frame) {
             return started ? next : [...parts, finished];
         }
         default: {
+            // A chat event type that no case above takes is not a part frame, thus this annotation fails to compile.
+            const partFrame = frame;
             // The source routes the frame, and it is not a field of the part. A rest type does not distribute over the
             // union of the part frames, thus the cast names the part that remains.
-            const { source: _source, ...part } = frame;
+            const { source: _source, ...part } = partFrame;
             return upsertPart(parts, part);
         }
     }

package/dist/contracts/chat-parts.d.ts

@@ -5,13 +5,16 @@
  * Categories:
  *   Presentation:    data-presentation (agent-synthesized content),
  *                    data-plan (plan by id), data-file-reference (files by path)
- *   Approval:        data-ask (a tool's pending user-approval prompt)
+ *   Approval:        data-ask (a tool's pending user-approval prompt),
+ *                    data-plan-approval (the record of an approved plan)
  *   Compaction:      data-compaction (a compaction of the conversation thread)
  *   Run lifecycle:   run-started, dag-state, run-completed, run-failed, run-synthesis,
  *                    synthesis-progress
  *   Per-step live:   step-activity, step-file-tree
+ *   Activity history: activity-entry (run stream), subagent-activity (conversation)
  *   Per-step final:  step-output, step-summary, step-usage
  */
+import type { ToolCallOutcome } from "./chat-events.js";
 import type { TokenUsageRollup } from "./usage.js";
 export interface PlanStep {
     id: string;
@@ -78,6 +81,8 @@ export interface PlanPart {
     type: "data-plan";
     id: string;
     planId: string;
+    /** The plan that this plan revised. Absent for a first plan. */
+    parentPlanId?: string;
     title?: string;
     steps?: PlanStep[];
     analytical_narrative?: string;
@@ -92,6 +97,14 @@ export interface RunCardPart {
     title: string;
     stepCount: number;
 }
+export interface PlanApprovalPart {
+    type: "data-plan-approval";
+    planId: string;
+    /** The run that the approval started. */
+    runId: string;
+    /** ISO 8601. The instant of the approval, equal to the time of the `approve-plan` provenance event. */
+    approvedAt: string;
+}
 export interface FileReferenceEntry {
     path: string;
     runId?: string;
@@ -119,6 +132,8 @@ export interface AskPart {
     /** Optional additional detail a surface may render. */
     detail?: string;
     status: "pending" | "resolved" | "rejected" | "aborted" | "expired";
+    /** The kind of the ledger reply. Only a `resolved` or `rejected` part carries it, and never the rejection feedback. */
+    reply?: "once" | "always" | "reject";
 }
 export interface RunStartedPart {
     type: "data-run-started";
@@ -152,6 +167,8 @@ export interface DagStepState {
     /** Error message (set on failure). */
     error?: string;
 }
+/** One step of the stored plan graph: the fields of {@link DagStepState} that the plan alone fixes. */
+export type PlanGraphStep = Pick<DagStepState, "id" | "name" | "agent" | "dependsOn" | "level">;
 export interface DagStatePart {
     type: "data-dag-state";
     /** Stable ID for reconciliation — same across all updates for a run. */
@@ -176,6 +193,24 @@ export interface StepActivityPart {
     phase: StepPhase;
     /** Human-readable activity description (e.g., "Running DESeq2 analysis"). */
     activity: string;
+    /** ISO 8601 time of the emission. Absent on a part that an older harness wrote. */
+    at?: string;
+}
+/**
+ * One activity emission of a step or a data profile, kept in the run stream with no reconciliation. The fold
+ * delivers each entry in write order.
+ */
+export interface ActivityEntryPart {
+    type: "data-activity-entry";
+    /** Unique per emission within a stream. */
+    id: string;
+    runId: string;
+    stepId: string;
+    /** A `SynthesisPhase` for the entries of the synthesis step, a `StepPhase` for each other step. */
+    phase: StepPhase | SynthesisPhase;
+    activity: string;
+    /** ISO 8601 time of the emission. */
+    at: string;
 }
 export interface FileTreeEntry {
     path: string;
@@ -290,6 +325,12 @@ export interface RunCompletedPart {
      */
     usage?: TokenUsageRollup;
 }
+export interface FindingReference {
+    pmid: string;
+    citation: string;
+    relevance: string;
+    concordance: "supports" | "contradicts" | "extends" | "contextualizes";
+}
 export interface SynthesizedFinding {
     stepId: string;
     title: string;
@@ -297,6 +338,7 @@ export interface SynthesizedFinding {
     confidence: "high" | "medium" | "low";
     noveltyStatus: "novel" | "confirmed" | "partially_confirmed" | "contradicted" | "expected";
     literatureInterpretation: string;
+    references: FindingReference[];
 }
 export interface BiologicalTheme {
     name: string;
@@ -336,6 +378,8 @@ export interface SynthesisProgressPart {
     phase: SynthesisPhase;
     /** Human-readable activity description. */
     activity: string;
+    /** ISO 8601 time of the emission. Absent in a stream that an older harness wrote. */
+    at?: string;
     /** Number of literature-reviewer delegations started so far. */
     delegationCount?: number;
     /** Agent-provided reason — set when phase === "skipped". */
@@ -407,4 +451,31 @@ export interface CompactionPart {
     /** Before the user message of a turn, or before a later request. */
     trigger?: "turn-start" | "mid-turn";
 }
-export type ChatPart = PresentationPart | PlanPart | RunCardPart | FileReferencePart | AskPart | RunStartedPart | DagStatePart | StepActivityPart | StepFileTreePart | StepOutputPart | StepSummaryPart | StepUsagePart | StepBlockedPart | RunSynthesisPart | SynthesisProgressPart | RunCompletedPart | RunFailedPart | ChildSessionStartedPart | ReportRenderedPart | CompactionPart;
+/** One tool call of a sub-agent. It holds no input, no output, and no text of the sub-agent. */
+export interface SubAgentActivityEntry {
+    agentId: string;
+    callPath: string[];
+    tool: string;
+    /** The one-line detail of the call, normalized, redacted, and capped by the loop. */
+    label?: string;
+    /** ISO 8601. */
+    startedAt: string;
+    /** ISO 8601. Absent while the call is in flight and for an `incomplete` call. */
+    endedAt?: string;
+    /** Absent while the call is in flight. A stored entry always has it. */
+    outcome?: ToolCallOutcome;
+}
+/**
+ * The tool calls of the sub-agents below one root tool call. Re-emitted under the same `id` after each change,
+ * so reconciling readers keep the latest list.
+ */
+export interface SubAgentActivityPart {
+    type: "data-subagent-activity";
+    id: string;
+    /** The id of the root tool call. */
+    toolCallId: string;
+    entries: SubAgentActivityEntry[];
+    /** The count of calls past the cap of the entries. */
+    dropped: number;
+}
+export type ChatPart = PresentationPart | PlanPart | RunCardPart | PlanApprovalPart | FileReferencePart | AskPart | RunStartedPart | DagStatePart | StepActivityPart | ActivityEntryPart | SubAgentActivityPart | StepFileTreePart | StepOutputPart | StepSummaryPart | StepUsagePart | StepBlockedPart | RunSynthesisPart | SynthesisProgressPart | RunCompletedPart | RunFailedPart | ChildSessionStartedPart | ReportRenderedPart | CompactionPart;

package/dist/contracts/chat-parts.js

@@ -5,11 +5,13 @@
  * Categories:
  *   Presentation:    data-presentation (agent-synthesized content),
  *                    data-plan (plan by id), data-file-reference (files by path)
- *   Approval:        data-ask (a tool's pending user-approval prompt)
+ *   Approval:        data-ask (a tool's pending user-approval prompt),
+ *                    data-plan-approval (the record of an approved plan)
  *   Compaction:      data-compaction (a compaction of the conversation thread)
  *   Run lifecycle:   run-started, dag-state, run-completed, run-failed, run-synthesis,
  *                    synthesis-progress
  *   Per-step live:   step-activity, step-file-tree
+ *   Activity history: activity-entry (run stream), subagent-activity (conversation)
  *   Per-step final:  step-output, step-summary, step-usage
  */
 export {};

package/dist/contracts/index.d.ts

@@ -2,8 +2,8 @@ export { ORGAN_SYSTEMS, OrganSystemSchema, ORGAN_SYSTEM_LABELS, organSystemLabel
 export type { OrganSystem } from "./organ-system.js";
 export { SEVERITIES, SeveritySchema } from "./severity.js";
 export type { Severity } from "./severity.js";
-export type { PlanStep, PresentationContent, PresentationPart, PlanPart, RunCardPart, FileReferenceEntry, FileReferencePart, AskPart, RunStartedPart, StepStatus, DagStepState, DagStatePart, StepPhase, StepActivityPart, FileTreeEntry, StepFileTreePart, StepOutputFile, StepOutputPart, StepSummaryPart, StepUsagePart, StepBlockedPart, SynthesizedFinding, BiologicalTheme, RunSynthesisPart, SynthesisPhase, SynthesisProgressPart, RunCompletedFinding, RunCompletedPart, RunFailedPart, ChildSessionStartedPart, ReportRenderedPart, CompactionPart, ChatPart, } from "./chat-parts.js";
-export type { EventSource, TextDeltaEvent, IterationEvent, ToolStartedEvent, ToolFinishedEvent, FinishEvent, ChatErrorEvent, ChatEvent, ChatFrame, ChatPartFrame, } from "./chat-events.js";
+export type { PlanStep, PresentationContent, PresentationPart, PlanPart, RunCardPart, PlanApprovalPart, FileReferenceEntry, FileReferencePart, AskPart, RunStartedPart, StepStatus, DagStepState, PlanGraphStep, DagStatePart, StepPhase, StepActivityPart, ActivityEntryPart, SubAgentActivityEntry, SubAgentActivityPart, FileTreeEntry, StepFileTreePart, StepOutputFile, StepOutputPart, StepSummaryPart, StepUsagePart, StepBlockedPart, FindingReference, SynthesizedFinding, BiologicalTheme, RunSynthesisPart, SynthesisPhase, SynthesisProgressPart, RunCompletedFinding, RunCompletedPart, RunFailedPart, ChildSessionStartedPart, ReportRenderedPart, CompactionPart, ChatPart, } from "./chat-parts.js";
+export type { EventSource, TextDeltaEvent, IterationEvent, ToolStartedEvent, ToolFinishedEvent, FinishEvent, ChatErrorEvent, MessageStartEvent, ChatEvent, ChatFrame, ChatPartFrame, } from "./chat-events.js";
 export type { TokenUsageRollup } from "./usage.js";
 export { DATA_PROFILE_RUN_LITERAL } from "./data-profile.js";
 export type { DataProfileAxis, DataProfileChecked, DataProfileCompanionCompleteness, DataProfileCoverage, DataProfileDimension, DataProfileFile, DataProfileGroup, DataProfileGroupSlot, DataProfileInputSignature, DataProfileKind, DataProfileLifecycleStatus, DataProfileMemberAnnotation, DataProfileObservation, DataProfileOrganism, DataProfilePartition, DataProfileProbeReport, DataProfileQualityAssessment, DataProfileQuarantine, DataProfileRecipeStep, DataProfileResult, DataProfileSubjectSource, } from "./data-profile.js";
@@ -12,6 +12,8 @@ export type { DimensionCategory, DimensionCategoryEntry, DimensionProbe, Dimensi
 export type { TextPart, ToolCallPart, MessagePart, ChatMessage } from "./message.js";
 export { toChatFrame, applyChatFrame, checkChatPart } from "./chat-frame.js";
 export type { TurnTerminal, ApplyFrameResult, ChatPartCheck } from "./chat-frame.js";
+export { createSubAgentActivityTracker, SUBAGENT_ACTIVITY_MAX_ENTRIES } from "./subagent-activity.js";
+export type { SubAgentActivityTracker } from "./subagent-activity.js";
 export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./part-registry.js";
 export type { ChatPartType, PartDescriptor, PartEmitter, PartConsumer } from "./part-registry.js";
 export { AnalogyCoverageSchema, AnalogyReportSchema, AnalogyReportErrorSchema, AnalogicalReasonerOutputSchema } from "./analogy-report.js";

package/dist/contracts/index.js

@@ -3,6 +3,7 @@ export { SEVERITIES, SeveritySchema } from "./severity.js";
 export { DATA_PROFILE_RUN_LITERAL } from "./data-profile.js";
 export { DIMENSION_CATEGORIES, DIMENSION_CATEGORY_IDS, DIMENSION_PROBE_IDS, DIMENSION_PROBES, GROUP_CATEGORIES, GROUP_CATEGORY_IDS, GROUP_ROLE_IDS, GROUP_ROLES, PROBE_OUTCOME_IDS, dimensionCategoryEntry, dimensionScope, groupCategoryEntry, } from "./profile-vocabulary.js";
 export { toChatFrame, applyChatFrame, checkChatPart } from "./chat-frame.js";
+export { createSubAgentActivityTracker, SUBAGENT_ACTIVITY_MAX_ENTRIES } from "./subagent-activity.js";
 export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./part-registry.js";
 export { AnalogyCoverageSchema, AnalogyReportSchema, AnalogyReportErrorSchema, AnalogicalReasonerOutputSchema } from "./analogy-report.js";
 export { buildReportSessionUrl, reportSessionResourceId } from "./content-url.js";

package/dist/contracts/part-registry.js

@@ -2,11 +2,14 @@ export const PART_REGISTRY = {
     "data-presentation": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
     "data-plan": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
     "data-run-card": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
+    "data-plan-approval": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
     "data-file-reference": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: false },
     "data-ask": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: true },
     "data-run-started": { emitter: "workflow", consumer: "sidebar", transient: true, reconciling: false },
     "data-dag-state": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: true },
     "data-step-activity": { emitter: "workflow", consumer: "sidebar", transient: true, reconciling: true },
+    "data-activity-entry": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: false },
+    "data-subagent-activity": { emitter: "conversation", consumer: "conversation", transient: false, reconciling: true },
     "data-step-file-tree": { emitter: "workflow", consumer: "sidebar", transient: true, reconciling: true },
     "data-step-output": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: false },
     "data-step-summary": { emitter: "workflow", consumer: "sidebar", transient: false, reconciling: false },

package/dist/contracts/schemas/chat-events.d.ts

@@ -5,6 +5,7 @@ import { z } from "zod";
 export declare const EventSourceSchema: z.ZodObject<{
     agentId: z.ZodString;
     callPath: z.ZodArray<z.ZodString>;
+    invocationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const TextDeltaEventSchema: z.ZodObject<{
     type: z.ZodLiteral<"text-delta">;
@@ -12,6 +13,7 @@ export declare const TextDeltaEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const IterationEventSchema: z.ZodObject<{
@@ -19,6 +21,7 @@ export declare const IterationEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 /** Mirrors the `ToolOutcome` union — three states, never a boolean. */
@@ -42,6 +45,7 @@ export declare const ToolStartedEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const ToolFinishedEventSchema: z.ZodObject<{
@@ -58,6 +62,7 @@ export declare const ToolFinishedEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const FinishEventSchema: z.ZodObject<{
@@ -65,6 +70,7 @@ export declare const FinishEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodOptional<z.ZodNumber>;
@@ -88,6 +94,20 @@ export declare const ChatErrorEventSchema: z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const MessageStartEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -96,12 +116,14 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"iteration">;
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool-started">;
@@ -111,6 +133,7 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tool-finished">;
@@ -126,12 +149,14 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"finish">;
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     usage: z.ZodOptional<z.ZodObject<{
         inputTokens: z.ZodOptional<z.ZodNumber>;
@@ -154,5 +179,18 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     source: z.ZodObject<{
         agentId: z.ZodString;
         callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message-start">;
+    messageId: z.ZodUUID;
+    role: z.ZodEnum<{
+        assistant: "assistant";
+        user: "user";
+    }>;
+    source: z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        invocationId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>], "type">;

package/dist/contracts/schemas/chat-events.js

@@ -6,6 +6,7 @@ import { TokenUsageRollupSchema } from "./usage.js";
 export const EventSourceSchema = z.object({
     agentId: z.string(),
     callPath: z.array(z.string()),
+    invocationId: z.string().optional(),
 });
 export const TextDeltaEventSchema = z.object({
     type: z.literal("text-delta"),
@@ -49,6 +50,12 @@ export const ChatErrorEventSchema = z.object({
     reason: z.string().optional(),
     source: EventSourceSchema,
 });
+export const MessageStartEventSchema = z.object({
+    type: z.literal("message-start"),
+    messageId: z.uuid(),
+    role: z.enum(["user", "assistant"]),
+    source: EventSourceSchema,
+});
 export const ChatEventSchema = z.discriminatedUnion("type", [
     TextDeltaEventSchema,
     IterationEventSchema,
@@ -56,4 +63,5 @@ export const ChatEventSchema = z.discriminatedUnion("type", [
     ToolFinishedEventSchema,
     FinishEventSchema,
     ChatErrorEventSchema,
+    MessageStartEventSchema,
 ]);