@inflexa-ai/harness 0.41.1 → 0.42.0

package/dist/contracts/report-blocks.d.ts

@@ -190,8 +190,8 @@ export declare const ChartAnnotationSchema: z.ZodDiscriminatedUnion<[z.ZodObject
     kind: z.ZodLiteral<"point-labels">;
     column: z.ZodString;
     order: z.ZodEnum<{
-        desc: "desc";
         asc: "asc";
+        desc: "desc";
     }>;
     n: z.ZodNumber;
 }, z.core.$strict>], "kind">;
@@ -288,8 +288,8 @@ export declare const ChartCompositionSchema: z.ZodObject<{
         kind: z.ZodLiteral<"point-labels">;
         column: z.ZodString;
         order: z.ZodEnum<{
-            desc: "desc";
             asc: "asc";
+            desc: "desc";
         }>;
         n: z.ZodNumber;
     }, z.core.$strict>], "kind">>>;
@@ -367,8 +367,8 @@ export declare const ClaimBlockSchema: z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -519,8 +519,8 @@ export declare const TableBlockSchema: z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -561,8 +561,8 @@ export declare const ChartBlockSchema: z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -715,8 +715,8 @@ export declare const ChartBlockSchema: z.ZodObject<{
             kind: z.ZodLiteral<"point-labels">;
             column: z.ZodString;
             order: z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>;
             n: z.ZodNumber;
         }, z.core.$strict>], "kind">>>;
