Function logStack

agent/stack.ts:12–50

(
    context: CpuContext,
    maxEntries = DEFAULT_MAX_ENTRIES,
    previous?: StackSnapshot | null,
)

export type StackSnapshot = Record<string, string>;

export function logStack(
    context: CpuContext,
    maxEntries = DEFAULT_MAX_ENTRIES,
    previous?: StackSnapshot | null,
): StackSnapshot {
    const sp = getStackPointer(context);
    const fp = getFramePointer(context);
    if (sp === null) {
        log("[stk] no stack pointer in current context", "yellow");
        return {};
    }

    const snapshot: StackSnapshot = {};
    const markers = getContextMarkers(context, sp, fp);
    const totalEntries = getEntryCount(sp, fp, maxEntries);
    const headEntries = Math.min(DEFAULT_HEAD_ENTRIES, maxEntries);
    const tailEntries = Math.min(DEFAULT_TAIL_ENTRIES, Math.max(maxEntries - headEntries, 0));
    const omitted = totalEntries > maxEntries;

    log("[stk] ------------------------------------------------------------", "cyan");
    log(`[stk] fp=${fp ?? "n/a"} -> sp=${sp} entries=${totalEntries}${omitted ? " (truncated)" : ""}`, "green");

    let didOmit = false;
    for (const index of getDisplayIndices(totalEntries, omitted, headEntries, tailEntries)) {
        if (index === -1) {
            if (!didOmit) {
                const omittedCount = totalEntries - headEntries - tailEntries;
                log(`[stk] ... ${omittedCount} entries omitted ...`, "yellow");
                didOmit = true;
            }
            continue;
        }

        const slot = sp.add(index * Process.pointerSize);
        logStackSlot(index, slot, snapshot, previous, markers);
    }

    return snapshot;
}

function getDisplayIndices(totalEntries: number, omitted: boolean, headEntries: number, tailEntries: number): number[] {
    if (!omitted) {