@herbertgao/pi-extensions 2026.9.20 → 2026.10.0

package/node_modules/@herbertgao/resume-from/dist/adapters/codex/read.js

@@ -1,270 +0,0 @@
-/**
- * The source role: a Codex home becomes a list of sessions, and one session becomes the
- * canonical vocabulary. Every result body is dropped (FR-24) and every reasoning trace is
- * ignored (FR-28, C-4).
- */
-import { readFile } from "node:fs/promises";
-import { isAbsolute } from "node:path";
-import { redactSensitiveArgumentsText, redactSensitiveText } from "./redaction.js";
-import { CODEX_ENTRY_COMPACTED, CODEX_ENTRY_EVENT_MSG, CODEX_ENTRY_RESPONSE_ITEM, CODEX_EVENT_AGENT_MESSAGE, CODEX_EVENT_USER_MESSAGE, CODEX_ITEM_CUSTOM_TOOL_CALL, CODEX_ITEM_CUSTOM_TOOL_CALL_OUTPUT, CODEX_ITEM_FUNCTION_CALL, CODEX_ITEM_FUNCTION_CALL_OUTPUT, isNotFoundError, KNOWN_ENTRY_TYPES, listRolloutFiles, parseRolloutText, payloadType, readSessionMeta, sessionsRoot, toIsoUtc, } from "./rollout.js";
-const TITLE_LIMIT = 80;
-const ARGUMENTS_PREVIEW_LIMIT = 60;
-/** Tools whose name alone settles the question (FR-26). Everything else stays "unknown". */
-const READ_ONLY_TOOLS = new Set([
-    "read_file",
-    "read",
-    "view_image",
-    "list_dir",
-    "grep",
-    "find",
-    "web_search",
-]);
-const MUTATING_TOOLS = new Set([
-    "apply_patch",
-    "write_file",
-    "edit_file",
-    "create_file",
-    "delete_file",
-]);
-export class CodexRolloutUnreadableError extends Error {
-    constructor(filePath) {
-        super(`Codex thread is unreadable: ${filePath} was cut mid-entry`);
-        this.name = "CodexRolloutUnreadableError";
-    }
-}
-/** Lenient: a file cut mid-entry still yields whatever parsed, with `truncated` set. */
-export async function scanRollout(filePath) {
-    // Whole-file read: listing a home reads every rollout, and C-5 measured those files
-    // in megabytes. Ceiling accepted because title and turn count both need the whole file;
-    // revisit if a home with thousands of threads makes the listing feel slow.
-    const text = await readFile(filePath, "utf8");
-    const { entries, truncated } = parseRolloutText(text);
-    let meta = null;
-    for (const entry of entries) {
-        meta = readSessionMeta(entry);
-        if (meta !== null)
-            break;
-    }
-    const { turns, skippedEntries, changedPaths } = toCanonicalTurns(entries);
-    const firstUserTurn = turns.find((turn) => turn.role === "user" && turn.kind === "message");
-    const lastStamp = [...entries].reverse().find((entry) => toIsoUtc(entry.timestamp) !== null);
-    return {
-        filePath,
-        meta,
-        turns,
-        skippedEntries,
-        startedAt: toIsoUtc(meta?.timestamp ?? entries[0]?.timestamp ?? null),
-        updatedAt: toIsoUtc(lastStamp?.timestamp ?? meta?.timestamp ?? null),
-        title: titleOf(firstUserTurn?.text ?? ""),
-        changedPaths,
-        truncated,
-    };
-}
-/** Strict: FR-51's "unreadable" answer. */
-export async function readRollout(filePath) {
-    const rollout = await scanRollout(filePath);
-    if (rollout.truncated)
-        throw new CodexRolloutUnreadableError(filePath);
-    return rollout;
-}
-export async function listCodexSessions(home) {
-    const descriptors = [];
-    for (const filePath of await listRolloutFiles(sessionsRoot(home))) {
-        let rollout;
-        try {
-            rollout = await scanRollout(filePath);
-        }
-        catch (error) {
-            if (isNotFoundError(error))
-                continue; // A rollout may disappear during a concurrent cleanup.
-            throw error;
-        }
-        if (rollout.meta === null)
-            continue;
-        descriptors.push({
-            ref: { agent: "codex", home, id: rollout.meta.id },
-            title: rollout.title,
-            startedAt: rollout.startedAt ?? "",
-            updatedAt: rollout.updatedAt ?? rollout.startedAt ?? "",
-            turnCount: rollout.turns.length,
-            repoPath: rollout.meta.cwd !== null && isAbsolute(rollout.meta.cwd) ? rollout.meta.cwd : null,
-            filePath,
-        });
-    }
-    descriptors.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
-    return descriptors;
-}
-export async function loadCodexSession(descriptor) {
-    const rollout = await readRollout(descriptor.filePath);
-    return {
-        provenance: {
-            ref: descriptor.ref,
-            title: descriptor.title,
-            startedAt: descriptor.startedAt,
-            updatedAt: descriptor.updatedAt,
-            repo: {
-                commit: rollout.meta?.commit ?? null,
-                branch: rollout.meta?.branch ?? null,
-                changedPaths: rollout.changedPaths,
-            },
-        },
-        turns: rollout.turns,
-    };
-}
-function titleOf(text) {
-    const line = text
-        .split("\n")
-        .find((candidate) => candidate.trim() !== "")
-        ?.trim() ?? "";
-    return line.length > TITLE_LIMIT ? `${line.slice(0, TITLE_LIMIT - 1)}…` : line;
-}
-/**
- * Messages come from `event_msg` and tool calls from `response_item`: the same text appears in
- * both shapes, and taking each from one place is what keeps every turn out of the session twice.
- * Reasoning, in either shape, produces nothing at all (C-4, FR-28, NG-8).
- */
-function toCanonicalTurns(entries) {
-    const outputs = new Map();
-    for (const entry of entries) {
-        if (entry.type !== CODEX_ENTRY_RESPONSE_ITEM)
-            continue;
-        const type = payloadType(entry);
-        if (type !== CODEX_ITEM_FUNCTION_CALL_OUTPUT && type !== CODEX_ITEM_CUSTOM_TOOL_CALL_OUTPUT)
-            continue;
-        const callId = entry.payload.call_id;
-        if (typeof callId !== "string")
-            continue;
-        outputs.set(callId, outputTextOf(entry.payload.output));
-    }
-    const turns = [];
-    const changed = new Set();
-    let skippedEntries = 0;
-    for (const entry of entries) {
-        if (!KNOWN_ENTRY_TYPES.has(entry.type)) {
-            skippedEntries += 1;
-            continue;
-        }
-        const type = payloadType(entry);
-        if (entry.type === CODEX_ENTRY_COMPACTED) {
-            const message = entry.payload.message;
-            if (typeof message !== "string" || message.trim() === "")
-                continue;
-            turns.push({
-                index: turns.length,
-                role: "agent",
-                kind: "summary",
-                // FR-28, security: credentials in message text must not cross to a different vendor.
-                text: redactSensitiveText(message),
-                toolCall: null,
-                timestamp: toIsoUtc(entry.timestamp),
-            });
-            continue;
-        }
-        if (entry.type === CODEX_ENTRY_EVENT_MSG) {
-            if (type !== CODEX_EVENT_USER_MESSAGE && type !== CODEX_EVENT_AGENT_MESSAGE)
-                continue;
-            const message = entry.payload.message;
-            if (typeof message !== "string" || message.trim() === "")
-                continue;
-            turns.push({
-                index: turns.length,
-                role: type === CODEX_EVENT_USER_MESSAGE ? "user" : "agent",
-                kind: "message",
-                // FR-28, security: credentials in message text must not cross to a different vendor.
-                text: redactSensitiveText(message),
-                toolCall: null,
-                timestamp: toIsoUtc(entry.timestamp),
-            });
-            continue;
-        }
-        if (entry.type !== CODEX_ENTRY_RESPONSE_ITEM)
-            continue;
-        if (type !== CODEX_ITEM_FUNCTION_CALL && type !== CODEX_ITEM_CUSTOM_TOOL_CALL)
-            continue;
-        const toolName = typeof entry.payload.name === "string" ? entry.payload.name : "";
-        if (toolName === "")
-            continue;
-        const rawArguments = type === CODEX_ITEM_FUNCTION_CALL ? entry.payload.arguments : entry.payload.input;
-        const argumentsText = typeof rawArguments === "string" ? rawArguments : "";
-        const callId = entry.payload.call_id;
-        // FR-54: use has() not get() — outputs.get() can return "" for an empty result.
-        const resultRecorded = typeof callId === "string" && outputs.has(callId);
-        const output = typeof callId === "string" ? (outputs.get(callId) ?? null) : null;
-        const toolCall = toolCallRecord(toolName, argumentsText, output, resultRecorded);
-        if (toolCall.effect === "mutating")
-            for (const path of pathsOf(argumentsText))
-                changed.add(path);
-        turns.push({
-            index: turns.length,
-            role: "agent",
-            kind: "tool-call",
-            text: "",
-            toolCall,
-            timestamp: toIsoUtc(entry.timestamp),
-        });
-    }
-    return { turns, skippedEntries, changedPaths: [...changed] };
-}
-/** Only the shape of the output is measured. Not one fragment of it is carried (FR-24, FR-25). */
-function toolCallRecord(toolName, argumentsText, output, resultRecorded) {
-    const safeArguments = redactSensitiveArgumentsText(argumentsText);
-    const head = `${toolName}(${singleLine(safeArguments, ARGUMENTS_PREVIEW_LIMIT)})`;
-    const outcomeLine = output === null
-        ? `${head} → no output recorded`
-        : `${head} → ${output.split("\n").length} lines, body dropped`;
-    return {
-        toolName,
-        argumentsText: safeArguments,
-        outcomeLine: redactSensitiveText(outcomeLine),
-        effect: effectOf(toolName),
-        bodyDropped: output !== null,
-        // FR-54: false when no *_call_output entry existed for this call_id (broken tail signal).
-        resultRecorded,
-    };
-}
-function effectOf(toolName) {
-    if (MUTATING_TOOLS.has(toolName))
-        return "mutating";
-    if (READ_ONLY_TOOLS.has(toolName))
-        return "read-only";
-    return "unknown";
-}
-function outputTextOf(output) {
-    if (typeof output === "string")
-        return output;
-    if (Array.isArray(output)) {
-        return output
-            .map((part) => typeof part === "object" && part !== null
-            ? String(part.text ?? "")
-            : "")
-            .join("\n");
-    }
-    return output === undefined || output === null ? "" : JSON.stringify(output);
-}
-function singleLine(text, limit) {
-    const flat = text.replaceAll(/\s+/g, " ").trim();
-    return flat.length > limit ? `${flat.slice(0, limit - 1)}…` : flat;
-}
-/** Files a mutating call touched, for RepoSnapshot.changedPaths (FR-36). */
-function pathsOf(argumentsText) {
-    let text = argumentsText;
-    const direct = [];
-    try {
-        const parsed = JSON.parse(argumentsText);
-        if (typeof parsed === "object" && parsed !== null) {
-            const record = parsed;
-            const strings = Object.values(record).filter((value) => typeof value === "string");
-            text = strings.join("\n");
-            for (const key of ["path", "file_path", "filename"]) {
-                const value = record[key];
-                if (typeof value === "string" && value !== "")
-                    direct.push(value);
-            }
-        }
-    }
-    catch {
-        // Arguments that are not JSON are searched as they were recorded.
-    }
-    const patched = [...text.matchAll(/\*\*\* (?:Add|Update|Delete) File: (.+)/g)].map((match) => (match[1] ?? "").trim());
-    return [...direct, ...patched].filter((path) => path !== "");
-}