@@ -826,8 +826,8 @@ export declare const ATOM_BLOCK_SCHEMAS: readonly [z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -974,8 +974,8 @@ export declare const ATOM_BLOCK_SCHEMAS: readonly [z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1005,8 +1005,8 @@ export declare const ATOM_BLOCK_SCHEMAS: readonly [z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1159,8 +1159,8 @@ export declare const ATOM_BLOCK_SCHEMAS: readonly [z.ZodObject<{
             kind: z.ZodLiteral<"point-labels">;
             column: z.ZodString;
             order: z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>;
             n: z.ZodNumber;
         }, z.core.$strict>], "kind">>>;

package/dist/contracts/report-reference.d.ts

@@ -59,8 +59,8 @@ export declare const RowBoundSchema: z.ZodObject<{
     column: z.ZodString;
     count: z.ZodNumber;
     order: z.ZodOptional<z.ZodEnum<{
-        desc: "desc";
         asc: "asc";
+        desc: "desc";
     }>>;
 }, z.core.$strict>;
 /**
@@ -79,8 +79,8 @@ export declare const ArtifactTableReferenceSchema: z.ZodObject<{
         column: z.ZodString;
         count: z.ZodNumber;
         order: z.ZodOptional<z.ZodEnum<{
-            desc: "desc";
             asc: "asc";
+            desc: "desc";
         }>>;
     }, z.core.$strict>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -231,8 +231,8 @@ export declare const ReferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         column: z.ZodString;
         count: z.ZodNumber;
         order: z.ZodOptional<z.ZodEnum<{
-            desc: "desc";
             asc: "asc";
+            desc: "desc";
         }>>;
     }, z.core.$strict>>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -417,8 +417,8 @@ export declare const UnresolvedReferenceSchema: z.ZodObject<{
             column: z.ZodString;
             count: z.ZodNumber;
             order: z.ZodOptional<z.ZodEnum<{
-                desc: "desc";
                 asc: "asc";
+                desc: "desc";
             }>>;
         }, z.core.$strict>>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString>>;

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

@@ -1,5 +1,5 @@
 /**
- * Zod schemas for Cortex-native chat-stream events — validation at boundaries.
+ * Zod schemas for chat-stream events — validation at boundaries.
  */
 import { z } from "zod";
 export declare const EventSourceSchema: z.ZodObject<{
@@ -83,7 +83,7 @@ export declare const ChatErrorEventSchema: z.ZodObject<{
         callPath: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>;
-export declare const CortexChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text-delta">;
     text: z.ZodString;
     source: z.ZodObject<{

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

@@ -1,5 +1,5 @@
 /**
- * Zod schemas for Cortex-native chat-stream events — validation at boundaries.
+ * Zod schemas for chat-stream events — validation at boundaries.
  */
 import { z } from "zod";
 import { TokenUsageRollupSchema } from "./usage.js";
@@ -45,7 +45,7 @@ export const ChatErrorEventSchema = z.object({
     reason: z.string().optional(),
     source: EventSourceSchema,
 });
-export const CortexChatEventSchema = z.discriminatedUnion("type", [
+export const ChatEventSchema = z.discriminatedUnion("type", [
     TextDeltaEventSchema,
     ToolStartedEventSchema,
     ToolFinishedEventSchema,

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

@@ -1,5 +1,5 @@
 /**
- * Zod schemas for Cortex chat data parts — validation at boundaries.
+ * Zod schemas for chat data parts — validation at boundaries.
  */
 import { z } from "zod";
 export declare const PlanStepSchema: z.ZodObject<{
@@ -11,8 +11,16 @@ export declare const PlanStepSchema: z.ZodObject<{
     resources: z.ZodOptional<z.ZodObject<{
         cpu: z.ZodNumber;
         memoryGb: z.ZodNumber;
+        gpu: z.ZodOptional<z.ZodObject<{
+            count: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     maxSteps: z.ZodNumber;
+    track: z.ZodOptional<z.ZodString>;
+    step_type: z.ZodOptional<z.ZodString>;
+    acceptance_criteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export declare const PresentationContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"echart">;
@@ -93,8 +101,16 @@ export declare const PlanPartSchema: z.ZodObject<{
         resources: z.ZodOptional<z.ZodObject<{
             cpu: z.ZodNumber;
             memoryGb: z.ZodNumber;
+            gpu: z.ZodOptional<z.ZodObject<{
+                count: z.ZodNumber;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         maxSteps: z.ZodNumber;
+        track: z.ZodOptional<z.ZodString>;
+        step_type: z.ZodOptional<z.ZodString>;
+        acceptance_criteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
     analytical_narrative: z.ZodOptional<z.ZodString>;
     omicsType: z.ZodOptional<z.ZodString>;
@@ -484,8 +500,12 @@ export declare const CompactionPartSchema: z.ZodObject<{
     tokensBefore: z.ZodNumber;
     tokensAfter: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
+    trigger: z.ZodOptional<z.ZodEnum<{
+        "turn-start": "turn-start";
+        "mid-turn": "mid-turn";
+    }>>;
 }, z.core.$strip>;
-export declare const CortexChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare const ChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"data-presentation">;
     id: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
@@ -533,8 +553,16 @@ export declare const CortexChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
         resources: z.ZodOptional<z.ZodObject<{
             cpu: z.ZodNumber;
             memoryGb: z.ZodNumber;
+            gpu: z.ZodOptional<z.ZodObject<{
+                count: z.ZodNumber;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         maxSteps: z.ZodNumber;
+        track: z.ZodOptional<z.ZodString>;
+        step_type: z.ZodOptional<z.ZodString>;
+        acceptance_criteria: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        caveats: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
     analytical_narrative: z.ZodOptional<z.ZodString>;
     omicsType: z.ZodOptional<z.ZodString>;
@@ -788,4 +816,8 @@ export declare const CortexChatPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     tokensBefore: z.ZodNumber;
     tokensAfter: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
+    trigger: z.ZodOptional<z.ZodEnum<{
+        "turn-start": "turn-start";
+        "mid-turn": "mid-turn";
+    }>>;
 }, z.core.$strip>], "type">;

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

@@ -1,5 +1,5 @@
 /**
- * Zod schemas for Cortex chat data parts — validation at boundaries.
+ * Zod schemas for chat data parts — validation at boundaries.
  */
 import { z } from "zod";
 import { TokenUsageRollupSchema } from "./usage.js";
@@ -10,8 +10,13 @@ export const PlanStepSchema = z.object({
     agent: z.string(),
     question: z.string(),
     depends_on: z.array(z.string()),
-    resources: z.object({ cpu: z.number(), memoryGb: z.number() }).optional(),
+    resources: z.object({ cpu: z.number(), memoryGb: z.number(), gpu: z.object({ count: z.number() }).optional() }).optional(),
     maxSteps: z.number(),
+    track: z.string().optional(),
+    step_type: z.string().optional(),
+    acceptance_criteria: z.array(z.string()).optional(),
+    constraints: z.array(z.string()).optional(),
+    caveats: z.array(z.string()).optional(),
 });
 export const PresentationContentSchema = z.discriminatedUnion("kind", [
     z.object({
@@ -307,9 +312,10 @@ export const CompactionPartSchema = z.object({
     tokensBefore: z.number().int().nonnegative(),
     tokensAfter: z.number().int().nonnegative().optional(),
     durationMs: z.number().int().nonnegative().optional(),
+    trigger: z.enum(["turn-start", "mid-turn"]).optional(),
 });
 // ── Union ───────────────────────────────────────────────────────────
-export const CortexChatPartSchema = z.discriminatedUnion("type", [
+export const ChatPartSchema = z.discriminatedUnion("type", [
     PresentationPartSchema,
     PlanPartSchema,
     RunCardPartSchema,

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, CortexChatPartSchema, } from "./chat-parts.js";
-export { EventSourceSchema, TextDeltaEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, CortexChatEventSchema, } from "./chat-events.js";
+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 { EventSourceSchema, TextDeltaEventSchema, 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, CortexChatPartSchema, } from "./chat-parts.js";
-export { EventSourceSchema, TextDeltaEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, CortexChatEventSchema, } from "./chat-events.js";
+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 { EventSourceSchema, TextDeltaEventSchema, ToolStartedEventSchema, ToolFinishedEventSchema, FinishEventSchema, ChatErrorEventSchema, ChatEventSchema, } from "./chat-events.js";
 export { TokenUsageRollupSchema } from "./usage.js";

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

@@ -8,14 +8,14 @@
  * durability engine, no clock — and keeping them here is what lets that be
  * proven directly instead of inferred from a driven subscription.
  */
-import type { CortexChatPart } from "../contracts/chat-parts.js";
+import type { ChatPart } from "../contracts/chat-parts.js";
 /**
  * Narrow one raw stream value to a chat data part, or `null` when it is not one.
  *
  * A run's streams carry more than the contract: a sandbox step also writes its
  * loop orchestration under envelopes (`data-loop-event`, `data-sandbox-event`)
  * that belong to the workflow layer and have no registry entry. The seam's
- * contract is the `CortexChatPart` union, so anything the registry does not
+ * contract is the `ChatPart` union, so anything the registry does not
  * classify is not deliverable — which also covers a part written by a producer
  * newer than the reader.
  *
@@ -26,7 +26,7 @@ import type { CortexChatPart } from "../contracts/chat-parts.js";
  * the discriminant is the boundary that can actually drift (a producer emitting
  * something else entirely) and the one worth checking.
  */
-export declare function parseRunEventPart(value: unknown): CortexChatPart | null;
+export declare function parseRunEventPart(value: unknown): ChatPart | null;
 /**
  * Collapse a batch of parts so each reconciling id appears once, carrying its
  * latest value, and every other part survives untouched in write order.
@@ -41,4 +41,4 @@ export declare function parseRunEventPart(value: unknown): CortexChatPart | null
  * A survivor keeps the position of its LAST occurrence, so relative order among
  * the parts that are delivered is the order they were written.
  */
-export declare function foldRunEventParts(parts: readonly CortexChatPart[]): CortexChatPart[];
+export declare function foldRunEventParts(parts: readonly ChatPart[]): ChatPart[];

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

@@ -31,7 +31,7 @@
  * writer it observes.
  */
 import type { Pool } from "pg";
-import type { CortexChatPart } from "../contracts/chat-parts.js";
+import type { ChatPart } from "../contracts/chat-parts.js";
 import type { Logger } from "../lib/logger.js";
 /**
  * Construction-time dependencies. The pool is the application pool the run
@@ -48,7 +48,7 @@ export interface RunEventStreamDeps {
  * never invoked concurrently with itself and back-pressure is the caller's to
  * exert by taking its time. A throw is logged and swallowed.
  */
-export type RunEventPartHandler = (part: CortexChatPart) => void | Promise<void>;
+export type RunEventPartHandler = (part: ChatPart) => void | Promise<void>;
 /** Call-time parameters of one subscription. */
 export interface RunEventSubscribeOptions {
     /** The run to observe. Also the parent workflow's id. */

package/dist/index.d.ts

@@ -60,7 +60,7 @@ export { UnavailableAsk, AskRejectedError } from "./tools/approval/contract.js";
 export type { Ask, AskRequest, AskReply, AskApproval } from "./tools/approval/contract.js";
 export { runAgent, finalText } from "./loop/run-agent.js";
 export type { RunAgentOptions, RunAgentResult, AgentFinish, AgentRound } from "./loop/run-agent.js";
-export type { CompactionPolicy } from "./loop/compaction.js";
+export type { CompactionPolicy, CompactionRules } from "./loop/compaction.js";
 export type { ToolMask } from "./loop/tool-mask.js";
 export type { AgentDefinition, RunStep, EmitFn, EmitEvent, EventSource } from "./loop/types.js";
 export type { KeptToolOutput, ToolOutputStore } from "./loop/tool-output.js";
@@ -82,7 +82,7 @@ export type { SuspendOn } from "./providers/errors.js";
 export { suspensionOfFailure } from "./workflows/suspension.js";
 export type { Suspension } from "./workflows/suspension.js";
 export { createStreamingChat } from "./providers/streaming-chat.js";
-export { DEFAULT_CONVERSATION_BUDGET, openChatTurn, prepareChatTurn, runChatTurn } from "./app/chat-turn.js";
+export { openChatTurn, prepareChatTurn, runChatTurn } from "./app/chat-turn.js";
 export type { ChatTurnOutcome, ChatTurnRan, ChatTurnRefusal, ChatTurnResult, ChatTurnSession, OpenChatTurn, OpenChatTurnParams, PrepareChatTurnDeps, PrepareChatTurnParams, PrepareChatTurnResult, RunChatTurnDeps, RunChatTurnParams, RunOpenChatTurnParams, } from "./app/chat-turn.js";
 export { createThreadStore } from "./memory/thread-store.js";
 export type { ThreadStore, Thread, ThreadType, ThreadInputError, CreateThreadInput, ListThreadsInput, ThreadPage } from "./memory/thread-store.js";
@@ -93,12 +93,15 @@ export { createConversationDisplayRecorder } from "./memory/conversation-display
 export type { ConversationDisplayRecorder, ConversationDisplayRecorderOptions } from "./memory/conversation-display-recorder.js";
 export { envelopeDisplayMessages, parseStoredDisplayEnvelope } from "./memory/conversation-display-storage.js";
 export type { ConversationDisplayMetadata, ConversationUIData, ConversationUIMessage, StoredDisplayEnvelope } from "./memory/conversation-display-storage.js";
-export { storedMessagesToCortex } from "./memory/conversation-display-replay.js";
-export type { CortexChatEvent, TextDeltaEvent, ToolStartedEvent, ToolFinishedEvent, ToolOutcome, ToolCallOutcome, ToolCallDetail, FinishEvent, ChatErrorEvent, } from "./contracts/chat-events.js";
+export { storedMessagesToChat } from "./memory/conversation-display-replay.js";
+export type { ChatEvent, ChatFrame, ChatPartFrame, TextDeltaEvent, ToolStartedEvent, ToolFinishedEvent, ToolOutcome, ToolCallOutcome, ToolCallDetail, FinishEvent, ChatErrorEvent, } from "./contracts/chat-events.js";
+export { toChatFrame, applyChatFrame, checkChatPart } from "./contracts/chat-frame.js";
+export type { TextPart, ToolCallPart, MessagePart, ChatMessage } from "./contracts/message.js";
+export type { TurnTerminal, ApplyFrameResult, ChatPartCheck } from "./contracts/chat-frame.js";
 export type { TokenUsageRollup } from "./contracts/usage.js";
-export type { CortexChatPart, PresentationPart, PresentationContent, PlanPart, RunCardPart, FileReferencePart, FileReferenceEntry, RunStartedPart, DagStatePart, DagStepState, StepStatus, StepActivityPart, StepPhase, StepFileTreePart, FileTreeEntry, StepOutputPart, StepOutputFile, StepSummaryPart, StepUsagePart, StepBlockedPart, RunSynthesisPart, SynthesizedFinding, BiologicalTheme, SynthesisProgressPart, SynthesisPhase, RunCompletedPart, RunCompletedFinding, RunFailedPart, CompactionPart, } from "./contracts/chat-parts.js";
+export type { ChatPart, PresentationPart, PresentationContent, PlanPart, RunCardPart, FileReferencePart, FileReferenceEntry, RunStartedPart, DagStatePart, DagStepState, StepStatus, StepActivityPart, StepPhase, StepFileTreePart, FileTreeEntry, StepOutputPart, StepOutputFile, StepSummaryPart, StepUsagePart, StepBlockedPart, RunSynthesisPart, SynthesizedFinding, BiologicalTheme, SynthesisProgressPart, SynthesisPhase, RunCompletedPart, RunCompletedFinding, RunFailedPart, CompactionPart, AskPart, ChildSessionStartedPart, ReportRenderedPart, } from "./contracts/chat-parts.js";
 export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./contracts/part-registry.js";
-export type { CortexChatPartType, PartDescriptor, PartEmitter, PartConsumer } from "./contracts/part-registry.js";
+export type { ChatPartType, PartDescriptor, PartEmitter, PartConsumer } from "./contracts/part-registry.js";
 export { parseStructureUrl, alphafoldEntryUrl, alphafoldPredictionUrl } from "./contracts/structure-source.js";
 export type { StructureSource, StructureFormat } from "./contracts/structure-source.js";
 export { launchDbos, shutdownDbos, sweepEphemeralWorkflows } from "./runtime/dbos.js";

package/dist/index.js

@@ -130,7 +130,7 @@ export { createStreamingChat } from "./providers/streaming-chat.js";
 // and gives only its transport values: the harness stores the opening, each round,
 // and the outcome. `appendTurn` stays for a record of a host. `createThreadStore`
 // owns thread metadata (create/list/title).
-export { DEFAULT_CONVERSATION_BUDGET, openChatTurn, prepareChatTurn, runChatTurn } from "./app/chat-turn.js";
+export { openChatTurn, prepareChatTurn, runChatTurn } from "./app/chat-turn.js";
 export { createThreadStore } from "./memory/thread-store.js";
 export { createThreadHistory, conversationRecordTurn } from "./memory/thread-history.js";
 // The synthetic-message primitives. A host appends a record of out-of-band work (an analysis run's
@@ -154,7 +154,8 @@ export { envelopeDisplayMessages, parseStoredDisplayEnvelope } from "./memory/co
 // along with the startup backfill that was its only caller. `parseStoredDisplayEnvelope` absorbs the
 // one thing a read can now meet and not understand — a part whose key this vocabulary has retired —
 // by dropping that part, so one stale row cannot fail a whole thread.
-export { storedMessagesToCortex } from "./memory/conversation-display-replay.js";
+export { storedMessagesToChat } from "./memory/conversation-display-replay.js";
+export { toChatFrame, applyChatFrame, checkChatPart } from "./contracts/chat-frame.js";
 export { PART_REGISTRY, isTransient, isReconciling, isSidebarPart } from "./contracts/part-registry.js";
 // The source grammar of a `structure` presentation card — a host re-runs the same parse over a
 // persisted `url` before it fetches, so the rule lives in one place for both sides.

package/dist/lib/page-capture.d.ts

@@ -5,12 +5,16 @@
  * readiness signal of the page, and gives back base64 screenshots. The eyes tool of a report session reads
  * this module.
  *
+ * The layout resolves at the CSS width of a reader, and the picture renders at half the device scale. A
+ * picture costs tokens in proportion to its area, thus the half scale lets one look hold a whole report.
+ *
  * A short page captures as one full-page shot. A tall page captures as consecutive vertical slices, because
- * one tall picture dies twice on the provider path: a picture past the hard dimension cap rejects the whole
- * request, and a legal tall picture downscales to about 1568 pixels on the long side, which compresses the
- * text past legibility. A slice of about two window heights survives both. The slice budget bounds what one
- * look costs, and a page past the budget truncates with the captured and the total pixels on the coverage,
- * thus the truncation is never silent.
+ * the model reads a picture whole only up to a limit on the long edge, and a taller picture downscales or
+ * refuses the request. The slice budget bounds what one look costs, and a page past the budget truncates
+ * with the captured and the total pixels on the coverage, thus the truncation is never silent.
+ *
+ * A capture can also take one block alone. The renderer marks each block with its id, and the capture clips
+ * the union box of the marked elements with a margin. A page that holds no such mark gives no picture.
  *
  * The readiness contract is the reason for one shared body. The renderer emits the event name and the
  * sentinel name, and `report-render/page.ts` owns both constants together with the two budgets. This module
@@ -45,6 +49,9 @@ export interface CapturedShot {
  * thus `capturedPx < totalPx` says that the slice budget ran out and the tail of the page is absent. `viewport`
  * appears when a screenshot threw and the retry at the window passed, thus the one picture shows the top
  * window alone and a section below the fold is absent from it.
+ *
+ * `block` is the box of one block and its margin; `capturedPx < totalPx` says that the slice budget cut it.
+ * `no-block` means that no element of the page carries the mark of the block, thus no picture exists.
  */
 export type CaptureCoverage = {
     readonly kind: "full";
@@ -54,10 +61,19 @@ export type CaptureCoverage = {
     readonly totalPx: number;
 } | {
     readonly kind: "viewport";
+} | {
+    readonly kind: "block";
+    readonly capturedPx: number;
+    readonly totalPx: number;
+} | {
+    readonly kind: "no-block";
 };
 /** The pictures and the faults of one page capture. */
 export interface PageCapture {
-    /** The pictures in document order: one shot under `full` and `viewport`, the slices under `tiled`. */
+    /**
+     * The pictures in document order: one shot under `full` and `viewport`, the slices under `tiled` and
+     * `block`, and none under `no-block`.
+     */
     screenshots: CapturedShot[];
     coverage: CaptureCoverage;
     consoleErrors: string[];
@@ -68,13 +84,15 @@ export interface PageCapture {
  * speaks the throw protocol, because the chrome connection does. A test injects a seam that reads no
  * browser, thus a tool orchestration runs with no chrome sidecar.
  */
-export type CapturePage = (url: string) => Promise<PageCapture>;
-/** The extra settle steps that one call site needs. A call site that needs neither passes nothing. */
+export type CapturePage = (url: string, options?: CaptureOptions) => Promise<PageCapture>;
+/** The extra settle steps and the target of one capture. A call site that needs none passes nothing. */
 export interface CaptureOptions {
     /** A CSS selector to wait for after the readiness signal. The wait is best-effort. */
     readonly waitForSelector?: string;
     /** An extra settle time in milliseconds after the readiness signal, for a late paint. */
     readonly waitMs?: number;
+    /** The id of the one block to capture. Absent, the capture takes the whole document. */
+    readonly blockId?: string;
 }
 /**
  * Capture one page: the screenshots, the console errors, and the failed requests.
@@ -82,7 +100,7 @@ export interface CaptureOptions {
  * The pictures hold the document, and not the window alone. Thus a caller can judge a section that a reader
  * reaches by a scroll. A short page arrives as one full-page shot, and a tall page arrives as consecutive
  * slices in document order. A refused bitmap degrades to the window, and the coverage of the result names
- * what the pictures hold.
+ * what the pictures hold. A capture that names a block holds that block alone.
  *
  * The readiness wait is best-effort. A page that never signals still captures at the readiness budget, thus
  * a broken page gives a picture that shows what broke.