@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/query.js

@@ -1,36 +1,2 @@
-/**
- * @module sdk/query
- *
- * Provides focused read, search, pagination, and context-ranking primitives.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="affe6060-5129-5914-9d4e-46c300d49080")}catch(e){}}();
-export * from "./query/list.js";
-export * from "./query/complete-list.js";
-export * from "./query/search.js";
-export { runActivity, } from "./query/activity.js";
-export * from "./query/aggregate.js";
-export * from "./query/calendar.js";
-export { CONTEXT_OUTPUT_VALUES, applyContextTagProjection, buildChildrenByParent, collectSubtreeIds, compareCriticalItems, mergeSortedWarnings, packRankedContextItems, parseContextDepth, parseContextFocusFields, parseContextSections, projectContextFocusRows, renderContextMarkdown, resolveContextOutputFormat, resolveContextTokenBudget, runContext, toContextFocusItem, toContextPackingSummary, toContextRankingSummary, } from "./query/context.js";
-export * from "./query/get.js";
-export * from "./query/history.js";
-export * from "./query/next.js";
-export * from "./actionability.js";
-export * from "./query/search-pagination.js";
-export * from "./query/search-rendering.js";
-export * from "./query/item-filter-options.js";
-export * from "./query/multi-value-filters.js";
-export * from "./query/parsers.js";
-export * from "./pagination.js";
-export * from "./item-children.js";
-export * from "./item-metadata-index.js";
-export * from "./context-packing.js";
-export * from "./context-relevance.js";
-export * from "./context-signal-store.js";
-export * from "./context-usage.js";
-export * from "./workspace-memory.js";
-export * from "./duplicates.js";
-export { analyzeDuplicateItems } from "./similarity.js";
-export { measureItemMetadataReadWork } from "../core/store/item-metadata-read-work.js";
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="87fb8085-4f16-58a9-9de7-c871fb90be5b")}catch(e2){}})();export*from"./query/list.js";export*from"./query/complete-list.js";export*from"./query/search.js";import{runActivity}from"./query/activity.js";export*from"./query/aggregate.js";export*from"./query/calendar.js";import{CONTEXT_OUTPUT_VALUES,applyContextTagProjection,buildChildrenByParent,collectSubtreeIds,compareCriticalItems,mergeSortedWarnings,packRankedContextItems,parseContextDepth,parseContextFocusFields,parseContextSections,projectContextFocusRows,renderContextMarkdown,resolveContextOutputFormat,resolveContextTokenBudget,runContext,toContextFocusItem,toContextPackingSummary,toContextRankingSummary}from"./query/context.js";export*from"./query/get.js";export*from"./query/history.js";export*from"./query/next.js";export*from"./actionability.js";export*from"./query/search-pagination.js";export*from"./query/search-rendering.js";export*from"./query/item-filter-options.js";export*from"./query/multi-value-filters.js";export*from"./query/parsers.js";export*from"./pagination.js";export*from"./item-children.js";export*from"./item-metadata-index.js";export*from"./context-packing.js";export*from"./context-relevance.js";export*from"./context-signal-store.js";export*from"./context-usage.js";export*from"./workspace-memory.js";export*from"./duplicates.js";import{analyzeDuplicateItems}from"./similarity.js";import{measureItemMetadataReadWork}from"../core/store/item-metadata-read-work.js";export{CONTEXT_OUTPUT_VALUES,analyzeDuplicateItems,applyContextTagProjection,buildChildrenByParent,collectSubtreeIds,compareCriticalItems,measureItemMetadataReadWork,mergeSortedWarnings,packRankedContextItems,parseContextDepth,parseContextFocusFields,parseContextSections,projectContextFocusRows,renderContextMarkdown,resolveContextOutputFormat,resolveContextTokenBudget,runActivity,runContext,toContextFocusItem,toContextPackingSummary,toContextRankingSummary};
 //# sourceMappingURL=query.js.map
-//# debugId=affe6060-5129-5914-9d4e-46c300d49080

package/dist/sdk/read-output/continuation.js

@@ -1,195 +1,2 @@
-/**
- * @module sdk/read-output/continuation
- *
- * Encodes, validates, and applies stable continuations for declared read-output
- * row collections while keeping cursor mechanics separate from dimension
- * resolution and budget policy.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9e63b4b0-09a5-50bf-9f56-5f239c75ffe5")}catch(e){}}();
-import { createHash } from "node:crypto";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { stableStringify } from "../../core/shared/serialization.js";
-import { resolveReadOutputSurface } from "../read-output-contracts.js";
-import { readOutputContinuationRowCollections, sliceReadOutputRowCollection, } from "../read-output-rows.js";
-const MAX_READ_OUTPUT_CURSOR_LENGTH = 4096;
-const HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS = Object.freeze([
-    "queue_draining",
-    "queue_entries",
-    "queue_exists",
-    "queue_high_retry_entries",
-    "queue_invalid_rows",
-    "queue_max_attempts",
-    "queue_rows_total",
-    "queue_size_bytes",
-    "pending_otel_spans",
-    "last_attempted_flush_at",
-    "last_failed_flush_at",
-    "last_otel_attempt_at",
-    "last_otel_failure_at",
-    "last_otel_success_at",
-    "last_successful_flush_at",
-]);
-/** Command-specific exceptions to complete-row continuation fingerprinting. */
-export const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES = Object.freeze({
-    health: Object.freeze({
-        version: 3,
-        paths: Object.freeze(["checks"]),
-        ignored_detail_field_names_by_row: Object.freeze({
-            telemetry: HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS,
-        }),
-        guarantee: "nonvolatile_snapshot_and_stable_configuration",
-    }),
-});
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function normalizeReadOutputFingerprintValue(value) {
-    if (Array.isArray(value)) {
-        return value.map(normalizeReadOutputFingerprintValue);
-    }
-    if (!isRecord(value))
-        return value;
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
-        key,
-        normalizeReadOutputFingerprintValue(entry),
-    ]));
-}
-function normalizeReadOutputFingerprintRow(value, policy) {
-    if (!isRecord(value))
-        return normalizeReadOutputFingerprintValue(value);
-    const rowName = typeof value.name === "string" ? value.name : undefined;
-    const ignoredDetailFields = rowName !== undefined &&
-        Object.hasOwn(policy.ignored_detail_field_names_by_row, rowName)
-        ? policy.ignored_detail_field_names_by_row[rowName]
-        : undefined;
-    return Object.fromEntries(Object.entries(value)
-        .map(([key, entry]) => {
-        if (key !== "details" || !ignoredDetailFields || !isRecord(entry)) {
-            return [key, normalizeReadOutputFingerprintValue(entry)];
-        }
-        return [
-            key,
-            Object.fromEntries(Object.entries(entry)
-                .filter(([detailKey]) => !ignoredDetailFields.includes(detailKey))
-                .map(([detailKey, detailValue]) => [
-                detailKey,
-                normalizeReadOutputFingerprintValue(detailValue),
-            ])),
-        ];
-    }));
-}
-function normalizeReadOutputFingerprintSnapshot(value, policy) {
-    return Array.isArray(value)
-        ? value.map((row) => normalizeReadOutputFingerprintRow(row, policy))
-        : normalizeReadOutputFingerprintRow(value, policy);
-}
-/** Fingerprint the policy-normalized row snapshot so stable evidence changes fail closed. */
-export function readOutputCollectionFingerprint(path, value, command) {
-    const policy = command
-        ? PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES[command]
-        : undefined;
-    const policyApplies = policy?.paths.includes(path) === true;
-    return createHash("sha256")
-        .update(stableStringify({
-        path,
-        value: policyApplies
-            ? normalizeReadOutputFingerprintSnapshot(value, policy)
-            : value,
-        ...(policyApplies
-            ? { fingerprint_policy_version: policy.version }
-            : {}),
-    }))
-        .digest("base64url")
-        .slice(0, 16);
-}
-/** Encode one stable declared-row continuation for CLI, SDK, and MCP callers. */
-export function encodeReadOutputContinuationCursor(cursor) {
-    return Buffer.from(JSON.stringify({
-        v: 1,
-        c: cursor.command,
-        p: cursor.path,
-        o: cursor.offset,
-        n: cursor.total_rows,
-        f: cursor.fingerprint,
-    }), "utf8").toString("base64url");
-}
-/** Decode and validate one universal declared-row continuation cursor. */
-export function decodeReadOutputContinuationCursor(raw) {
-    if (raw.length > MAX_READ_OUTPUT_CURSOR_LENGTH) {
-        throw new PmCliError("The read-output continuation cursor is malformed or unsupported.", EXIT_CODE.USAGE, { code: "read_output_cursor_invalid" });
-    }
-    let candidate;
-    try {
-        candidate = JSON.parse(Buffer.from(raw, "base64url").toString("utf8"));
-    }
-    catch {
-        candidate = null;
-    }
-    if (!isRecord(candidate) ||
-        candidate.v !== 1 ||
-        resolveReadOutputSurface(String(candidate.c ?? "")) !== candidate.c ||
-        typeof candidate.p !== "string" ||
-        candidate.p.length === 0 ||
-        !Number.isSafeInteger(candidate.o) ||
-        candidate.o < 0 ||
-        !Number.isSafeInteger(candidate.n) ||
-        candidate.n < 1 ||
-        typeof candidate.f !== "string" ||
-        candidate.f.length === 0) {
-        throw new PmCliError("The read-output continuation cursor is malformed or unsupported.", EXIT_CODE.USAGE, { code: "read_output_cursor_invalid" });
-    }
-    return {
-        version: 1,
-        command: candidate.c,
-        path: candidate.p,
-        offset: candidate.o,
-        total_rows: candidate.n,
-        fingerprint: candidate.f,
-    };
-}
-/** Place every non-passing assurance assertion before passing evidence. */
-export function prioritizeAssuranceAssertions(result) {
-    if (!Array.isArray(result.assertions))
-        return result;
-    const priority = (row) => {
-        if (!isRecord(row) || row.verdict === "pass")
-            return 4;
-        if (row.verdict === "retired")
-            return 3;
-        return row.enforcement === "block" ? 0 : row.enforcement === "warn" ? 1 : 2;
-    };
-    return {
-        ...result,
-        assertions: result.assertions
-            .map((row, index) => ({ row, index }))
-            .sort((left, right) => priority(left.row) - priority(right.row) || left.index - right.index)
-            .map(({ row }) => row),
-        budget_retention_policy: "verdict_priority",
-    };
-}
-/** Validate and apply a continuation suffix to its declared row collection. */
-export function applyReadOutputContinuation(result, command, cursor) {
-    if (!cursor)
-        return result;
-    if (cursor.command !== command) {
-        throw new PmCliError(`The read-output cursor belongs to ${cursor.command}, not ${command}.`, EXIT_CODE.USAGE, { code: "read_output_cursor_command_mismatch" });
-    }
-    const collection = readOutputContinuationRowCollections(result).find((entry) => entry.path === cursor.path);
-    const totalRows = collection
-        ? Array.isArray(collection.value)
-            ? collection.value.length
-            : Object.keys(collection.value).length
-        : 0;
-    if (!collection ||
-        totalRows !== cursor.total_rows ||
-        cursor.offset > totalRows ||
-        readOutputCollectionFingerprint(cursor.path, collection.value, command) !==
-            cursor.fingerprint) {
-        throw new PmCliError("The read-output continuation no longer matches the declared row collection; restart the bounded read.", EXIT_CODE.USAGE, { code: "read_output_cursor_stale" });
-    }
-    return sliceReadOutputRowCollection(result, cursor.path, cursor.offset);
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="de370088-9285-5b33-8c7f-da8e9bb88286")}catch(e2){}})();import{createHash}from"node:crypto";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{stableStringify}from"../../core/shared/serialization.js";import{resolveReadOutputSurface}from"../read-output-contracts.js";import{readOutputContinuationRowCollections,sliceReadOutputRowCollection}from"../read-output-rows.js";const MAX_READ_OUTPUT_CURSOR_LENGTH=4096;const HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS=Object.freeze(["queue_draining","queue_entries","queue_exists","queue_high_retry_entries","queue_invalid_rows","queue_max_attempts","queue_rows_total","queue_size_bytes","pending_otel_spans","last_attempted_flush_at","last_failed_flush_at","last_otel_attempt_at","last_otel_failure_at","last_otel_success_at","last_successful_flush_at"]);const PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES=Object.freeze({health:Object.freeze({version:3,paths:Object.freeze(["checks"]),ignored_detail_field_names_by_row:Object.freeze({telemetry:HEALTH_TELEMETRY_VOLATILE_DETAIL_FIELDS}),guarantee:"nonvolatile_snapshot_and_stable_configuration"})});function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function normalizeReadOutputFingerprintValue(value){if(Array.isArray(value)){return value.map(normalizeReadOutputFingerprintValue)}if(!isRecord(value))return value;return Object.fromEntries(Object.entries(value).map(([key,entry])=>[key,normalizeReadOutputFingerprintValue(entry)]))}function normalizeReadOutputFingerprintRow(value,policy){if(!isRecord(value))return normalizeReadOutputFingerprintValue(value);const rowName=typeof value.name==="string"?value.name:void 0;const ignoredDetailFields=rowName!==void 0&&Object.hasOwn(policy.ignored_detail_field_names_by_row,rowName)?policy.ignored_detail_field_names_by_row[rowName]:void 0;return Object.fromEntries(Object.entries(value).map(([key,entry])=>{if(key!=="details"||!ignoredDetailFields||!isRecord(entry)){return[key,normalizeReadOutputFingerprintValue(entry)]}return[key,Object.fromEntries(Object.entries(entry).filter(([detailKey])=>!ignoredDetailFields.includes(detailKey)).map(([detailKey,detailValue])=>[detailKey,normalizeReadOutputFingerprintValue(detailValue)]))]}))}function normalizeReadOutputFingerprintSnapshot(value,policy){return Array.isArray(value)?value.map(row=>normalizeReadOutputFingerprintRow(row,policy)):normalizeReadOutputFingerprintRow(value,policy)}function readOutputCollectionFingerprint(path,value,command){const policy=command?PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES[command]:void 0;const policyApplies=policy?.paths.includes(path)===true;return createHash("sha256").update(stableStringify({path,value:policyApplies?normalizeReadOutputFingerprintSnapshot(value,policy):value,...policyApplies?{fingerprint_policy_version:policy.version}:{}})).digest("base64url").slice(0,16)}function encodeReadOutputContinuationCursor(cursor){return Buffer.from(JSON.stringify({v:1,c:cursor.command,p:cursor.path,o:cursor.offset,n:cursor.total_rows,f:cursor.fingerprint}),"utf8").toString("base64url")}function decodeReadOutputContinuationCursor(raw){if(raw.length>MAX_READ_OUTPUT_CURSOR_LENGTH){throw new PmCliError("The read-output continuation cursor is malformed or unsupported.",EXIT_CODE.USAGE,{code:"read_output_cursor_invalid"})}let candidate;try{candidate=JSON.parse(Buffer.from(raw,"base64url").toString("utf8"))}catch{candidate=null}if(!isRecord(candidate)||candidate.v!==1||resolveReadOutputSurface(String(candidate.c??""))!==candidate.c||typeof candidate.p!=="string"||candidate.p.length===0||!Number.isSafeInteger(candidate.o)||candidate.o<0||!Number.isSafeInteger(candidate.n)||candidate.n<1||typeof candidate.f!=="string"||candidate.f.length===0){throw new PmCliError("The read-output continuation cursor is malformed or unsupported.",EXIT_CODE.USAGE,{code:"read_output_cursor_invalid"})}return{version:1,command:candidate.c,path:candidate.p,offset:candidate.o,total_rows:candidate.n,fingerprint:candidate.f}}function prioritizeAssuranceAssertions(result){if(!Array.isArray(result.assertions))return result;const priority=row=>{if(!isRecord(row)||row.verdict==="pass")return 4;if(row.verdict==="retired")return 3;return row.enforcement==="block"?0:row.enforcement==="warn"?1:2};return{...result,assertions:result.assertions.map((row,index)=>({row,index})).sort((left,right)=>priority(left.row)-priority(right.row)||left.index-right.index).map(({row})=>row),budget_retention_policy:"verdict_priority"}}function applyReadOutputContinuation(result,command,cursor){if(!cursor)return result;if(cursor.command!==command){throw new PmCliError(`The read-output cursor belongs to ${cursor.command}, not ${command}.`,EXIT_CODE.USAGE,{code:"read_output_cursor_command_mismatch"})}const collection=readOutputContinuationRowCollections(result).find(entry=>entry.path===cursor.path);const totalRows=collection?Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length:0;if(!collection||totalRows!==cursor.total_rows||cursor.offset>totalRows||readOutputCollectionFingerprint(cursor.path,collection.value,command)!==cursor.fingerprint){throw new PmCliError("The read-output continuation no longer matches the declared row collection; restart the bounded read.",EXIT_CODE.USAGE,{code:"read_output_cursor_stale"})}return sliceReadOutputRowCollection(result,cursor.path,cursor.offset)}export{PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES,applyReadOutputContinuation,decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,prioritizeAssuranceAssertions,readOutputCollectionFingerprint};
 //# sourceMappingURL=continuation.js.map