package/node_modules/@herbertgao/resume-from/dist/import/discovery/finder.js

@@ -1,129 +0,0 @@
-// The source side of the tool: find the sessions of this repository, order them, resolve the
-// user's choice, and load it. It never writes and never calls a model (NG-1, AC-4, FR-8).
-import { SessionSelectionError } from "./errors.js";
-import { buildSearchList, canonicalPath, isDirectory, } from "./homes.js";
-import { compareDescriptors } from "./ordering.js";
-const NEXT_STEP = "Run the list again to see the sessions available in this repository.";
-function reasonLine(reason) {
-    const text = reason instanceof Error ? reason.message : String(reason);
-    return text.split("\n")[0] ?? "unknown error";
-}
-export function createSessionFinder(deps) {
-    async function collect(target, repoRoot) {
-        // A home the user named must never fail silently: adapters swallow a missing
-        // directory (an absent default home is normal), but a typo'd --home is not (FR-2).
-        if (target.named === true && !(await isDirectory(target.home))) {
-            return {
-                rows: [],
-                failures: [
-                    {
-                        home: target.home,
-                        agent: target.agent,
-                        message: "home not searched: no such directory",
-                    },
-                ],
-            };
-        }
-        let found;
-        try {
-            found = await target.adapter.listSessions(target.home);
-        }
-        catch (reason) {
-            // One bad home never empties the listing.
-            return {
-                rows: [],
-                failures: [
-                    {
-                        home: target.home,
-                        agent: target.agent,
-                        message: `home not searched: ${reasonLine(reason)}`,
-                    },
-                ],
-            };
-        }
-        const rows = [];
-        const failures = [];
-        for (const descriptor of found) {
-            if (descriptor.repoPath === null) {
-                // Out of scope, but never silent: the tool cannot show that it belongs here.
-                failures.push({
-                    home: target.home,
-                    agent: target.agent,
-                    message: `session ${descriptor.ref.id} records no repository, so it cannot be listed here`,
-                });
-                continue;
-            }
-            if ((await canonicalPath(descriptor.repoPath)) === repoRoot)
-                rows.push(descriptor); // FR-13
-        }
-        return { rows, failures };
-    }
-    /** The single listing both `list` and `resolve` use, so the two always agree (FR-10). */
-    async function buildListing(scope) {
-        const targets = await buildSearchList(deps.adapters, deps.config, scope);
-        const repoRoot = await canonicalPath(scope.repoRoot);
-        const collected = await Promise.all(targets.map((target) => collect(target, repoRoot)));
-        const rows = [];
-        const failures = [];
-        for (const part of collected) {
-            rows.push(...part.rows);
-            failures.push(...part.failures);
-        }
-        rows.sort(compareDescriptors);
-        return { rows, failures };
-    }
-    async function resolveRow(rows, row) {
-        const chosen = Number.isInteger(row) && row >= 1 ? rows[row - 1] : undefined;
-        if (!chosen) {
-            throw new SessionSelectionError(String(row), `Row ${row} is not in this repository's session list, which has ${rows.length} row(s). ${NEXT_STEP}`);
-        }
-        return chosen;
-    }
-    return {
-        async list(scope) {
-            return await buildListing(scope);
-        },
-        async resolve(scope, input) {
-            const { rows } = await buildListing(scope);
-            switch (input.by) {
-                case "row":
-                    return await resolveRow(rows, input.row);
-                case "session-id": {
-                    const matches = rows.filter((row) => row.ref.id === input.id);
-                    const found = matches[0];
-                    if (!found) {
-                        throw new SessionSelectionError(input.id, `No session "${input.id}" belongs to this repository. ${NEXT_STEP}`);
-                    }
-                    if (matches.length > 1) {
-                        const locations = matches
-                            .map((row) => `${row.ref.agent} at "${row.ref.home}" (${row.filePath})`)
-                            .join("; ");
-                        throw new SessionSelectionError(input.id, `Session ID "${input.id}" matches ${matches.length} sessions: ${locations}. ` +
-                            "Select a numbered row or exact file path, or narrow the search with an agent and --home.");
-                    }
-                    return found;
-                }
-                case "file-path": {
-                    const wanted = await canonicalPath(input.path);
-                    for (const row of rows) {
-                        if ((await canonicalPath(row.filePath)) === wanted)
-                            return row;
-                    }
-                    // Selection by path is a convenience, not a way around the repository filter (NG-9).
-                    throw new SessionSelectionError(input.path, `"${input.path}" is not a session of this repository. ${NEXT_STEP}`);
-                }
-            }
-        },
-        async load(descriptor) {
-            const adapter = deps.adapters.find((candidate) => {
-                const capabilities = candidate.capabilities();
-                return capabilities.agent === descriptor.ref.agent && capabilities.roles.includes("source");
-            });
-            if (!adapter) {
-                throw new Error(`no source adapter for agent "${descriptor.ref.agent}"`);
-            }
-            // Returned unchanged: the rules of sections D and E belong to src/import/transfer/.
-            return await adapter.loadSession(descriptor);
-        },
-    };
-}

