@unbrained/pm-cli 2026.9.7 → 2026.9.8

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

@@ -1,187 +1,2 @@
-/**
- * @module sdk/read-output-rows
- *
- * Resolves and transforms the row collections declared by universal read
- * envelopes, including dot-delimited nested paths used by graph projections.
- */
-
-!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]="810d42b5-98f4-57a7-bdd9-2dfa1b2b1c03")}catch(e){}}();
-const BUDGET_METADATA_ROOT_KEYS = new Set([
-    "applied_bound",
-    "completeness",
-    "budget_retention_policy",
-    "continuation_contract",
-    "continuation_kind",
-    "continuation_path",
-    "filters",
-    "omission_receipt",
-    "output_budget_truncation",
-    "projection",
-    "read_output",
-    "read_session",
-    "row_contract",
-    "sorting",
-]);
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/** Read one dot-delimited path without treating missing segments as rows. */
-function valueAtPath(result, rowPath) {
-    let value = result;
-    for (const segment of rowPath.split(".")) {
-        if (Array.isArray(value)) {
-            if (!/^\d+$/u.test(segment))
-                return undefined;
-            value = value[Number(segment)];
-        }
-        else {
-            if (!isRecord(value))
-                return undefined;
-            value = value[segment];
-        }
-    }
-    return value;
-}
-/** Clone the owners along one row path and replace only its terminal value. */
-function replaceValueAtPath(result, rowPath, replacement) {
-    const segments = rowPath.split(".");
-    const replace = (value, offset) => {
-        if (offset === segments.length)
-            return replacement;
-        const segment = segments[offset];
-        if (Array.isArray(value)) {
-            const index = Number(segment);
-            const cloned = [...value];
-            cloned[index] = replace(value[index], offset + 1);
-            return cloned;
-        }
-        const record = value;
-        return {
-            ...record,
-            [segment]: replace(record[segment], offset + 1),
-        };
-    };
-    return replace(result, 0);
-}
-/** Replace one declared row collection with a suffix beginning at an offset. */
-export function sliceReadOutputRowCollection(result, rowPath, offset) {
-    const collection = readOutputContinuationRowCollections(result).find((entry) => entry.path === rowPath);
-    if (!collection)
-        return result;
-    const replacement = Array.isArray(collection.value)
-        ? collection.value.slice(offset)
-        : Object.fromEntries(Object.entries(collection.value).slice(offset));
-    return replaceValueAtPath(result, rowPath, replacement);
-}
-/** Resolve declared row paths, falling back to top-level array properties. */
-export function readOutputRowPaths(result) {
-    const contract = result.row_contract;
-    if (isRecord(contract) && Array.isArray(contract.row_keys)) {
-        return contract.row_keys.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
-    }
-    return Object.entries(result)
-        .filter(([, value]) => Array.isArray(value))
-        .map(([key]) => key);
-}
-/** Resolve collections that may be resumed independently from primary result rows. */
-export function readOutputContinuationRowPaths(result) {
-    const contract = result.row_contract;
-    if (isRecord(contract) && Array.isArray(contract.continuation_row_keys)) {
-        return contract.continuation_row_keys.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
-    }
-    return readOutputRowPaths(result);
-}
-/** Resolve every declared row path that currently contains iterable rows. */
-export function readOutputRowCollections(result) {
-    return readOutputRowPaths(result).flatMap((rowPath) => {
-        const value = valueAtPath(result, rowPath);
-        return Array.isArray(value) || isRecord(value)
-            ? [{ path: rowPath, value }]
-            : [];
-    });
-}
-/** Resolve every declared continuation path that currently contains iterable rows. */
-export function readOutputContinuationRowCollections(result) {
-    return readOutputContinuationRowPaths(result).flatMap((rowPath) => {
-        const value = valueAtPath(result, rowPath);
-        return Array.isArray(value) || isRecord(value)
-            ? [{ path: rowPath, value }]
-            : [];
-    });
-}
-/**
- * Discover every collection the token-budget degradation ladder may reduce.
- *
- * Ordinary field and amount projections stay bound to declared row paths (or
- * top-level array fallbacks), because a nested tag list is not an independent
- * result row. Budget degradation has a different obligation: it must exhaust
- * nested content collections before omitting the whole useful result. This
- * census therefore adds nested arrays while excluding receipt/envelope metadata
- * whose mutation would make the disclosure itself incomplete.
- */
-export function readOutputBudgetCollections(result) {
-    const collections = readOutputRowCollections(result);
-    const declaredPaths = new Set(collections.map((collection) => collection.path));
-    const visit = (value, path) => {
-        if (Array.isArray(value)) {
-            if (!declaredPaths.has(path)) {
-                collections.push({ path, value });
-            }
-            value.forEach((entry, index) => visit(entry, `${path}.${index}`));
-            return;
-        }
-        if (!isRecord(value))
-            return;
-        for (const [key, entry] of Object.entries(value)) {
-            if (path.length === 0 && BUDGET_METADATA_ROOT_KEYS.has(key))
-                continue;
-            visit(entry, path.length === 0 ? key : `${path}.${key}`);
-        }
-    };
-    visit(result, "");
-    return collections;
-}
-/** Count array entries and object-map values across declared row collections. */
-export function countReadOutputRows(result) {
-    return readOutputRowCollections(result).reduce((total, collection) => total +
-        (Array.isArray(collection.value)
-            ? collection.value.length
-            : Object.keys(collection.value).length), 0);
-}
-/**
- * Transform every declared row while preserving collection keys and cloning
- * only the owner objects along paths that changed.
- */
-export function mapReadOutputRows(result, transform) {
-    let projected = result;
-    for (const collection of readOutputRowCollections(projected)) {
-        const replacement = Array.isArray(collection.value)
-            ? collection.value.map((row, index) => transform(row, collection.path, index))
-            : Object.fromEntries(Object.entries(collection.value).map(([key, row], index) => [
-                key,
-                transform(row, collection.path, index),
-            ]));
-        projected = replaceValueAtPath(projected, collection.path, replacement);
-    }
-    return projected;
-}
-/** Bound every declared row collection independently and report truncation. */
-export function boundReadOutputRows(result, amount) {
-    let projected = result;
-    let truncated = false;
-    for (const collection of readOutputRowCollections(projected)) {
-        const entries = Array.isArray(collection.value)
-            ? collection.value
-            : Object.entries(collection.value);
-        if (entries.length <= amount)
-            continue;
-        truncated = true;
-        const replacement = Array.isArray(collection.value)
-            ? entries.slice(0, amount)
-            : Object.fromEntries(entries.slice(0, amount));
-        projected = replaceValueAtPath(projected, collection.path, replacement);
-    }
-    return { result: projected, truncated };
-}
+!(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]="85bc6b10-700a-5d06-970f-d544833dd059")}catch(e2){}})();const BUDGET_METADATA_ROOT_KEYS=new Set(["applied_bound","completeness","budget_retention_policy","continuation_contract","continuation_kind","continuation_path","filters","omission_receipt","output_budget_truncation","projection","read_output","read_session","row_contract","sorting"]);function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function valueAtPath(result,rowPath){let value=result;for(const segment of rowPath.split(".")){if(Array.isArray(value)){if(!/^\d+$/u.test(segment))return void 0;value=value[Number(segment)]}else{if(!isRecord(value))return void 0;value=value[segment]}}return value}function replaceValueAtPath(result,rowPath,replacement){const segments=rowPath.split(".");const replace=(value,offset)=>{if(offset===segments.length)return replacement;const segment=segments[offset];if(Array.isArray(value)){const index=Number(segment);const cloned=[...value];cloned[index]=replace(value[index],offset+1);return cloned}const record=value;return{...record,[segment]:replace(record[segment],offset+1)}};return replace(result,0)}function sliceReadOutputRowCollection(result,rowPath,offset){const collection=readOutputContinuationRowCollections(result).find(entry=>entry.path===rowPath);if(!collection)return result;const replacement=Array.isArray(collection.value)?collection.value.slice(offset):Object.fromEntries(Object.entries(collection.value).slice(offset));return replaceValueAtPath(result,rowPath,replacement)}function readOutputRowPaths(result){const contract=result.row_contract;if(isRecord(contract)&&Array.isArray(contract.row_keys)){return contract.row_keys.filter(entry=>typeof entry==="string"&&entry.trim().length>0)}return Object.entries(result).filter(([,value])=>Array.isArray(value)).map(([key])=>key)}function readOutputContinuationRowPaths(result){const contract=result.row_contract;if(isRecord(contract)&&Array.isArray(contract.continuation_row_keys)){return contract.continuation_row_keys.filter(entry=>typeof entry==="string"&&entry.trim().length>0)}return readOutputRowPaths(result)}function readOutputRowCollections(result){return readOutputRowPaths(result).flatMap(rowPath=>{const value=valueAtPath(result,rowPath);return Array.isArray(value)||isRecord(value)?[{path:rowPath,value}]:[]})}function readOutputContinuationRowCollections(result){return readOutputContinuationRowPaths(result).flatMap(rowPath=>{const value=valueAtPath(result,rowPath);return Array.isArray(value)||isRecord(value)?[{path:rowPath,value}]:[]})}function readOutputBudgetCollections(result){const collections=readOutputRowCollections(result);const declaredPaths=new Set(collections.map(collection=>collection.path));const visit=(value,path)=>{if(Array.isArray(value)){if(!declaredPaths.has(path)){collections.push({path,value})}value.forEach((entry,index)=>visit(entry,`${path}.${index}`));return}if(!isRecord(value))return;for(const[key,entry]of Object.entries(value)){if(path.length===0&&BUDGET_METADATA_ROOT_KEYS.has(key))continue;visit(entry,path.length===0?key:`${path}.${key}`)}};visit(result,"");return collections}function countReadOutputRows(result){return readOutputRowCollections(result).reduce((total,collection)=>total+(Array.isArray(collection.value)?collection.value.length:Object.keys(collection.value).length),0)}function mapReadOutputRows(result,transform){let projected=result;for(const collection of readOutputRowCollections(projected)){const replacement=Array.isArray(collection.value)?collection.value.map((row,index)=>transform(row,collection.path,index)):Object.fromEntries(Object.entries(collection.value).map(([key,row],index)=>[key,transform(row,collection.path,index)]));projected=replaceValueAtPath(projected,collection.path,replacement)}return projected}function boundReadOutputRows(result,amount){let projected=result;let truncated=false;for(const collection of readOutputRowCollections(projected)){const entries=Array.isArray(collection.value)?collection.value:Object.entries(collection.value);if(entries.length<=amount)continue;truncated=true;const replacement=Array.isArray(collection.value)?entries.slice(0,amount):Object.fromEntries(entries.slice(0,amount));projected=replaceValueAtPath(projected,collection.path,replacement)}return{result:projected,truncated}}export{boundReadOutputRows,countReadOutputRows,mapReadOutputRows,readOutputBudgetCollections,readOutputContinuationRowCollections,readOutputContinuationRowPaths,readOutputRowCollections,readOutputRowPaths,sliceReadOutputRowCollection};
 //# sourceMappingURL=read-output-rows.js.map
