@inflexa-ai/harness 0.43.1 → 0.45.0

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

@@ -91,6 +91,7 @@ export declare const PlanPartSchema: z.ZodObject<{
     type: z.ZodLiteral<"data-plan">;
     id: z.ZodString;
     planId: z.ZodString;
+    parentPlanId: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -124,6 +125,12 @@ export declare const RunCardPartSchema: z.ZodObject<{
     title: z.ZodString;
     stepCount: z.ZodNumber;
 }, z.core.$strip>;
+export declare const PlanApprovalPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-plan-approval">;
+    planId: z.ZodString;
+    runId: z.ZodString;
+    approvedAt: z.ZodISODateTime;
+}, z.core.$strip>;
 export declare const FileReferenceEntrySchema: z.ZodObject<{
     path: z.ZodString;
     runId: z.ZodOptional<z.ZodString>;
@@ -159,6 +166,11 @@ export declare const AskPartSchema: z.ZodObject<{
         rejected: "rejected";
         expired: "expired";
     }>;
+    reply: z.ZodOptional<z.ZodEnum<{
+        once: "once";
+        always: "always";
+        reject: "reject";
+    }>>;
 }, z.core.$strip>;
 export declare const RunStartedPartSchema: z.ZodObject<{
     type: z.ZodLiteral<"data-run-started">;
@@ -217,6 +229,18 @@ export declare const DagStatePartSchema: z.ZodObject<{
         error: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
 }, z.core.$strict>;
+export declare const SynthesisPhaseSchema: z.ZodEnum<{
+    failed: "failed";
+    skipped: "skipped";
+    complete: "complete";
+    indexing: "indexing";
+    persisting: "persisting";
+    starting: "starting";
+    researching: "researching";
+    drafting: "drafting";
+    validating: "validating";
+    refining: "refining";
+}>;
 export declare const StepPhaseSchema: z.ZodEnum<{
     failed: "failed";
     complete: "complete";
@@ -247,6 +271,38 @@ export declare const StepActivityPartSchema: z.ZodObject<{
         warning: "warning";
     }>;
     activity: z.ZodString;
+    at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ActivityEntryPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-activity-entry">;
+    id: z.ZodString;
+    runId: z.ZodString;
+    stepId: z.ZodString;
+    phase: z.ZodUnion<readonly [z.ZodEnum<{
+        failed: "failed";
+        complete: "complete";
+        "sandbox-init": "sandbox-init";
+        executing: "executing";
+        "generating-metadata": "generating-metadata";
+        "generating-summary": "generating-summary";
+        indexing: "indexing";
+        persisting: "persisting";
+        retrying: "retrying";
+        warning: "warning";
+    }>, z.ZodEnum<{
+        failed: "failed";
+        skipped: "skipped";
+        complete: "complete";
+        indexing: "indexing";
+        persisting: "persisting";
+        starting: "starting";
+        researching: "researching";
+        drafting: "drafting";
+        validating: "validating";
+        refining: "refining";
+    }>]>;
+    activity: z.ZodString;
+    at: z.ZodString;
 }, z.core.$strip>;
 export declare const FileTreeEntrySchema: z.ZodObject<{
     path: z.ZodString;
@@ -373,6 +429,17 @@ export declare const RunCompletedPartSchema: z.ZodObject<{
         reasoningTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const FindingReferenceSchema: z.ZodObject<{
+    pmid: z.ZodString;
+    citation: z.ZodString;
+    relevance: z.ZodString;
+    concordance: z.ZodEnum<{
+        supports: "supports";
+        contradicts: "contradicts";
+        extends: "extends";
+        contextualizes: "contextualizes";
+    }>;
+}, z.core.$strip>;
 export declare const SynthesizedFindingSchema: z.ZodObject<{
     stepId: z.ZodString;
     title: z.ZodString;
@@ -383,13 +450,24 @@ export declare const SynthesizedFindingSchema: z.ZodObject<{
         high: "high";
     }>;
     noveltyStatus: z.ZodEnum<{
-        expected: "expected";
         novel: "novel";
         confirmed: "confirmed";
         partially_confirmed: "partially_confirmed";
         contradicted: "contradicted";
+        expected: "expected";
     }>;
     literatureInterpretation: z.ZodString;
+    references: z.ZodArray<z.ZodObject<{
+        pmid: z.ZodString;
+        citation: z.ZodString;
+        relevance: z.ZodString;
+        concordance: z.ZodEnum<{
+            supports: "supports";
+            contradicts: "contradicts";
+            extends: "extends";
+            contextualizes: "contextualizes";
+        }>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const BiologicalThemeSchema: z.ZodObject<{
     name: z.ZodString;
@@ -415,13 +493,24 @@ export declare const RunSynthesisPartSchema: z.ZodObject<{
             high: "high";
         }>;
         noveltyStatus: z.ZodEnum<{
-            expected: "expected";
             novel: "novel";
             confirmed: "confirmed";
             partially_confirmed: "partially_confirmed";
             contradicted: "contradicted";
+            expected: "expected";
         }>;
         literatureInterpretation: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            pmid: z.ZodString;
+            citation: z.ZodString;
+            relevance: z.ZodString;
+            concordance: z.ZodEnum<{
+                supports: "supports";
+                contradicts: "contradicts";
+                extends: "extends";
+                contextualizes: "contextualizes";
+            }>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     themes: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -438,18 +527,6 @@ export declare const RunSynthesisPartSchema: z.ZodObject<{
         description: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare const SynthesisPhaseSchema: z.ZodEnum<{
-    failed: "failed";
-    skipped: "skipped";
-    complete: "complete";
-    indexing: "indexing";
-    persisting: "persisting";
-    starting: "starting";
-    researching: "researching";
-    drafting: "drafting";
-    validating: "validating";
-    refining: "refining";
-}>;
 export declare const SynthesisProgressPartSchema: z.ZodObject<{
     type: z.ZodLiteral<"data-synthesis-progress">;
     id: z.ZodString;
@@ -467,6 +544,7 @@ export declare const SynthesisProgressPartSchema: z.ZodObject<{
         refining: "refining";
     }>;
     activity: z.ZodString;
+    at: z.ZodOptional<z.ZodString>;
     delegationCount: z.ZodOptional<z.ZodNumber>;
     reason: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
@@ -505,6 +583,40 @@ export declare const CompactionPartSchema: z.ZodObject<{
         "mid-turn": "mid-turn";
     }>>;
 }, z.core.$strip>;
+export declare const SubAgentActivityEntrySchema: z.ZodObject<{
+    agentId: z.ZodString;
+    callPath: z.ZodArray<z.ZodString>;
+    tool: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodOptional<z.ZodEnum<{
+        error: "error";
+        ok: "ok";
+        denied: "denied";
+        incomplete: "incomplete";
+    }>>;
+}, z.core.$strip>;
+export declare const SubAgentActivityPartSchema: z.ZodObject<{
+    type: z.ZodLiteral<"data-subagent-activity">;
+    id: z.ZodString;
+    toolCallId: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        tool: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodString;
+        endedAt: z.ZodOptional<z.ZodString>;
+        outcome: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            ok: "ok";
+            denied: "denied";
+            incomplete: "incomplete";
+        }>>;
+    }, z.core.$strip>>;
+    dropped: z.ZodNumber;
+}, z.core.$strip>;
 export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"data-presentation">;
     id: z.ZodString;
@@ -543,6 +655,7 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"data-plan">;
     id: z.ZodString;
     planId: z.ZodString;
+    parentPlanId: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -574,6 +687,11 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     planId: z.ZodString;
     title: z.ZodString;
     stepCount: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"data-plan-approval">;
+    planId: z.ZodString;
+    runId: z.ZodString;
+    approvedAt: z.ZodISODateTime;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-file-reference">;
     id: z.ZodString;
@@ -596,6 +714,11 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         rejected: "rejected";
         expired: "expired";
     }>;
+    reply: z.ZodOptional<z.ZodEnum<{
+        once: "once";
+        always: "always";
+        reject: "reject";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-run-started">;
     runId: z.ZodString;
@@ -642,6 +765,56 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         warning: "warning";
     }>;
     activity: z.ZodString;
+    at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"data-activity-entry">;
+    id: z.ZodString;
+    runId: z.ZodString;
+    stepId: z.ZodString;
+    phase: z.ZodUnion<readonly [z.ZodEnum<{
+        failed: "failed";
+        complete: "complete";
+        "sandbox-init": "sandbox-init";
+        executing: "executing";
+        "generating-metadata": "generating-metadata";
+        "generating-summary": "generating-summary";
+        indexing: "indexing";
+        persisting: "persisting";
+        retrying: "retrying";
+        warning: "warning";
+    }>, z.ZodEnum<{
+        failed: "failed";
+        skipped: "skipped";
+        complete: "complete";
+        indexing: "indexing";
+        persisting: "persisting";
+        starting: "starting";
+        researching: "researching";
+        drafting: "drafting";
+        validating: "validating";
+        refining: "refining";
+    }>]>;
+    activity: z.ZodString;
+    at: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"data-subagent-activity">;
+    id: z.ZodString;
+    toolCallId: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        callPath: z.ZodArray<z.ZodString>;
+        tool: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodString;
+        endedAt: z.ZodOptional<z.ZodString>;
+        outcome: z.ZodOptional<z.ZodEnum<{
+            error: "error";
+            ok: "ok";
+            denied: "denied";
+            incomplete: "incomplete";
+        }>>;
+    }, z.core.$strip>>;
+    dropped: z.ZodNumber;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"data-step-file-tree">;
     id: z.ZodString;
@@ -722,13 +895,24 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             high: "high";
         }>;
         noveltyStatus: z.ZodEnum<{
-            expected: "expected";
             novel: "novel";
             confirmed: "confirmed";
             partially_confirmed: "partially_confirmed";
             contradicted: "contradicted";
+            expected: "expected";
         }>;
         literatureInterpretation: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            pmid: z.ZodString;
+            citation: z.ZodString;
+            relevance: z.ZodString;
+            concordance: z.ZodEnum<{
+                supports: "supports";
+                contradicts: "contradicts";
+                extends: "extends";
+                contextualizes: "contextualizes";
+            }>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     themes: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -761,6 +945,7 @@ export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         refining: "refining";
     }>;
     activity: z.ZodString;
+    at: z.ZodOptional<z.ZodString>;
     delegationCount: z.ZodOptional<z.ZodNumber>;
     reason: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;

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

@@ -2,6 +2,7 @@
  * Zod schemas for chat data parts — validation at boundaries.
  */
 import { z } from "zod";
+import { ToolCallOutcomeSchema } from "./chat-events.js";
 import { TokenUsageRollupSchema } from "./usage.js";
 // ── Presentation ────────────────────────────────────────────────────
 export const PlanStepSchema = z.object({
@@ -65,6 +66,10 @@ export const PlanPartSchema = z.object({
     type: z.literal("data-plan"),
     id: z.string(),
     planId: z.string().regex(/^pln-[a-f0-9]{8}$/),
+    parentPlanId: z
+        .string()
+        .regex(/^pln-[a-f0-9]{8}$/)
+        .optional(),
     title: z.string().optional(),
     steps: z.array(PlanStepSchema).optional(),
     analytical_narrative: z.string().optional(),
@@ -80,6 +85,13 @@ export const RunCardPartSchema = z.object({
     title: z.string(),
     stepCount: z.number(),
 });
+// ── Plan approval ───────────────────────────────────────────────────
+export const PlanApprovalPartSchema = z.object({
+    type: z.literal("data-plan-approval"),
+    planId: z.string().regex(/^pln-[a-f0-9]{8}$/),
+    runId: z.string(),
+    approvedAt: z.iso.datetime(),
+});
 // ── File reference ──────────────────────────────────────────────────
 export const FileReferenceEntrySchema = z.object({
     path: z.string().min(1),
@@ -101,6 +113,7 @@ export const AskPartSchema = z.object({
     command: z.string(),
     detail: z.string().optional(),
     status: AskStatusSchema,
+    reply: z.enum(["once", "always", "reject"]).optional(),
 });
 // ── Run Started ─────────────────────────────────────────────────────
 export const RunStartedPartSchema = z.object({
@@ -134,6 +147,18 @@ export const DagStatePartSchema = z
 })
     .strict();
 // ── Step Activity ───────────────────────────────────────────────────
+export const SynthesisPhaseSchema = z.enum([
+    "starting",
+    "researching",
+    "drafting",
+    "validating",
+    "refining",
+    "indexing",
+    "persisting",
+    "complete",
+    "skipped",
+    "failed",
+]);
 export const StepPhaseSchema = z.enum([
     "sandbox-init",
     "executing",
@@ -153,6 +178,16 @@ export const StepActivityPartSchema = z.object({
     stepId: z.string(),
     phase: StepPhaseSchema,
     activity: z.string(),
+    at: z.string().optional(),
+});
+export const ActivityEntryPartSchema = z.object({
+    type: z.literal("data-activity-entry"),
+    id: z.string(),
+    runId: z.string(),
+    stepId: z.string(),
+    phase: z.union([StepPhaseSchema, SynthesisPhaseSchema]),
+    activity: z.string(),
+    at: z.string(),
 });
 // ── Step File Tree ──────────────────────────────────────────────────
 export const FileTreeEntrySchema = z.object({
@@ -230,6 +265,12 @@ export const RunCompletedPartSchema = z.object({
     usage: TokenUsageRollupSchema.optional(),
 });
 // ── Run Synthesis ──────────────────────────────────────────────────
+export const FindingReferenceSchema = z.object({
+    pmid: z.string(),
+    citation: z.string(),
+    relevance: z.string(),
+    concordance: z.enum(["supports", "contradicts", "extends", "contextualizes"]),
+});
 export const SynthesizedFindingSchema = z.object({
     stepId: z.string(),
     title: z.string(),
@@ -237,6 +278,7 @@ export const SynthesizedFindingSchema = z.object({
     confidence: z.enum(["high", "medium", "low"]),
     noveltyStatus: z.enum(["novel", "confirmed", "partially_confirmed", "contradicted", "expected"]),
     literatureInterpretation: z.string(),
+    references: z.array(FindingReferenceSchema),
 });
 export const BiologicalThemeSchema = z.object({
     name: z.string(),
@@ -259,24 +301,13 @@ export const RunSynthesisPartSchema = z.object({
     })),
 });
 // ── Synthesis Progress ─────────────────────────────────────────────
-export const SynthesisPhaseSchema = z.enum([
-    "starting",
-    "researching",
-    "drafting",
-    "validating",
-    "refining",
-    "indexing",
-    "persisting",
-    "complete",
-    "skipped",
-    "failed",
-]);
 export const SynthesisProgressPartSchema = z.object({
     type: z.literal("data-synthesis-progress"),
     id: z.string(),
     runId: z.string(),
     phase: SynthesisPhaseSchema,
     activity: z.string(),
+    at: z.string().optional(),
     delegationCount: z.number().int().nonnegative().optional(),
     reason: z.string().optional(),
     error: z.string().optional(),
@@ -314,16 +345,36 @@ export const CompactionPartSchema = z.object({
     durationMs: z.number().int().nonnegative().optional(),
     trigger: z.enum(["turn-start", "mid-turn"]).optional(),
 });
+// ── Sub-agent activity ──────────────────────────────────────────────
+export const SubAgentActivityEntrySchema = z.object({
+    agentId: z.string(),
+    callPath: z.array(z.string()),
+    tool: z.string(),
+    label: z.string().optional(),
+    startedAt: z.string(),
+    endedAt: z.string().optional(),
+    outcome: ToolCallOutcomeSchema.optional(),
+});
+export const SubAgentActivityPartSchema = z.object({
+    type: z.literal("data-subagent-activity"),
+    id: z.string(),
+    toolCallId: z.string(),
+    entries: z.array(SubAgentActivityEntrySchema),
+    dropped: z.number().int().nonnegative(),
+});
 // ── Union ───────────────────────────────────────────────────────────
 export const ChatPartSchema = z.discriminatedUnion("type", [
     PresentationPartSchema,
     PlanPartSchema,
     RunCardPartSchema,
+    PlanApprovalPartSchema,
     FileReferencePartSchema,
     AskPartSchema,
     RunStartedPartSchema,
     DagStatePartSchema,
     StepActivityPartSchema,
+    ActivityEntryPartSchema,
+    SubAgentActivityPartSchema,
     StepFileTreePartSchema,
     StepOutputPartSchema,
     StepSummaryPartSchema,

package/dist/contracts/schemas/index.d.ts

@@ -1,3 +1,3 @@
-export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, ChatPartSchema, } from "./chat-parts.js";
+export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, PlanApprovalPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, ActivityEntryPartSchema, SubAgentActivityEntrySchema, SubAgentActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, FindingReferenceSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, ChatPartSchema, } from "./chat-parts.js";
 export { EventSourceSchema, TextDeltaEventSchema, IterationEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, ChatEventSchema, } from "./chat-events.js";
 export { TokenUsageRollupSchema } from "./usage.js";

package/dist/contracts/schemas/index.js

@@ -1,3 +1,3 @@
-export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, ChatPartSchema, } from "./chat-parts.js";
+export { PlanStepSchema, PresentationContentSchema, PresentationPartSchema, PlanPartSchema, RunCardPartSchema, PlanApprovalPartSchema, FileReferenceEntrySchema, FileReferencePartSchema, RunStartedPartSchema, StepStatusSchema, DagStepStateSchema, DagStatePartSchema, StepPhaseSchema, StepActivityPartSchema, ActivityEntryPartSchema, SubAgentActivityEntrySchema, SubAgentActivityPartSchema, FileTreeEntrySchema, StepFileTreePartSchema, StepOutputFileSchema, StepOutputPartSchema, StepSummaryPartSchema, StepUsagePartSchema, StepBlockedPartSchema, FindingReferenceSchema, SynthesizedFindingSchema, BiologicalThemeSchema, RunSynthesisPartSchema, SynthesisPhaseSchema, SynthesisProgressPartSchema, RunCompletedFindingSchema, RunCompletedPartSchema, RunFailedPartSchema, ChatPartSchema, } from "./chat-parts.js";
 export { EventSourceSchema, TextDeltaEventSchema, IterationEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, ChatEventSchema, } from "./chat-events.js";
 export { TokenUsageRollupSchema } from "./usage.js";

package/dist/contracts/subagent-activity.d.ts

@@ -0,0 +1,12 @@
+import type { ChatFrame, ChatPartFrame } from "./chat-events.js";
+/** The most entries that one root tool call holds. Each later call of its sub-agents only adds to `dropped`. */
+export declare const SUBAGENT_ACTIVITY_MAX_ENTRIES = 200;
+export interface SubAgentActivityTracker {
+    /**
+     * Read one frame of the turn, from the root agent or from a sub-agent, with the time of its receipt in
+     * milliseconds. Gives the new `data-subagent-activity` part frame (no source) when the frame changes the activity
+     * of a root tool call, else `null`.
+     */
+    track(frame: ChatFrame, nowMs: number): ChatPartFrame | null;
+}
+export declare function createSubAgentActivityTracker(): SubAgentActivityTracker;

package/dist/contracts/subagent-activity.js

@@ -0,0 +1,76 @@
+// The sub-agent activity of a chat turn, beside `applyChatFrame`. Browser-safe: each import from outside `contracts/` is a type import.
+/** The most entries that one root tool call holds. Each later call of its sub-agents only adds to `dropped`. */
+export const SUBAGENT_ACTIVITY_MAX_ENTRIES = 200;
+// A call id is unique only inside the loop that made the call, thus the call path of that loop is part of the key.
+// The path is the lineage of the sub-agent, the same read as `isRootFrame`. No control flow of the harness uses it.
+function callKey(loopPath, callId) {
+    return JSON.stringify([loopPath, callId]);
+}
+export function createSubAgentActivityTracker() {
+    // A dropped call stays in the map, thus a deeper call below it still counts in `dropped`.
+    const calls = new Map();
+    const records = new Map();
+    const partOf = (rootId, record) => ({
+        type: "data-subagent-activity",
+        id: `subagent-activity-${rootId}`,
+        toolCallId: rootId,
+        entries: record.entries.map((entry) => ({ ...entry, callPath: [...entry.callPath] })),
+        dropped: record.dropped,
+    });
+    return {
+        track(frame, nowMs) {
+            if (frame.type !== "tool-started" && frame.type !== "tool-finished")
+                return null;
+            const { source } = frame;
+            if (frame.type === "tool-started") {
+                if (source.callPath.length <= 1) {
+                    calls.set(callKey(source.callPath, frame.toolUseId), { rootId: frame.toolUseId, startedMs: nowMs });
+                    return null;
+                }
+                if (source.invocationId === undefined)
+                    return null;
+                const parent = calls.get(callKey(source.callPath.slice(0, -1), source.invocationId));
+                if (parent === undefined)
+                    return null;
+                let record = records.get(parent.rootId);
+                if (record === undefined) {
+                    record = { entries: [], dropped: 0 };
+                    records.set(parent.rootId, record);
+                }
+                if (record.entries.length >= SUBAGENT_ACTIVITY_MAX_ENTRIES) {
+                    record.dropped += 1;
+                    calls.set(callKey(source.callPath, frame.toolUseId), { rootId: parent.rootId, startedMs: nowMs });
+                }
+                else {
+                    record.entries.push({
+                        agentId: source.agentId,
+                        callPath: [...source.callPath],
+                        tool: frame.name,
+                        ...(frame.detail === undefined ? {} : { label: frame.detail }),
+                        startedAt: new Date(nowMs).toISOString(),
+                    });
+                    calls.set(callKey(source.callPath, frame.toolUseId), {
+                        rootId: parent.rootId,
+                        entryIndex: record.entries.length - 1,
+                        startedMs: nowMs,
+                    });
+                }
+                return partOf(parent.rootId, record);
+            }
+            if (source.callPath.length <= 1)
+                return null;
+            const call = calls.get(callKey(source.callPath, frame.toolUseId));
+            if (call?.entryIndex === undefined)
+                return null;
+            const record = records.get(call.rootId);
+            const entry = record?.entries[call.entryIndex];
+            if (record === undefined || entry === undefined)
+                return null;
+            entry.outcome = frame.outcome;
+            if (frame.detail !== undefined)
+                entry.label = frame.detail;
+            entry.endedAt = new Date(frame.durationMs === undefined ? nowMs : call.startedMs + frame.durationMs).toISOString();
+            return partOf(call.rootId, record);
+        },
+    };
+}

package/dist/execution/artifact-metadata.js

@@ -78,9 +78,7 @@ function fileExtension(displayPath) {
  * composed from facts already on disk so search still finds the file.
  */
 function fallbackEntry(artifact, extra) {
-    // Leading slash so `inferArtifactType` matches the `/figures/` etc. segment
-    // on a working-directory-relative display path.
-    const fileType = inferArtifactType(`/${artifact.displayPath}`);
+    const fileType = inferArtifactType(artifact.displayPath);
     const format = fileExtension(artifact.displayPath);
     const sizePart = artifact.sizeBytes != null ? `, ${artifact.sizeBytes} bytes` : "";
     const description = `${artifact.displayPath} — ${fileType} file (${format}${sizePart}); automated description unavailable.`;

package/dist/execution/post-step-pipeline.js

@@ -116,7 +116,7 @@ export function describeStepRegistrationFailure(failure) {
 export async function reconcileAndRegisterStepArtifacts(deps, postCtx, manifest) {
     const { input, session, lineageCollector } = postCtx;
     const reconciled = await reconcileManifestWithDisk({
-        workspaceRoot: deps.resolveWorkspaceRoot(input.analysisId),
+        workspaceRoot: await deps.resolveWorkspaceRoot(input.analysisId),
         resourceId: input.analysisId,
         runId: input.runId,
         stepId: input.stepId,

package/dist/execution/run-canceler.js

@@ -36,7 +36,7 @@ export class UnknownRunError extends Error {
         this.name = "UnknownRunError";
     }
 }
-const TERMINAL = new Set(["completed", "partial", "failed", "canceled"]);
+const TERMINAL = new Set(["completed", "partial", "failed", "canceled", "suspended_insufficient_funds"]);
 export function createRunCanceler(deps) {
     const { pool, runCharge, runAuthorizer } = deps;
     const logger = (deps.logger ?? createNoopLogger()).named("run-canceler");

package/dist/execution/run-event-parts.d.ts

@@ -19,11 +19,12 @@ import type { ChatPart } from "../contracts/chat-parts.js";
  * newer than the reader.
  *
  * The registry is keyed by the discriminant alone, so this validates `type` and
- * trusts the producer for the payload. There is no per-part schema to validate
- * against: `contracts/chat-parts.ts` declares interfaces, not Zod objects. Both
- * ends of this stream are typed against that same union inside this package, so
- * the discriminant is the boundary that can actually drift (a producer emitting
- * something else entirely) and the one worth checking.
+ * trusts the producer for the payload. The part schemas in `contracts/schemas/`
+ * are for a consumer at the edge of the package, which parses what it receives.
+ * Both ends of this stream are typed against the same union inside this package,
+ * so the discriminant is the boundary that can drift (a producer that emits
+ * something else entirely), and a part that fails its schema still reaches the
+ * consumer for its own check.
  */
 export declare function parseRunEventPart(value: unknown): ChatPart | null;
 /**