package/node_modules/@herbertgao/resume-from/dist/import/pipeline.d.ts

@@ -1,17 +0,0 @@
-import type { AgentAdapter, FileCommitter, ImportConfig, ImportPipeline, PreviewBuilder, SessionFinder, SessionLander, TokenEstimator, TransferRules } from "./contract.js";
-/** The four stages, and the services they are driven with. `wiring.ts` builds them. */
-export interface PipelineStages {
-    finder: SessionFinder;
-    rules: TransferRules;
-    /** A preview builder that reads the repository the request names. */
-    previewFor(repoRoot: string): PreviewBuilder;
-    lander: SessionLander;
-    /** Every adapter the composition root constructed. This module only looks one up. */
-    adapters: readonly AgentAdapter[];
-    config: ImportConfig;
-    estimator: TokenEstimator;
-    committer: FileCommitter;
-    /** ISO-8601 UTC. Only the landing reads it, so a preview and a commit agree (FR-47). */
-    now(): string;
-}
-export declare function createPipelineFromStages(stages: PipelineStages): ImportPipeline;

package/node_modules/@herbertgao/resume-from/dist/import/preview/warnings.d.ts

@@ -1,11 +0,0 @@
-import type { PreviewWarning, RepoReader, TransferPlan } from "./contract.js";
-/** Orders warnings by kind, keeping the order they were added within one kind. */
-export declare function sortWarnings(warnings: PreviewWarning[]): PreviewWarning[];
-/**
- * Compares the source commit with the current HEAD (FR-37, FR-38). A repository that
- * cannot be read, or a commit this tree does not have, is said to be unknown — never
- * guessed and never left out (FR-36). None of these block (FR-39).
- */
-export declare function repoWarning(plan: TransferPlan, repo: RepoReader, cwd: string): Promise<PreviewWarning | null>;
-/** The warnings that come from the plan alone. */
-export declare function planWarnings(plan: TransferPlan): PreviewWarning[];

package/node_modules/@herbertgao/resume-from/dist/platform/repo/reader.d.ts

@@ -1,8 +0,0 @@
-import type { RepoReader, RepoReaderOptions } from "./contract.js";
-/**
- * A reader bound to one working directory.
- *
- * `identify` takes the directory to look at; `distanceFrom` compares against the HEAD of `cwd`,
- * which is the repository the command is running in.
- */
-export declare function createRepoReader(cwd?: string, options?: RepoReaderOptions): RepoReader;