@inflexa-ai/harness 0.45.1 → 0.46.2

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

@@ -8,6 +8,7 @@
  *   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)
+ *   Model retry:     data-model-retry (a retry of a model request inside the retry envelope of the provider)
  *   Run lifecycle:   run-started, dag-state, run-completed, run-failed, run-synthesis,
  *                    synthesis-progress
  *   Per-step live:   step-activity, step-file-tree
@@ -16,7 +17,7 @@
  */
 import type { ToolCallOutcome } from "./chat-events.js";
 import type { TokenUsageRollup } from "./usage.js";
-export interface PlanStep {
+export type PlanStep = {
     id: string;
     name: string;
     agent: string;
@@ -35,7 +36,7 @@ export interface PlanStep {
     acceptance_criteria?: string[];
     constraints?: string[];
     caveats?: string[];
-}
+};
 export type PresentationContent = 
 /** `dataPath` (optional): an analysis-rooted CSV artifact path the host loads and injects as the
  *  chart's `dataset.source` at render time — the data never rides through the context window. */
@@ -71,13 +72,13 @@ export type PresentationContent =
     accession: string;
     version: number;
 };
-export interface PresentationPart {
+export type PresentationPart = {
     type: "data-presentation";
     id: string;
     title?: string;
     content: PresentationContent;
-}
-export interface PlanPart {
+};
+export type PlanPart = {
     type: "data-plan";
     id: string;
     planId: string;
@@ -88,40 +89,40 @@ export interface PlanPart {
     analytical_narrative?: string;
     omicsType?: string;
     omicsSubtype?: string;
-}
-export interface RunCardPart {
+};
+export type RunCardPart = {
     type: "data-run-card";
     id: string;
     runId: string;
     planId: string;
     title: string;
     stepCount: number;
-}
-export interface PlanApprovalPart {
+};
+export type 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 {
+};
+export type FileReferenceEntry = {
     path: string;
     runId?: string;
     caption?: string;
-}
-export interface FileReferencePart {
+};
+export type FileReferencePart = {
     type: "data-file-reference";
     id: string;
     title?: string;
     files: FileReferenceEntry[];
-}
+};
 /**
  * A tool's pending request for an explicit user decision. Re-emitted under the
  * same `id` when the ask reaches a terminal status, so reconciling readers fold
  * pending → outcome latest-wins.
  */
-export interface AskPart {
+export type AskPart = {
     type: "data-ask";
     /** The ask's ledger uuidv7 id — what a surface passes back to `answer`. */
     id: string;
@@ -134,19 +135,19 @@ export interface AskPart {
     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 {
+};
+export type RunStartedPart = {
     type: "data-run-started";
     runId: string;
     planSummary: string;
     stepCount: number;
-}
+};
 /** `"pending"` = waiting on dependencies; `"queued"` = dependencies satisfied,
  *  held until in-flight steps free machine-budget capacity; `"skipped"` =
  *  unreachable — an upstream dependency failed or blocked, so the step can
  *  never be dispatched. */
 export type StepStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
-export interface DagStepState {
+export type DagStepState = {
     id: string;
     name: string;
     agent: string;
@@ -166,16 +167,16 @@ export interface DagStepState {
     summary?: string;
     /** 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 {
+export type DagStatePart = {
     type: "data-dag-state";
     /** Stable ID for reconciliation — same across all updates for a run. */
     id: string;
     runId: string;
     steps: DagStepState[];
-}
+};
 export type StepPhase = "sandbox-init" | "executing" | "generating-metadata" | "generating-summary" | "indexing"
 /** Step bytes are uploading to the artifact store inline (per-step sync). */
  | "persisting" | "complete" | "failed"
@@ -183,7 +184,7 @@ export type StepPhase = "sandbox-init" | "executing" | "generating-metadata" | "
  | "retrying"
 /** Non-fatal warning emitted during step execution (e.g., maxSteps hit). */
  | "warning";
-export interface StepActivityPart {
+export type StepActivityPart = {
     type: "data-step-activity";
     /** Stable ID for reconciliation — unique per step within a run. */
     id: string;
@@ -195,12 +196,12 @@ export interface StepActivityPart {
     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 {
+export type ActivityEntryPart = {
     type: "data-activity-entry";
     /** Unique per emission within a stream. */
     id: string;
@@ -211,13 +212,13 @@ export interface ActivityEntryPart {
     activity: string;
     /** ISO 8601 time of the emission. */
     at: string;
-}
-export interface FileTreeEntry {
+};
+export type FileTreeEntry = {
     path: string;
     size?: number;
     type: "file" | "directory";
-}
-export interface StepFileTreePart {
+};
+export type StepFileTreePart = {
     type: "data-step-file-tree";
     /** Stable ID for reconciliation — unique per step within a run. */
     id: string;
@@ -225,16 +226,16 @@ export interface StepFileTreePart {
     stepId: string;
     /** Current file tree snapshot. May be empty if sandbox hasn't written to disk yet. */
     files: FileTreeEntry[];
-}
-export interface StepOutputFile {
+};
+export type StepOutputFile = {
     path: string;
     size: number;
     /** File category for grouping/icons. */
     fileType: "script" | "output" | "figure" | "log" | "notebook" | "summary";
     /** LLM-generated description of the file contents. */
     description: string;
-}
-export interface StepOutputPart {
+};
+export type StepOutputPart = {
     type: "data-step-output";
     id: string;
     runId: string;
@@ -247,9 +248,9 @@ export interface StepOutputPart {
     finishReason?: string;
     /** True when the agent exhausted its maxSteps turn budget. */
     hitMaxSteps?: boolean;
-}
+};
 /** Step summary — free-form markdown body, rendered verbatim by the UI. */
-export interface StepSummaryPart {
+export type StepSummaryPart = {
     type: "data-step-summary";
     id: string;
     runId: string;
@@ -257,7 +258,7 @@ export interface StepSummaryPart {
     agentId: string;
     /** Free-form markdown body. Render with a markdown renderer. */
     markdown: string;
-}
+};
 /**
  * What one analysis-run step's agent loop reported spending, emitted when that
  * loop completes.
@@ -270,7 +271,7 @@ export interface StepSummaryPart {
  * Scoped to analysis runs. Workflows without step parts (ephemeral runs, data
  * profiling) reach the ledger through the recorder seam and carry no usage part.
  */
-export interface StepUsagePart {
+export type StepUsagePart = {
     type: "data-step-usage";
     /** Stable ID for reconciliation — unique per step within a run. */
     id: string;
@@ -286,13 +287,13 @@ export interface StepUsagePart {
     modelId: string;
     /** Summed token usage across this step loop's LLM calls. */
     usage: TokenUsageRollup;
-}
+};
 /**
  * Emitted when a step agent declares it cannot fulfil its step via
  * `report_blocker` (see the harness-sandbox-agents spec). A blocked step has no deliverables; the
  * reason surfaces in the run side panel.
  */
-export interface StepBlockedPart {
+export type StepBlockedPart = {
     type: "data-step-blocked";
     id: string;
     runId: string;
@@ -300,12 +301,12 @@ export interface StepBlockedPart {
     agentId: string;
     /** Agent-declared reason the step could not be fulfilled. */
     reason: string;
-}
-export interface RunCompletedFinding {
+};
+export type RunCompletedFinding = {
     title: string;
     confidence: "high" | "medium" | "low";
-}
-export interface RunCompletedPart {
+};
+export type RunCompletedPart = {
     type: "data-run-completed";
     runId: string;
     status: "completed" | "partial";
@@ -324,14 +325,14 @@ export interface RunCompletedPart {
      * Absent when no step reported any, never an all-zero figure.
      */
     usage?: TokenUsageRollup;
-}
-export interface FindingReference {
+};
+export type FindingReference = {
     pmid: string;
     citation: string;
     relevance: string;
     concordance: "supports" | "contradicts" | "extends" | "contextualizes";
-}
-export interface SynthesizedFinding {
+};
+export type SynthesizedFinding = {
     stepId: string;
     title: string;
     description: string;
@@ -339,16 +340,16 @@ export interface SynthesizedFinding {
     noveltyStatus: "novel" | "confirmed" | "partially_confirmed" | "contradicted" | "expected";
     literatureInterpretation: string;
     references: FindingReference[];
-}
-export interface BiologicalTheme {
+};
+export type BiologicalTheme = {
     name: string;
     findings: {
         stepId: string;
         title: string;
     }[];
     narrative: string;
-}
-export interface RunSynthesisPart {
+};
+export type RunSynthesisPart = {
     type: "data-run-synthesis";
     id: string;
     runId: string;
@@ -362,7 +363,7 @@ export interface RunSynthesisPart {
         citation: string;
         description: string;
     }[];
-}
+};
 export type SynthesisPhase = "starting" | "researching" | "drafting" | "validating" | "refining" | "indexing" | "persisting" | "complete"
 /**
  * Synthesizer chose to skip (e.g., technical-only run, summaries with no
@@ -370,7 +371,7 @@ export type SynthesisPhase = "starting" | "researching" | "drafting" | "validati
  * intentional outcome, not a breakage.
  */
  | "skipped" | "failed";
-export interface SynthesisProgressPart {
+export type SynthesisProgressPart = {
     type: "data-synthesis-progress";
     /** Stable ID for reconciliation — `synthesis-progress-{runId}`. */
     id: string;
@@ -386,8 +387,8 @@ export interface SynthesisProgressPart {
     reason?: string;
     /** Error message — set when phase === "failed". */
     error?: string;
-}
-export interface RunFailedPart {
+};
+export type RunFailedPart = {
     type: "data-run-failed";
     runId: string;
     /** Scrubbed error message (no internal details). */
@@ -397,7 +398,7 @@ export interface RunFailedPart {
      * `canceled` when an external cancel ended the run. Absent for a failure.
      */
     reason?: string;
-}
+};
 /**
  * The record that a turn started a child session. It rides the chat stream
  * live, and it persists into the turn at the position of the spawn.
@@ -407,7 +408,7 @@ export interface RunFailedPart {
  * archived state. When the thread of the part is archived or absent, a
  * consumer renders nothing for it.
  */
-export interface ChildSessionStartedPart {
+export type ChildSessionStartedPart = {
     type: "data-child-session-started";
     /** The id of the child thread that the spawn made. */
     threadId: string;
@@ -418,7 +419,7 @@ export interface ChildSessionStartedPart {
      * Known values today: `"report"`.
      */
     threadType: string;
-}
+};
 /**
  * The record that a report-session preview rendered the page. It rides the
  * chat stream live, and it persists into the turn at the position of the
@@ -429,7 +430,7 @@ export interface ChildSessionStartedPart {
  * the part carries no path, no format, and no URL. A consumer that wants the
  * page reads those surfaces.
  */
-export interface ReportRenderedPart {
+export type ReportRenderedPart = {
     type: "data-report-rendered";
     /** Unique per emission. */
     id: string;
@@ -437,9 +438,9 @@ export interface ReportRenderedPart {
     renderedAt: string;
     /** The title of the rendered document. */
     title?: string;
-}
+};
 /** One compaction of the thread: `running`, then `done` or `failed` under the same id. A reload shows it as a divider. */
-export interface CompactionPart {
+export type CompactionPart = {
     type: "data-compaction";
     id: string;
     status: "running" | "done" | "failed";
@@ -450,9 +451,9 @@ export interface CompactionPart {
     durationMs?: number;
     /** Before the user message of a turn, or before a later request. */
     trigger?: "turn-start" | "mid-turn";
-}
+};
 /** One tool call of a sub-agent. It holds no input, no output, and no text of the sub-agent. */
-export interface SubAgentActivityEntry {
+export type SubAgentActivityEntry = {
     agentId: string;
     callPath: string[];
     tool: string;
@@ -464,12 +465,12 @@ export interface SubAgentActivityEntry {
     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 {
+export type SubAgentActivityPart = {
     type: "data-subagent-activity";
     id: string;
     /** The id of the root tool call. */
@@ -477,5 +478,67 @@ export interface SubAgentActivityPart {
     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;
+};
+/**
+ * Why durable work waits: a provider outage that outlived its retries, a refusal of the host with its reason, or a
+ * credential that the endpoint refused or that the host did not give.
+ */
+export type PauseCause = {
+    readonly kind: "outage";
+} | {
+    readonly kind: "credential";
+} | {
+    readonly kind: "host";
+    readonly reason: string;
+};
+/**
+ * One retry of a model request inside the retry envelope of the provider, before the wait of that retry. Re-emitted
+ * under the same `id` for each retry of the request. A later frame of the same agent ends it: the request then gave
+ * a reply, or it failed after the last retry.
+ */
+export type ModelRetryPart = {
+    type: "data-model-retry";
+    /** The id of the model request. */
+    id: string;
+    /** The number of this retry, from 1. */
+    attempt: number;
+    /** The count of retries that the envelope makes before it gives up. */
+    maxRetries: number;
+    /** ISO 8601. The time of the next attempt. */
+    retryAt: string;
+    /** The HTTP status of the failed attempt. Absent for a failure with no status, for example a lost connection. */
+    status?: number;
+};
+/** The kind of a durable work, and of the work that a pause belongs to. A sub-agent belongs to its turn, and a sandbox step to its run. */
+export type WorkKind = "turn" | "run" | "profile";
+/**
+ * The state of one waiting workflow of paused work. Re-emitted under the same `id` when the wait ends, with the
+ * state `running`, so reconciling readers keep the latest state of each workflow.
+ */
+export type PausePart = {
+    type: "data-pause";
+    /** The id of the workflow that waits. */
+    id: string;
+    /** The id of the work: the turn, the run, or the profile workflow. A resume names it. */
+    workId: string;
+    workKind: WorkKind;
+    /** `retrying`: the system sends the request again at `retryAt`. `paused`: only a resume ends the wait. */
+    state: "retrying" | "paused" | "running";
+    /** Absent for the state `running`. */
+    cause?: PauseCause;
+    /** The count of timer retries before this wait. Absent for the state `running`. */
+    attempt?: number;
+    /** ISO 8601. Present for the state `retrying` only. */
+    retryAt?: string;
+};
+/** The parts whose contracts this version of the package declares — the arms the part registry knows. */
+export type KnownChatPart = PresentationPart | PlanPart | RunCardPart | PlanApprovalPart | FileReferencePart | AskPart | RunStartedPart | DagStatePart | StepActivityPart | ActivityEntryPart | SubAgentActivityPart | StepFileTreePart | StepOutputPart | StepSummaryPart | StepUsagePart | StepBlockedPart | RunSynthesisPart | SynthesisProgressPart | RunCompletedPart | RunFailedPart | ChildSessionStartedPart | ReportRenderedPart | CompactionPart | PausePart | ModelRetryPart;
+/**
+ * A part of a known contract, or a part whose type this build does not know. An emitter newer than this
+ * build can lead the registry, and such a part already rides through the check boundary and the live view
+ * as the record the emitter sent — so the union admits that record shape, with no change to the stored
+ * payload or to a known part.
+ */
+export type ChatPart = KnownChatPart | ({
+    type: `data-${string}`;
+} & Record<string, unknown>);

package/dist/contracts/chat-parts.js

@@ -8,6 +8,7 @@
  *   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)
+ *   Model retry:     data-model-retry (a retry of a model request inside the retry envelope of the provider)
  *   Run lifecycle:   run-started, dag-state, run-completed, run-failed, run-synthesis,
  *                    synthesis-progress
  *   Per-step live:   step-activity, step-file-tree

package/dist/contracts/content-url.js

@@ -50,8 +50,22 @@ export function reportSessionResourceId(analysisId, threadId) {
  * @param token - Short-lived content token minted by the storage backend (required)
  */
 export function buildReportSessionUrl(contentBaseUrl, analysisId, threadId, pagePath, token) {
-    const base = contentBaseUrl.replace(/\/+$/, "");
-    const path = pagePath.replace(/^\/+/, "");
+    const base = stripTrailingSlashes(contentBaseUrl);
+    const path = stripLeadingSlashes(pagePath);
     const res = reportSessionResourceId(analysisId, threadId);
     return `${base}/${res}/${path}?t=${encodeURIComponent(token)}`;
 }
+/** The text without its trailing slashes. */
+function stripTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value.charAt(end - 1) === "/")
+        end--;
+    return value.slice(0, end);
+}
+/** The text without its leading slashes. */
+function stripLeadingSlashes(value) {
+    let start = 0;
+    while (start < value.length && value.charAt(start) === "/")
+        start++;
+    return value.slice(start);
+}