@exaudeus/workrail 3.9.1 → 3.10.0

package/README.md

@@ -175,7 +175,7 @@ The agent will find the workflow, start at step 1, and proceed systematically.
 | `coding-task-workflow-agentic` | Feature development with notes-first durability and audit loops |
 | `bug-investigation-agentic` | Systematic debugging with evidence-based analysis |
 | `mr-review-workflow-agentic` | Code review with parallel reviewer families |
-| `exploration-workflow` | Understanding an unfamiliar codebase |
+| `wr.discovery` | Upstream exploration, framing, and design synthesis |
 | `document-creation-workflow` | Technical documentation with structure |
 
 Workflows adapt to complexity - simple tasks get fast-tracked, complex tasks get full rigor.

package/dist/application/services/compiler/feature-registry.js

@@ -11,6 +11,24 @@ const FEATURE_DEFINITIONS = [
             ],
         ],
     },
+    {
+        id: 'wr.features.capabilities',
+        constraints: [
+            'Do not assume optional capabilities are available just because this workflow can use them.',
+            'If delegation, web access, or another optional capability matters here, verify it through a real probe or attempt before relying on it.',
+            'If a capability is unavailable, degrade explicitly instead of silently acting as if it existed.',
+        ],
+        procedure: [
+            'When an optional capability would materially affect the quality of this step, decide whether using it is worth it here.',
+            'If you take a capability-dependent path, record the observation or attempt that justified it.',
+            'If you skip delegation or another optional capability, keep going yourself and record why the fallback path is sufficient.',
+        ],
+        verify: [
+            'No capability-dependent path was taken without an explicit observation, probe, or attempted use.',
+            'If a capability was unavailable or skipped, the fallback path and its limitation were made explicit.',
+            'The main agent still owns synthesis and final judgment.',
+        ],
+    },
     {
         id: 'wr.features.subagent_guidance',
         constraints: [

package/dist/manifest.json

@@ -14,8 +14,8 @@
       "bytes": 740
     },
     "application/services/compiler/feature-registry.js": {
-      "sha256": "350bc4b849426ed5c8ba64801b13ad47130ec7084d1ee693eed065bf158f10ab",
-      "bytes": 2239
+      "sha256": "ee7efd8b3594e2f02a2ecc6fe024ed9fb96ba0f8b5f1683d0c63c6196eab20e2",
+      "bytes": 3436
     },
     "application/services/compiler/prompt-blocks.d.ts": {
       "sha256": "2f40fd7599bd351584505152e9916fdea60891833d22c774c8ac9955f01ccf66",
@@ -946,8 +946,8 @@
       "bytes": 68013
     },
     "mcp/output-schemas.js": {
-      "sha256": "f390f2c853580c63dbaa204354dd2199f282e47c0bcd162d2accf3ab27d7ec04",
-      "bytes": 15326
+      "sha256": "d8e73b9f2722193eac8f68887a11644752efb35d341775dd18296f51cc1de26f",
+      "bytes": 15428
     },
     "mcp/render-envelope.d.ts": {
       "sha256": "22e83e1aba52968a7136cf289125a217b5f462a5a66a1eebe4669006e3326fdb",
@@ -1446,12 +1446,12 @@
       "bytes": 447
     },
     "v2/durable-core/constants.d.ts": {
-      "sha256": "2cdc1fe66cb2024e17977e024c73b9bb50845b70c9ac3925c2635e843a94f7f8",
-      "bytes": 3699
+      "sha256": "60311085ea51d86307877bd952623effcafeddf935fbe0f2cde8a21a165dd932",
+      "bytes": 3754
     },
     "v2/durable-core/constants.js": {
-      "sha256": "29372d3e7f868b5c40d6270a1f39477a680524688e73b03613305fafef4a9553",
-      "bytes": 3558
+      "sha256": "41e0aabd3754c79c9453c8496128610b1bd4a328cf7f55c4f0a8d7bc527c94a2",
+      "bytes": 3642
     },
     "v2/durable-core/domain/ack-advance-append-plan.d.ts": {
       "sha256": "2e802606656a0c1938192e5533aa46c74bc42789b5c315c79f6de4850017b30e",
@@ -1594,8 +1594,8 @@
       "bytes": 1175
     },
     "v2/durable-core/domain/prompt-renderer.js": {
-      "sha256": "2ac48cd9cdcecd19bec6bec710e6f45437f68a62df6fac60ce3eff1cdb821b32",
-      "bytes": 18266
+      "sha256": "f3e7cc34b753c082ee310e88839948e225ab10f13cedae1d35b2bd64869eb848",
+      "bytes": 17166
     },
     "v2/durable-core/domain/reason-model.d.ts": {
       "sha256": "650fcb2d9969a4e6123cccbd4913f4d57aeab21a19bb907aa1e11f95e5a95089",
@@ -1621,6 +1621,14 @@
       "sha256": "cc53453a1617b9adc526f7d3f49a40b1491bbe63dbaff98ddc187e1f8f6d125f",
       "bytes": 1454
     },
+    "v2/durable-core/domain/retrieval-contract.d.ts": {
+      "sha256": "9d130876a9584ab24fcb65e145958404d5636ff96ee1c5a02a2f64b219d5eda4",
+      "bytes": 4747
+    },
+    "v2/durable-core/domain/retrieval-contract.js": {
+      "sha256": "083a2e7d9fbbf4865f3960ad232774fd416b226919c3c39ea36e8ca3102df0cf",
+      "bytes": 12217
+    },
     "v2/durable-core/domain/risk-policy-guardrails.d.ts": {
       "sha256": "4720f9fe6e6ae68d7f989b31070d73661eb96652109dac7d30961e7937ff55e5",
       "bytes": 637
@@ -2430,12 +2438,12 @@
       "bytes": 732
     },
     "v2/projections/resume-ranking.d.ts": {
-      "sha256": "b1d9e7d6fb3e59ced42f7c2e5fd9d8f9a18308aa6f4411a8aabf5dc174aa8dad",
-      "bytes": 3960
+      "sha256": "3ac0db8e9d154eff9fba21c40eedaf981ea844d3f536f2b69b3840af8653b8f1",
+      "bytes": 4033
     },
     "v2/projections/resume-ranking.js": {
-      "sha256": "1b256c992ded9ec52150b229799716d118ca2a3659a0cc523e727cde2ebf7b0c",
-      "bytes": 13660
+      "sha256": "5f1ee9888446caa23653543fc8cae69ac4398e73232d71bac3d16722c9cd2158",
+      "bytes": 13596
     },
     "v2/projections/run-context.d.ts": {
       "sha256": "a4d57470a435ac9860f60b3244d1b828853995027cd510d8da42762d21b2a687",

package/dist/mcp/output-schemas.js

@@ -5,6 +5,7 @@ exports.toPendingStep = toPendingStep;
 const zod_1 = require("zod");
 const state_js_1 = require("../domain/execution/state.js");
 const token_patterns_js_1 = require("../v2/durable-core/tokens/token-patterns.js");
+const constants_js_1 = require("../v2/durable-core/constants.js");
 const JsonPrimitiveSchema = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.null()]);
 exports.JsonValueSchema = zod_1.z.lazy(() => zod_1.z.union([JsonPrimitiveSchema, zod_1.z.array(exports.JsonValueSchema), zod_1.z.record(exports.JsonValueSchema)]));
 exports.WorkflowSummarySchema = zod_1.z.object({
@@ -264,7 +265,7 @@ exports.V2ResumeSessionOutputSchema = zod_1.z.object({
         sessionTitle: zod_1.z.string().nullable().describe('Human-readable task/session title derived from persisted workflow context or early recap text.'),
         gitBranch: zod_1.z.string().nullable().describe('Git branch associated with the session, if available.'),
         resumeToken: zod_1.z.string().regex(token_patterns_js_1.STATE_TOKEN_PATTERN, 'Invalid resumeToken format'),
-        snippet: zod_1.z.string().max(1024),
+        snippet: zod_1.z.string().max(constants_js_1.MAX_RESUME_PREVIEW_BYTES),
         confidence: zod_1.z.enum(['strong', 'medium', 'weak']).describe('Coarse confidence band for how likely this candidate is the intended session.'),
         matchExplanation: zod_1.z.string().min(1).describe('Short natural-language explanation of why this candidate ranked here.'),
         pendingStepId: zod_1.z.string().nullable().describe('The current pending step ID (e.g. "phase-3-implement") if the workflow is in progress. ' +

package/dist/v2/durable-core/constants.d.ts

@@ -15,7 +15,8 @@ export declare const MAX_OBSERVATION_SHORT_STRING_LENGTH = 80;
 export declare const SESSION_LOCK_RETRY_AFTER_MS = 1000;
 export declare const DEFAULT_RETRY_AFTER_MS = 1000;
 export declare const TRUNCATION_MARKER = "\n\n[TRUNCATED]";
-export declare const RECOVERY_BUDGET_BYTES = 12288;
+export declare const RECOVERY_BUDGET_BYTES: number;
+export declare const MAX_RESUME_PREVIEW_BYTES: number;
 export declare const SHA256_DIGEST_PATTERN: RegExp;
 export declare const DELIMITER_SAFE_ID_PATTERN: RegExp;
 export declare const EVENT_KIND: {

package/dist/v2/durable-core/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AUTONOMY_MODE = exports.ADVANCE_INTENT = exports.MANIFEST_KIND = exports.EDGE_CAUSE = exports.ADVANCE_OUTCOME = exports.ENGINE_STATE = exports.EDGE_KIND = exports.PAYLOAD_KIND = exports.OUTPUT_CHANNEL = exports.EVENT_KIND = exports.DELIMITER_SAFE_ID_PATTERN = exports.SHA256_DIGEST_PATTERN = exports.RECOVERY_BUDGET_BYTES = exports.TRUNCATION_MARKER = exports.DEFAULT_RETRY_AFTER_MS = exports.SESSION_LOCK_RETRY_AFTER_MS = exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = exports.MAX_CONTEXT_DEPTH = exports.MAX_CONTEXT_BYTES = exports.MAX_VALIDATION_SUGGESTIONS_BYTES = exports.MAX_VALIDATION_ISSUES_BYTES = exports.MAX_VALIDATION_SUGGESTION_ITEM_BYTES = exports.MAX_VALIDATION_ISSUE_ITEM_BYTES = exports.MAX_OUTPUT_NOTES_MARKDOWN_BYTES = exports.MAX_DECISION_TRACE_TOTAL_BYTES = exports.MAX_DECISION_TRACE_ENTRY_SUMMARY_BYTES = exports.MAX_DECISION_TRACE_ENTRIES = exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = exports.MAX_BLOCKER_MESSAGE_BYTES = exports.MAX_BLOCKERS = void 0;
+exports.AUTONOMY_MODE = exports.ADVANCE_INTENT = exports.MANIFEST_KIND = exports.EDGE_CAUSE = exports.ADVANCE_OUTCOME = exports.ENGINE_STATE = exports.EDGE_KIND = exports.PAYLOAD_KIND = exports.OUTPUT_CHANNEL = exports.EVENT_KIND = exports.DELIMITER_SAFE_ID_PATTERN = exports.SHA256_DIGEST_PATTERN = exports.MAX_RESUME_PREVIEW_BYTES = exports.RECOVERY_BUDGET_BYTES = exports.TRUNCATION_MARKER = exports.DEFAULT_RETRY_AFTER_MS = exports.SESSION_LOCK_RETRY_AFTER_MS = exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = exports.MAX_CONTEXT_DEPTH = exports.MAX_CONTEXT_BYTES = exports.MAX_VALIDATION_SUGGESTIONS_BYTES = exports.MAX_VALIDATION_ISSUES_BYTES = exports.MAX_VALIDATION_SUGGESTION_ITEM_BYTES = exports.MAX_VALIDATION_ISSUE_ITEM_BYTES = exports.MAX_OUTPUT_NOTES_MARKDOWN_BYTES = exports.MAX_DECISION_TRACE_TOTAL_BYTES = exports.MAX_DECISION_TRACE_ENTRY_SUMMARY_BYTES = exports.MAX_DECISION_TRACE_ENTRIES = exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = exports.MAX_BLOCKER_MESSAGE_BYTES = exports.MAX_BLOCKERS = void 0;
 exports.MAX_BLOCKERS = 10;
 exports.MAX_BLOCKER_MESSAGE_BYTES = 512;
 exports.MAX_BLOCKER_SUGGESTED_FIX_BYTES = 1024;
@@ -18,7 +18,8 @@ exports.MAX_OBSERVATION_SHORT_STRING_LENGTH = 80;
 exports.SESSION_LOCK_RETRY_AFTER_MS = 1000;
 exports.DEFAULT_RETRY_AFTER_MS = 1000;
 exports.TRUNCATION_MARKER = '\n\n[TRUNCATED]';
-exports.RECOVERY_BUDGET_BYTES = 12288;
+exports.RECOVERY_BUDGET_BYTES = 24 * 1024;
+exports.MAX_RESUME_PREVIEW_BYTES = 2 * 1024;
 exports.SHA256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/;
 exports.DELIMITER_SAFE_ID_PATTERN = /^[a-z0-9_-]+$/;
 exports.EVENT_KIND = {

package/dist/v2/durable-core/domain/prompt-renderer.js

@@ -15,11 +15,13 @@ const index_js_2 = require("../schemas/artifacts/index.js");
 const run_context_js_1 = require("../../projections/run-context.js");
 const condition_evaluator_js_1 = require("../../../utils/condition-evaluator.js");
 const context_template_resolver_js_1 = require("./context-template-resolver.js");
-function buildNonTipSections(args) {
-    const sections = [];
+const retrieval_contract_js_1 = require("./retrieval-contract.js");
+function buildNonTipSegments(args) {
+    const segments = [];
     const childSummary = (0, recap_recovery_js_1.buildChildSummary)({ nodeId: args.nodeId, dag: args.run });
-    if (childSummary) {
-        sections.push(`### Branch Summary\n${childSummary}`);
+    const childSummarySegment = (0, retrieval_contract_js_1.createBranchSummarySegment)(childSummary);
+    if (childSummarySegment) {
+        segments.push(childSummarySegment);
     }
     if (args.run.preferredTipNodeId && args.run.preferredTipNodeId !== String(args.nodeId)) {
         const downstreamRes = (0, recap_recovery_js_1.collectDownstreamRecap)({
@@ -29,12 +31,15 @@ function buildNonTipSections(args) {
             outputs: args.outputs,
         });
         if (downstreamRes.isOk() && downstreamRes.value.length > 0) {
-            sections.push(`### Downstream Recap (Preferred Branch)\n${downstreamRes.value.join('\n\n')}`);
+            const downstreamSegment = (0, retrieval_contract_js_1.createDownstreamRecapSegment)(downstreamRes.value.join('\n\n'));
+            if (downstreamSegment) {
+                segments.push(downstreamSegment);
+            }
         }
     }
-    return sections;
+    return segments;
 }
-function buildAncestrySections(args) {
+function buildAncestrySegments(args) {
     const ancestryRes = (0, recap_recovery_js_1.collectAncestryRecap)({
         nodeId: args.nodeId,
         dag: args.run,
@@ -42,11 +47,12 @@ function buildAncestrySections(args) {
         includeCurrentNode: false,
     });
     if (ancestryRes.isOk() && ancestryRes.value.length > 0) {
-        return [`### Ancestry Recap\n${ancestryRes.value.join('\n\n')}`];
+        const ancestrySegment = (0, retrieval_contract_js_1.createAncestryRecapSegment)(ancestryRes.value.join('\n\n'));
+        return ancestrySegment ? [ancestrySegment] : [];
     }
     return [];
 }
-function buildFunctionDefsSections(args) {
+function buildFunctionDefsSegments(args) {
     const funcsRes = (0, function_definition_expander_js_1.expandFunctionDefinitions)({
         workflow: args.workflow,
         stepId: args.stepId,
@@ -55,7 +61,8 @@ function buildFunctionDefsSections(args) {
     });
     if (funcsRes.isOk() && funcsRes.value.length > 0) {
         const formatted = funcsRes.value.map(function_definition_expander_js_1.formatFunctionDef).join('\n\n');
-        return [`### Function Definitions\n\`\`\`\n${formatted}\n\`\`\``];
+        const functionDefinitionsSegment = (0, retrieval_contract_js_1.createFunctionDefinitionsSegment)(`\`\`\`\n${formatted}\n\`\`\``);
+        return functionDefinitionsSegment ? [functionDefinitionsSegment] : [];
     }
     return [];
 }
@@ -65,12 +72,12 @@ function hasPriorNotesInRun(args) {
         e.data.outputChannel === constants_js_1.OUTPUT_CHANNEL.RECAP &&
         e.data.payload.payloadKind === constants_js_1.PAYLOAD_KIND.NOTES);
 }
-function buildRecoverySections(args) {
+function buildRecoverySegments(args) {
     const isTip = args.run.tipNodeIds.includes(String(args.nodeId));
     return [
-        ...(isTip ? [] : buildNonTipSections({ nodeId: args.nodeId, run: args.run, outputs: args.outputs })),
-        ...buildAncestrySections({ nodeId: args.nodeId, run: args.run, outputs: args.outputs }),
-        ...buildFunctionDefsSections({
+        ...(isTip ? [] : buildNonTipSegments({ nodeId: args.nodeId, run: args.run, outputs: args.outputs })),
+        ...buildAncestrySegments({ nodeId: args.nodeId, run: args.run, outputs: args.outputs }),
+        ...buildFunctionDefsSegments({
             workflow: args.workflow,
             stepId: args.stepId,
             loopPath: args.loopPath,
@@ -78,52 +85,6 @@ function buildRecoverySections(args) {
         }),
     ];
 }
-function trimToUtf8Boundary(bytes) {
-    const n = bytes.length;
-    if (n === 0)
-        return bytes;
-    let cont = 0;
-    for (let i = n - 1; i >= 0 && i >= n - 4; i--) {
-        const b = bytes[i];
-        if ((b & 192) === 128) {
-            cont++;
-        }
-        else {
-            break;
-        }
-    }
-    if (cont === 0)
-        return bytes;
-    const leadByteIndex = n - cont - 1;
-    if (leadByteIndex < 0) {
-        return new Uint8Array(0);
-    }
-    const leadByte = bytes[leadByteIndex];
-    const expectedLen = (leadByte & 128) === 0 ? 1 :
-        (leadByte & 224) === 192 ? 2 :
-            (leadByte & 240) === 224 ? 3 :
-                (leadByte & 248) === 240 ? 4 :
-                    0;
-    const actualLen = cont + 1;
-    if (expectedLen === 0 || expectedLen !== actualLen) {
-        return bytes.subarray(0, leadByteIndex);
-    }
-    return bytes;
-}
-function applyPromptBudget(combinedPrompt) {
-    const encoder = new TextEncoder();
-    const promptBytes = encoder.encode(combinedPrompt);
-    if (promptBytes.length <= constants_js_1.RECOVERY_BUDGET_BYTES) {
-        return combinedPrompt;
-    }
-    const markerText = constants_js_1.TRUNCATION_MARKER;
-    const omissionNote = `\nOmitted recovery content due to budget constraints.`;
-    const suffixBytes = encoder.encode(markerText + omissionNote);
-    const maxContentBytes = constants_js_1.RECOVERY_BUDGET_BYTES - suffixBytes.length;
-    const truncatedBytes = trimToUtf8Boundary(promptBytes.subarray(0, maxContentBytes));
-    const decoder = new TextDecoder('utf-8');
-    return decoder.decode(truncatedBytes) + markerText + omissionNote;
-}
 function resolveParentLoopStep(workflow, stepId) {
     for (const step of workflow.definition.steps) {
         if ((0, workflow_js_1.isLoopStepDefinition)(step) && Array.isArray(step.body)) {
@@ -352,9 +313,8 @@ function renderPendingPrompt(args) {
         });
     }
     const { run, outputs } = projectionsRes.value;
-    const sections = buildRecoverySections({
+    const segments = buildRecoverySegments({
         nodeId: args.nodeId,
-        dag: run,
         run,
         outputs,
         workflow: args.workflow,
@@ -362,12 +322,14 @@ function renderPendingPrompt(args) {
         loopPath: args.loopPath,
         functionReferences,
     });
-    if (sections.length === 0) {
+    if (segments.length === 0) {
         return (0, neverthrow_1.ok)({ stepId: args.stepId, title: baseTitle, prompt: enhancedPrompt, agentRole, requireConfirmation });
     }
     const recoveryHeader = cleanResponseFormat ? 'Your previous work:' : '## Recovery Context';
-    const recoveryText = `${recoveryHeader}\n\n${sections.join('\n\n')}`;
-    const combinedPrompt = `${enhancedPrompt}\n\n${recoveryText}`;
-    const finalPrompt = applyPromptBudget(combinedPrompt);
+    const recoveryText = (0, retrieval_contract_js_1.renderBudgetedRehydrateRecovery)({
+        header: recoveryHeader,
+        segments,
+    }).text;
+    const finalPrompt = `${enhancedPrompt}\n\n${recoveryText}`;
     return (0, neverthrow_1.ok)({ stepId: args.stepId, title: baseTitle, prompt: finalPrompt, agentRole, requireConfirmation });
 }

package/dist/v2/durable-core/domain/retrieval-contract.d.ts

@@ -0,0 +1,105 @@
+export type RetrievalPackSurface = 'rehydrate';
+export type ResumePreviewSurface = 'resume_preview';
+export type RetrievalPackTier = 'structural_context' | 'durable_recap' | 'reference_material';
+export type ResumePreviewTier = 'identity_context' | 'durable_recap';
+export interface RetrievalPackTierDefinition {
+    readonly tier: RetrievalPackTier;
+    readonly purpose: string;
+    readonly priority: number;
+    readonly retention: 'core' | 'tail';
+}
+export interface ResumePreviewTierDefinition {
+    readonly tier: ResumePreviewTier;
+    readonly purpose: string;
+    readonly priority: number;
+    readonly maxBytes: number;
+}
+export interface RetrievalPackTruncationPolicy {
+    readonly mode: 'drop_lower_tiers_then_global_utf8_trim';
+    readonly budgetScope: 'shared_recovery_prompt';
+    readonly antiReconstructionRule: 'select_order_and_compress_explicit_facts_only';
+}
+export interface RetrievalPackContract {
+    readonly surface: RetrievalPackSurface;
+    readonly tiers: readonly RetrievalPackTierDefinition[];
+    readonly truncation: RetrievalPackTruncationPolicy;
+}
+export interface ResumePreviewContract {
+    readonly surface: ResumePreviewSurface;
+    readonly tiers: readonly ResumePreviewTierDefinition[];
+    readonly budgetBytes: number;
+}
+export interface BranchSummarySegment {
+    readonly kind: 'branch_summary';
+    readonly tier: 'structural_context';
+    readonly source: 'deterministic_structure';
+    readonly title: 'Branch Summary';
+    readonly body: string;
+}
+export interface DownstreamRecapSegment {
+    readonly kind: 'downstream_recap';
+    readonly tier: 'structural_context';
+    readonly source: 'explicit_durable_fact';
+    readonly title: 'Downstream Recap (Preferred Branch)';
+    readonly body: string;
+}
+export interface AncestryRecapSegment {
+    readonly kind: 'ancestry_recap';
+    readonly tier: 'durable_recap';
+    readonly source: 'explicit_durable_fact';
+    readonly title: 'Ancestry Recap';
+    readonly body: string;
+}
+export interface FunctionDefinitionsSegment {
+    readonly kind: 'function_definitions';
+    readonly tier: 'reference_material';
+    readonly source: 'workflow_definition';
+    readonly title: 'Function Definitions';
+    readonly body: string;
+}
+export type RetrievalPackSegment = BranchSummarySegment | DownstreamRecapSegment | AncestryRecapSegment | FunctionDefinitionsSegment;
+export interface RetrievalPackRenderResult {
+    readonly text: string;
+    readonly includedTiers: readonly RetrievalPackTier[];
+    readonly omittedTierCount: number;
+    readonly truncatedWithinTier: boolean;
+}
+export interface SessionTitlePreviewSegment {
+    readonly kind: 'session_title_preview';
+    readonly tier: 'identity_context';
+    readonly source: 'persisted_context';
+    readonly body: string;
+}
+export interface RecapPreviewSegment {
+    readonly kind: 'recap_preview';
+    readonly tier: 'durable_recap';
+    readonly source: 'explicit_durable_fact';
+    readonly body: string;
+}
+export type ResumePreviewSegment = SessionTitlePreviewSegment | RecapPreviewSegment;
+export type ResumePreviewText = string & {
+    readonly __brand: 'ResumePreviewText';
+};
+export interface ResumePreviewRenderResult {
+    readonly text: ResumePreviewText;
+    readonly includedTiers: readonly ResumePreviewTier[];
+}
+export declare const REHYDRATE_RETRIEVAL_CONTRACT: RetrievalPackContract;
+export declare const RESUME_PREVIEW_CONTRACT: ResumePreviewContract;
+export declare function createBranchSummarySegment(body: string): BranchSummarySegment | null;
+export declare function createDownstreamRecapSegment(body: string): DownstreamRecapSegment | null;
+export declare function createAncestryRecapSegment(body: string): AncestryRecapSegment | null;
+export declare function createFunctionDefinitionsSegment(body: string): FunctionDefinitionsSegment | null;
+export declare function createSessionTitlePreviewSegment(body: string): SessionTitlePreviewSegment | null;
+export declare function createRecapPreviewSegment(body: string): RecapPreviewSegment | null;
+export declare function compareRetrievalPackSegments(a: RetrievalPackSegment, b: RetrievalPackSegment): number;
+export declare function orderRetrievalPackSegments(segments: readonly RetrievalPackSegment[]): readonly RetrievalPackSegment[];
+export declare function renderRetrievalPackSections(segments: readonly RetrievalPackSegment[]): readonly string[];
+export declare function renderBudgetedResumePreview(args: {
+    readonly segments: readonly ResumePreviewSegment[];
+    readonly focusTerms?: readonly string[];
+}): ResumePreviewRenderResult;
+export declare function renderBudgetedRehydrateRecovery(args: {
+    readonly header: string;
+    readonly segments: readonly RetrievalPackSegment[];
+}): RetrievalPackRenderResult;