-//# debugId=9e63b4b0-09a5-50bf-9f56-5f239c75ffe5

package/dist/sdk/read-output-budget.js

@@ -1,136 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="02a0bd0c-6ab0-5193-807b-00394a4712b7")}catch(e){}}();
-import { countReadOutputRows, readOutputBudgetCollections, } from "./read-output-rows.js";
-const MAX_ESTIMATE_ITERATIONS = 8;
-const MAX_COMPACTION_ITERATIONS = 64;
-const RECOVERY_MARGIN_NUMERATOR = 5;
-const RECOVERY_MARGIN_DENOMINATOR = 4;
-const RECOVERY_ROUNDING_TOKENS = 100;
-/**
- * Recommend a retry that is strictly larger than both the binding request and
- * the pre-compaction result, with a 25% envelope margin rounded to 100 tokens.
- */
-export function resolveReadOutputRecoveryBudget(input) {
-    const binding = Math.trunc(input.effective_budget_tokens);
-    const measured = Math.trunc(input.measured_result_tokens);
-    if (!Number.isSafeInteger(binding) ||
-        binding <= 0 ||
-        !Number.isSafeInteger(measured) ||
-        measured <= 0) {
-        return {
-            output_budget: "unbounded",
-            recovery_budget_multiplier: null,
-            rule_version: "v1",
-        };
-    }
-    const baseline = Math.max(binding + 1, measured);
-    const withMargin = Math.ceil((baseline * RECOVERY_MARGIN_NUMERATOR) / RECOVERY_MARGIN_DENOMINATOR);
-    const rounded = Math.ceil(withMargin / RECOVERY_ROUNDING_TOKENS) *
-        RECOVERY_ROUNDING_TOKENS;
-    if (!Number.isSafeInteger(rounded)) {
-        return {
-            output_budget: "unbounded",
-            recovery_budget_multiplier: null,
-            rule_version: "v1",
-        };
-    }
-    return {
-        output_budget: rounded,
-        recovery_budget_multiplier: rounded / binding,
-        rule_version: "v1",
-    };
-}
-/** Estimate the conservative token cost of a JSON-shaped result. */
-export function estimateReadOutputTokens(result) {
-    return Math.ceil(Buffer.byteLength(JSON.stringify(result), "utf8") / 4);
-}
-/** Return whether a value is a non-array object record. */
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/** Recursively shorten explanatory strings and record whether content changed. */
-function compactStrings(value, state) {
-    if (typeof value === "string") {
-        if (value.length <= 240)
-            return value;
-        state.compacted = true;
-        return `${value.slice(0, 240)}…`;
-    }
-    if (Array.isArray(value)) {
-        return value.map((entry) => compactStrings(entry, state));
-    }
-    if (!isRecord(value))
-        return value;
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
-        key,
-        compactStrings(entry, state),
-    ]));
-}
-/** Update a receipt to the fixed-point estimate of the result containing it. */
-export function updateReadOutputReceiptEstimate(result, receipt) {
-    let estimate = receipt.estimated_tokens;
-    for (let iteration = 0; iteration < MAX_ESTIMATE_ITERATIONS; iteration += 1) {
-        receipt.estimated_tokens = estimate;
-        const measured = estimateReadOutputTokens(result);
-        if (measured === estimate)
-            return;
-        estimate = measured;
-    }
-    receipt.estimated_tokens = estimate;
-}
-/** Reduce the largest row collection until the budget fits or no rows can move. */
-function compactRowsToBudget(result, receipt, budget, minimumRowsByPath) {
-    for (let iteration = 0; iteration < MAX_COMPACTION_ITERATIONS; iteration += 1) {
-        updateReadOutputReceiptEstimate(result, receipt);
-        if (receipt.estimated_tokens <= budget)
-            return;
-        const candidate = readOutputBudgetCollections(result)
-            .filter((collection) => {
-            const length = Array.isArray(collection.value)
-                ? collection.value.length
-                : Object.keys(collection.value).length;
-            return (length > Math.max(1, minimumRowsByPath.get(collection.path) ?? 0));
-        })
-            .map((collection) => ({
-            collection,
-            length: Array.isArray(collection.value)
-                ? collection.value.length
-                : Object.keys(collection.value).length,
-        }))
-            .sort((left, right) => right.length - left.length ||
-            left.collection.path.localeCompare(right.collection.path))[0]?.collection;
-        if (!candidate)
-            return;
-        const minimumRows = Math.max(1, minimumRowsByPath.get(candidate.path) ?? 0);
-        if (Array.isArray(candidate.value)) {
-            candidate.value.splice(-Math.min(candidate.value.length - minimumRows, Math.max(1, Math.ceil(candidate.value.length / 2))));
-        }
-        else {
-            const keys = Object.keys(candidate.value);
-            for (const key of keys.slice(-Math.min(keys.length - minimumRows, Math.max(1, Math.ceil(keys.length / 2))))) {
-                delete candidate.value[key];
-            }
-        }
-        receipt.rows_compacted = true;
-        receipt.compacted_row_paths = [
-            ...new Set([...(receipt.compacted_row_paths ?? []), candidate.path]),
-        ].sort((left, right) => left.localeCompare(right));
-        result.has_more = true;
-        result.truncated = true;
-        if (typeof result.count === "number") {
-            result.count = countReadOutputRows(result);
-        }
-    }
-}
-/** Compact strings and rows in place, then return the final exact estimate. */
-export function compactReadOutputToBudget(result, receipt, budget, minimumRowsByPath = new Map()) {
-    const stringCompactionState = { compacted: false };
-    const compacted = compactStrings(result, stringCompactionState);
-    receipt.strings_compacted = stringCompactionState.compacted;
-    compacted.read_output = receipt;
-    compactRowsToBudget(compacted, receipt, budget, minimumRowsByPath);
-    updateReadOutputReceiptEstimate(compacted, receipt);
-    return compacted;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1f54b7c3-9d49-5e67-88fa-b5b87748e02f")}catch(e2){}})();import{countReadOutputRows,readOutputBudgetCollections}from"./read-output-rows.js";const MAX_ESTIMATE_ITERATIONS=8;const MAX_COMPACTION_ITERATIONS=64;const RECOVERY_MARGIN_NUMERATOR=5;const RECOVERY_MARGIN_DENOMINATOR=4;const RECOVERY_ROUNDING_TOKENS=100;function resolveReadOutputRecoveryBudget(input){const binding=Math.trunc(input.effective_budget_tokens);const measured=Math.trunc(input.measured_result_tokens);if(!Number.isSafeInteger(binding)||binding<=0||!Number.isSafeInteger(measured)||measured<=0){return{output_budget:"unbounded",recovery_budget_multiplier:null,rule_version:"v1"}}const baseline=Math.max(binding+1,measured);const withMargin=Math.ceil(baseline*RECOVERY_MARGIN_NUMERATOR/RECOVERY_MARGIN_DENOMINATOR);const rounded=Math.ceil(withMargin/RECOVERY_ROUNDING_TOKENS)*RECOVERY_ROUNDING_TOKENS;if(!Number.isSafeInteger(rounded)){return{output_budget:"unbounded",recovery_budget_multiplier:null,rule_version:"v1"}}return{output_budget:rounded,recovery_budget_multiplier:rounded/binding,rule_version:"v1"}}function estimateReadOutputTokens(result){return Math.ceil(Buffer.byteLength(JSON.stringify(result),"utf8")/4)}function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function compactStrings(value,state){if(typeof value==="string"){if(value.length<=240)return value;state.compacted=true;return`${value.slice(0,240)}\u2026`}if(Array.isArray(value)){return value.map(entry=>compactStrings(entry,state))}if(!isRecord(value))return value;return Object.fromEntries(Object.entries(value).map(([key,entry])=>[key,compactStrings(entry,state)]))}function updateReadOutputReceiptEstimate(result,receipt){let estimate=receipt.estimated_tokens;for(let iteration=0;iteration<MAX_ESTIMATE_ITERATIONS;iteration+=1){receipt.estimated_tokens=estimate;const measured=estimateReadOutputTokens(result);if(measured===estimate)return;estimate=measured}receipt.estimated_tokens=estimate}function compactRowsToBudget(result,receipt,budget,minimumRowsByPath){for(let iteration=0;iteration<MAX_COMPACTION_ITERATIONS;iteration+=1){updateReadOutputReceiptEstimate(result,receipt);if(receipt.estimated_tokens<=budget)return;const candidate=readOutputBudgetCollections(result).filter(collection=>{const length=Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length;return length>Math.max(1,minimumRowsByPath.get(collection.path)??0)}).map(collection=>({collection,length:Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length})).sort((left,right)=>right.length-left.length||left.collection.path.localeCompare(right.collection.path))[0]?.collection;if(!candidate)return;const minimumRows=Math.max(1,minimumRowsByPath.get(candidate.path)??0);if(Array.isArray(candidate.value)){candidate.value.splice(-Math.min(candidate.value.length-minimumRows,Math.max(1,Math.ceil(candidate.value.length/2))))}else{const keys=Object.keys(candidate.value);for(const key of keys.slice(-Math.min(keys.length-minimumRows,Math.max(1,Math.ceil(keys.length/2))))){delete candidate.value[key]}}receipt.rows_compacted=true;receipt.compacted_row_paths=[...new Set([...receipt.compacted_row_paths??[],candidate.path])].sort((left,right)=>left.localeCompare(right));result.has_more=true;result.truncated=true;if(typeof result.count==="number"){result.count=countReadOutputRows(result)}}}function compactReadOutputToBudget(result,receipt,budget,minimumRowsByPath=new Map){const stringCompactionState={compacted:false};const compacted=compactStrings(result,stringCompactionState);receipt.strings_compacted=stringCompactionState.compacted;compacted.read_output=receipt;compactRowsToBudget(compacted,receipt,budget,minimumRowsByPath);updateReadOutputReceiptEstimate(compacted,receipt);return compacted}export{compactReadOutputToBudget,estimateReadOutputTokens,resolveReadOutputRecoveryBudget,updateReadOutputReceiptEstimate};
 //# sourceMappingURL=read-output-budget.js.map
-//# debugId=02a0bd0c-6ab0-5193-807b-00394a4712b7

package/dist/sdk/read-output-contracts.d.ts

@@ -150,7 +150,7 @@ export interface PmReadOutputTruncationDisclosure {
     recovery_budget_multiplier: number | null;
     /** Bounded continuation instructions for every compacted declared row path. */
     continuations: PmReadOutputContinuation[];
-    /** Executable recovery instruction for retrieving the complete result. */
+    /** Retry guidance, or `recovery` to require the adjacent cursor and transport bindings. */
     restore_with: string;
     /** Transport-specific machine recovery options. */
     recovery: {