-//# debugId=810d42b5-98f4-57a7-bdd9-2dfa1b2b1c03

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

@@ -1,209 +1,2 @@
-/**
- * @module sdk/read-output-session
- *
- * Implements a stateless, caller-carried session ledger for cross-call output
- * budgets and resolvable references to item facts served by earlier reads.
- */
-
-!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]="bb73f77d-d372-5d68-8ef2-90b208129f21")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { mapReadOutputRows, readOutputRowCollections, } from "./read-output-rows.js";
-/** Smallest session ceiling that can carry a useful result and both receipts. */
-export const PM_READ_OUTPUT_SESSION_MIN_TOKENS = 256;
-/** Maximum caller-carried served-item identities accepted in one session state. */
-export const PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS = 10_000;
-const SESSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/u;
-const ITEM_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u;
-const SESSION_KEYS = new Set([
-    "version",
-    "id",
-    "token_budget",
-    "spent_tokens",
-    "seen_item_ids",
-]);
-const SESSION_FIELD_VALIDATIONS = [
-    {
-        valid: (state) => state.version === 1,
-        reason: "version must equal 1.",
-    },
-    {
-        valid: (state) => typeof state.id === "string" && SESSION_ID_PATTERN.test(state.id),
-        reason: "id must be 1-64 portable identifier characters.",
-    },
-    {
-        valid: (state) => Number.isSafeInteger(state.token_budget) &&
-            state.token_budget >= PM_READ_OUTPUT_SESSION_MIN_TOKENS,
-        reason: `token_budget must be a safe integer of at least ${PM_READ_OUTPUT_SESSION_MIN_TOKENS}.`,
-    },
-    {
-        valid: (state) => Number.isSafeInteger(state.spent_tokens) &&
-            state.spent_tokens >= 0 &&
-            state.spent_tokens <= state.token_budget,
-        reason: "spent_tokens must be a non-negative safe integer no larger than token_budget.",
-    },
-    {
-        valid: (state) => Array.isArray(state.seen_item_ids) &&
-            state.seen_item_ids.length <=
-                PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS &&
-            state.seen_item_ids.every((id) => typeof id === "string" && ITEM_ID_PATTERN.test(id)),
-        reason: `seen_item_ids must contain at most ${PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS} portable item identifiers.`,
-    },
-];
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-/** Throw one stable usage refusal for a malformed caller-carried session. */
-function invalidSession(reason) {
-    throw new PmCliError(`--output-session ${reason}`, EXIT_CODE.USAGE, {
-        code: "invalid_read_output_session",
-        field: "outputSession",
-    });
-}
-/** Parse and strictly validate a JSON string or typed session-state object. */
-export function parseReadOutputSession(value) {
-    if (value === undefined)
-        return undefined;
-    let parsed = value;
-    if (typeof value === "string") {
-        try {
-            parsed = JSON.parse(value);
-        }
-        catch {
-            invalidSession("must be a valid JSON object.");
-        }
-    }
-    if (!isRecord(parsed))
-        invalidSession("must be a JSON object.");
-    const unknownKeys = Object.keys(parsed).filter((key) => !SESSION_KEYS.has(key));
-    if (unknownKeys.length > 0) {
-        invalidSession(`contains unknown field "${unknownKeys.sort()[0]}".`);
-    }
-    const invalidField = SESSION_FIELD_VALIDATIONS.find((validation) => !validation.valid(parsed));
-    if (invalidField !== undefined)
-        invalidSession(invalidField.reason);
-    const seenItemIds = [...new Set(parsed.seen_item_ids)].sort();
-    return {
-        version: 1,
-        id: parsed.id,
-        token_budget: parsed.token_budget,
-        spent_tokens: parsed.spent_tokens,
-        seen_item_ids: seenItemIds,
-    };
-}
-/** Resolve an item identity from built-in list rows and nested search hits. */
-function itemIdFromRow(row) {
-    if (!isRecord(row))
-        return undefined;
-    if (typeof row.id === "string")
-        return row.id;
-    if (typeof row.item_id === "string")
-        return row.item_id;
-    return isRecord(row.item) && typeof row.item.id === "string"
-        ? row.item.id
-        : undefined;
-}
-/** Summarize delivered item facts and compact references across row paths. */
-function summarizeReadOutputSessionRows(result) {
-    const deliveredIds = new Set();
-    let suppressedRepeatCount = 0;
-    for (const collection of readOutputRowCollections(result)) {
-        const rows = Array.isArray(collection.value)
-            ? collection.value
-            : Object.values(collection.value);
-        for (const row of rows) {
-            if (!isRecord(row))
-                continue;
-            if (typeof row.context_ref === "string") {
-                suppressedRepeatCount += 1;
-                continue;
-            }
-            const itemId = itemIdFromRow(row);
-            // Activity can contain workspace pseudo-identities. Preserve those rows
-            // in the response, but only carry ids the next invocation can consume.
-            if (itemId !== undefined && ITEM_ID_PATTERN.test(itemId))
-                deliveredIds.add(itemId);
-        }
-    }
-    return { deliveredIds, suppressedRepeatCount };
-}
-/** Replace previously served item rows with compact, resolvable references. */
-export function applyReadOutputSessionReferences(result, state) {
-    const seen = new Set(state.seen_item_ids);
-    return mapReadOutputRows(result, (row) => {
-        const itemId = itemIdFromRow(row);
-        return itemId !== undefined && seen.has(itemId)
-            ? {
-                id: itemId,
-                context_ref: `session:${state.id}:${itemId}`,
-            }
-            : row;
-    });
-}
-/** Attach a fixed-point session receipt and return the exact charged tokens. */
-export function attachReadOutputSessionReceipt(result, state) {
-    const { deliveredIds, suppressedRepeatCount } = summarizeReadOutputSessionRows(result);
-    const alreadySeen = new Set(state.seen_item_ids);
-    const newlySeen = [...deliveredIds]
-        .filter((id) => !alreadySeen.has(id))
-        .sort();
-    const retainedNewIds = newlySeen.slice(0, PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS - state.seen_item_ids.length);
-    const nextSeen = [...state.seen_item_ids, ...retainedNewIds].sort();
-    const seenItemOverflowCount = newlySeen.length - retainedNewIds.length;
-    const receipt = {
-        contract_version: 1,
-        id: state.id,
-        measurement_scope: "complete_read_envelope",
-        estimator: "ceil(utf8_bytes / 4)",
-        token_budget: state.token_budget,
-        spent_before_tokens: state.spent_tokens,
-        spent_this_call_tokens: 0,
-        charged_this_call_tokens: 0,
-        spent_total_tokens: state.spent_tokens,
-        remaining_tokens: state.token_budget - state.spent_tokens,
-        exhausted: false,
-        seen_before_count: state.seen_item_ids.length,
-        new_item_count: deliveredIds.size,
-        ...(seenItemOverflowCount === 0
-            ? {}
-            : { seen_item_overflow_count: seenItemOverflowCount }),
-        suppressed_repeat_count: suppressedRepeatCount,
-        reference_format: "session:<session-id>:<item-id>",
-        restore_reference_with: "pm get <item-id> --brief",
-        next_state: {
-            version: 1,
-            id: state.id,
-            token_budget: state.token_budget,
-            spent_tokens: state.spent_tokens,
-            seen_item_ids: nextSeen,
-        },
-    };
-    const withReceipt = { ...result, read_session: receipt };
-    const applyEstimate = (estimate) => {
-        receipt.spent_this_call_tokens = estimate;
-        receipt.charged_this_call_tokens = Math.min(state.token_budget - state.spent_tokens, estimate);
-        receipt.spent_total_tokens = Math.min(state.token_budget, state.spent_tokens + receipt.charged_this_call_tokens);
-        receipt.remaining_tokens = Math.max(0, state.token_budget - receipt.spent_total_tokens);
-        receipt.exhausted =
-            receipt.remaining_tokens < PM_READ_OUTPUT_SESSION_MIN_TOKENS;
-        receipt.next_state.spent_tokens = receipt.spent_total_tokens;
-    };
-    let estimate = 0;
-    let highestMeasuredEstimate = 0;
-    for (let iteration = 0; iteration < 8; iteration += 1) {
-        applyEstimate(estimate);
-        const measured = Math.ceil(Buffer.byteLength(JSON.stringify(withReceipt), "utf8") / 4);
-        if (measured === estimate)
-            return withReceipt;
-        highestMeasuredEstimate = Math.max(highestMeasuredEstimate, measured);
-        estimate = measured;
-    }
-    applyEstimate(highestMeasuredEstimate);
-    return withReceipt;
-}
-/** Return the unspent group budget available to the current invocation. */
-export function readOutputSessionRemainingTokens(state) {
-    return Math.max(0, state.token_budget - state.spent_tokens);
-}
+!(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]="a615d8e9-3fcd-50a8-8a54-8040c4458c4a")}catch(e2){}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{mapReadOutputRows,readOutputRowCollections}from"./read-output-rows.js";const PM_READ_OUTPUT_SESSION_MIN_TOKENS=256;const PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS=1e4;const SESSION_ID_PATTERN=/^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/u;const ITEM_ID_PATTERN=/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u;const SESSION_KEYS=new Set(["version","id","token_budget","spent_tokens","seen_item_ids"]);const SESSION_FIELD_VALIDATIONS=[{valid:state=>state.version===1,reason:"version must equal 1."},{valid:state=>typeof state.id==="string"&&SESSION_ID_PATTERN.test(state.id),reason:"id must be 1-64 portable identifier characters."},{valid:state=>Number.isSafeInteger(state.token_budget)&&state.token_budget>=PM_READ_OUTPUT_SESSION_MIN_TOKENS,reason:`token_budget must be a safe integer of at least ${PM_READ_OUTPUT_SESSION_MIN_TOKENS}.`},{valid:state=>Number.isSafeInteger(state.spent_tokens)&&state.spent_tokens>=0&&state.spent_tokens<=state.token_budget,reason:"spent_tokens must be a non-negative safe integer no larger than token_budget."},{valid:state=>Array.isArray(state.seen_item_ids)&&state.seen_item_ids.length<=PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS&&state.seen_item_ids.every(id=>typeof id==="string"&&ITEM_ID_PATTERN.test(id)),reason:`seen_item_ids must contain at most ${PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS} portable item identifiers.`}];function isRecord(value){return value!==null&&typeof value==="object"&&!Array.isArray(value)}function invalidSession(reason){throw new PmCliError(`--output-session ${reason}`,EXIT_CODE.USAGE,{code:"invalid_read_output_session",field:"outputSession"})}function parseReadOutputSession(value){if(value===void 0)return void 0;let parsed=value;if(typeof value==="string"){try{parsed=JSON.parse(value)}catch{invalidSession("must be a valid JSON object.")}}if(!isRecord(parsed))invalidSession("must be a JSON object.");const unknownKeys=Object.keys(parsed).filter(key=>!SESSION_KEYS.has(key));if(unknownKeys.length>0){invalidSession(`contains unknown field "${unknownKeys.sort()[0]}".`)}const invalidField=SESSION_FIELD_VALIDATIONS.find(validation=>!validation.valid(parsed));if(invalidField!==void 0)invalidSession(invalidField.reason);const seenItemIds=[...new Set(parsed.seen_item_ids)].sort();return{version:1,id:parsed.id,token_budget:parsed.token_budget,spent_tokens:parsed.spent_tokens,seen_item_ids:seenItemIds}}function itemIdFromRow(row){if(!isRecord(row))return void 0;if(typeof row.id==="string")return row.id;if(typeof row.item_id==="string")return row.item_id;return isRecord(row.item)&&typeof row.item.id==="string"?row.item.id:void 0}function summarizeReadOutputSessionRows(result){const deliveredIds=new Set;let suppressedRepeatCount=0;for(const collection of readOutputRowCollections(result)){const rows=Array.isArray(collection.value)?collection.value:Object.values(collection.value);for(const row of rows){if(!isRecord(row))continue;if(typeof row.context_ref==="string"){suppressedRepeatCount+=1;continue}const itemId=itemIdFromRow(row);if(itemId!==void 0&&ITEM_ID_PATTERN.test(itemId))deliveredIds.add(itemId)}}return{deliveredIds,suppressedRepeatCount}}function applyReadOutputSessionReferences(result,state){const seen=new Set(state.seen_item_ids);return mapReadOutputRows(result,row=>{const itemId=itemIdFromRow(row);return itemId!==void 0&&seen.has(itemId)?{id:itemId,context_ref:`session:${state.id}:${itemId}`}:row})}function attachReadOutputSessionReceipt(result,state){const{deliveredIds,suppressedRepeatCount}=summarizeReadOutputSessionRows(result);const alreadySeen=new Set(state.seen_item_ids);const newlySeen=[...deliveredIds].filter(id=>!alreadySeen.has(id)).sort();const retainedNewIds=newlySeen.slice(0,PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS-state.seen_item_ids.length);const nextSeen=[...state.seen_item_ids,...retainedNewIds].sort();const seenItemOverflowCount=newlySeen.length-retainedNewIds.length;const receipt={contract_version:1,id:state.id,measurement_scope:"complete_read_envelope",estimator:"ceil(utf8_bytes / 4)",token_budget:state.token_budget,spent_before_tokens:state.spent_tokens,spent_this_call_tokens:0,charged_this_call_tokens:0,spent_total_tokens:state.spent_tokens,remaining_tokens:state.token_budget-state.spent_tokens,exhausted:false,seen_before_count:state.seen_item_ids.length,new_item_count:deliveredIds.size,...seenItemOverflowCount===0?{}:{seen_item_overflow_count:seenItemOverflowCount},suppressed_repeat_count:suppressedRepeatCount,reference_format:"session:<session-id>:<item-id>",restore_reference_with:"pm get <item-id> --brief",next_state:{version:1,id:state.id,token_budget:state.token_budget,spent_tokens:state.spent_tokens,seen_item_ids:nextSeen}};const withReceipt={...result,read_session:receipt};const applyEstimate=estimate2=>{receipt.spent_this_call_tokens=estimate2;receipt.charged_this_call_tokens=Math.min(state.token_budget-state.spent_tokens,estimate2);receipt.spent_total_tokens=Math.min(state.token_budget,state.spent_tokens+receipt.charged_this_call_tokens);receipt.remaining_tokens=Math.max(0,state.token_budget-receipt.spent_total_tokens);receipt.exhausted=receipt.remaining_tokens<PM_READ_OUTPUT_SESSION_MIN_TOKENS;receipt.next_state.spent_tokens=receipt.spent_total_tokens};let estimate=0;let highestMeasuredEstimate=0;for(let iteration=0;iteration<8;iteration+=1){applyEstimate(estimate);const measured=Math.ceil(Buffer.byteLength(JSON.stringify(withReceipt),"utf8")/4);if(measured===estimate)return withReceipt;highestMeasuredEstimate=Math.max(highestMeasuredEstimate,measured);estimate=measured}applyEstimate(highestMeasuredEstimate);return withReceipt}function readOutputSessionRemainingTokens(state){return Math.max(0,state.token_budget-state.spent_tokens)}export{PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS,PM_READ_OUTPUT_SESSION_MIN_TOKENS,applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens};
 //# sourceMappingURL=read-output-session.js.map
-//# debugId=bb73f77d-d372-5d68-8ef2-90b208129f21