@code-yeongyu/senpi-agent-core 2026.9.15 → 2026.9.16-3

package/dist/harness/utils/segmented-read-view.js

@@ -0,0 +1,155 @@
+import { isReadSummaryPath } from "./read-folders/index.js";
+import { READ_FOLD_SETTINGS, } from "./read-folders/types.js";
+/** Compose only untruncated default text reads; each reader owns its existing raw path. */
+export function createDefaultReadSummary(input) {
+    const { path, text, offset, limit, folder, truncated } = input;
+    if (!folder || offset !== undefined || limit !== undefined || truncated || !isReadSummaryPath(path))
+        return undefined;
+    if (text.includes("\0") || text.split("\n").length < READ_FOLD_SETTINGS.minTotalLines)
+        return undefined;
+    const view = createSegmentedReadView({ text, parsed: folder.fold({ path, text, settings: READ_FOLD_SETTINGS }) });
+    switch (view.status) {
+        case "summary":
+            return view.rendered;
+        case "no_summary":
+            return undefined;
+        default:
+            return view;
+    }
+}
+export class InvalidReadSegmentsError extends Error {
+    constructor() {
+        super("Read segments must cover the source exactly, in order, without altering kept lines");
+        this.code = "invalid_segments";
+    }
+}
+function validRange(range, total) {
+    return (Number.isSafeInteger(range.startLine) &&
+        Number.isSafeInteger(range.endLine) &&
+        range.startLine >= 1 &&
+        range.endLine >= range.startLine &&
+        range.endLine <= total);
+}
+/** The sole validator/renderer/footer implementation. Synthetic lines are never source slices. */
+export function renderSegmentedReadView({ text, segments, }) {
+    const lines = text.split("\n");
+    const parts = [];
+    const elidedRanges = [];
+    let cursor = 1;
+    for (const segment of segments) {
+        if (!validRange(segment, lines.length) || segment.startLine !== cursor)
+            throw new InvalidReadSegmentsError();
+        switch (segment.kind) {
+            case "kept":
+                if (segment.text !== lines.slice(segment.startLine - 1, segment.endLine).join("\n"))
+                    throw new InvalidReadSegmentsError();
+                parts.push(segment.text);
+                break;
+            case "elided":
+                parts.push("…");
+                elidedRanges.push({ startLine: segment.startLine, endLine: segment.endLine });
+                break;
+            default:
+                segment;
+                throw new InvalidReadSegmentsError();
+        }
+        cursor = segment.endLine + 1;
+    }
+    if (cursor !== lines.length + 1)
+        throw new InvalidReadSegmentsError();
+    const rereads = elidedRanges.map((range) => ({
+        offset: range.startLine,
+        limit: range.endLine - range.startLine + 1,
+    }));
+    const footerText = rereads.length
+        ? `[Elided source: ${rereads.map((r) => `offset=${r.offset} limit=${r.limit}`).join("; ")}. Reread source before editing; markers are not source.]`
+        : "";
+    if (footerText)
+        parts.push("", footerText);
+    return { text: parts.join("\n"), elidedRanges, footer: { text: footerText, rereads } };
+}
+function validHierarchy(ranges, total) {
+    const queue = [{ ranges, startLine: 0, endLine: total + 1 }];
+    for (let i = 0; i < queue.length; i++) {
+        const parent = queue[i];
+        let previous = parent.startLine;
+        for (const range of parent.ranges) {
+            if (!validRange(range, total) || range.startLine <= previous || range.endLine >= parent.endLine)
+                return false;
+            previous = range.endLine;
+            queue.push({ ranges: range.children, startLine: range.startLine, endLine: range.endLine });
+        }
+    }
+    return true;
+}
+const lengthOf = (range) => range.endLine - range.startLine + 1;
+/** Breadth-first refinement counts only retained source lines, never sentinels/footer lines. */
+export function createSegmentedReadView({ text, parsed, }) {
+    const raw = (reason) => ({ status: "no_summary", reason });
+    switch (parsed.status) {
+        case "unsupported":
+            return raw(parsed.reason);
+        case "parse_failure":
+            return raw("parse_failure");
+        case "parsed":
+            break;
+        default:
+            return parsed;
+    }
+    if (parsed.text !== text)
+        return raw("stale_source");
+    const lines = text.split("\n");
+    if (!validHierarchy(parsed.ranges, lines.length))
+        return raw("invalid_ranges");
+    if (lines.length < READ_FOLD_SETTINGS.minTotalLines)
+        return raw("too_short");
+    if (!parsed.ranges.length)
+        return raw("no_elision");
+    let visible = lines.length - parsed.ranges.reduce((sum, r) => sum + lengthOf(r), 0);
+    if (visible > READ_FOLD_SETTINGS.unfoldLimit)
+        return raw("skeleton_exceeds_budget");
+    const selected = new Set(parsed.ranges);
+    const queue = [...parsed.ranges];
+    for (let i = 0; visible < READ_FOLD_SETTINGS.unfoldUntil && i < queue.length; i++) {
+        const parent = queue[i];
+        const nextVisible = visible + lengthOf(parent) - parent.children.reduce((sum, r) => sum + lengthOf(r), 0);
+        // Later steps only increase visibility, so an oversized step cannot become safe later.
+        if (nextVisible > READ_FOLD_SETTINGS.unfoldLimit)
+            continue;
+        selected.delete(parent);
+        for (const child of parent.children)
+            selected.add(child);
+        queue.push(...parent.children);
+        visible = nextVisible;
+    }
+    if (visible < READ_FOLD_SETTINGS.unfoldUntil)
+        return raw("visible_budget_unreachable");
+    if (!selected.size)
+        return raw("no_elision");
+    const segments = [];
+    let cursor = 1;
+    for (const range of [...selected].sort((a, b) => a.startLine - b.startLine)) {
+        if (cursor < range.startLine)
+            segments.push({
+                kind: "kept",
+                startLine: cursor,
+                endLine: range.startLine - 1,
+                text: lines.slice(cursor - 1, range.startLine - 1).join("\n"),
+            });
+        segments.push({ kind: "elided", startLine: range.startLine, endLine: range.endLine });
+        cursor = range.endLine + 1;
+    }
+    if (cursor <= lines.length)
+        segments.push({
+            kind: "kept",
+            startLine: cursor,
+            endLine: lines.length,
+            text: lines.slice(cursor - 1).join("\n"),
+        });
+    const rendered = renderSegmentedReadView({ text, segments });
+    const encoder = new TextEncoder();
+    if (encoder.encode(rendered.text).length >= encoder.encode(text).length)
+        return raw("no_output_saving");
+    return { status: "summary", segments, visibleSourceLines: visible, rendered };
+}
+//# sourceMappingURL=segmented-read-view.js.map

package/dist/harness/utils/segmented-read-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented-read-view.js","sourceRoot":"","sources":["../../../src/harness/utils/segmented-read-view.ts"],"names":[],"mappings":"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","sourcesContent":["import { isReadSummaryPath } from \"./read-folders/index.ts\";\nimport {\n\tREAD_FOLD_SETTINGS,\n\ttype ReadFolder,\n\ttype ReadFolderResult,\n\ttype ReadFoldRange,\n\ttype ReadLineRange,\n} from \"./read-folders/types.ts\";\n\nexport type ReadSegment =\n\t| (ReadLineRange & { readonly kind: \"kept\"; readonly text: string })\n\t| (ReadLineRange & { readonly kind: \"elided\" });\nexport type RenderedReadView = {\n\treadonly text: string;\n\treadonly elidedRanges: readonly ReadLineRange[];\n\treadonly footer: {\n\t\treadonly text: string;\n\t\treadonly rereads: readonly { readonly offset: number; readonly limit: number }[];\n\t};\n};\nexport type ReadSummaryFallback =\n\t| \"unsupported_language\"\n\t| \"prose_exempt\"\n\t| \"parse_failure\"\n\t| \"stale_source\"\n\t| \"invalid_ranges\"\n\t| \"too_short\"\n\t| \"no_elision\"\n\t| \"skeleton_exceeds_budget\"\n\t| \"visible_budget_unreachable\"\n\t| \"no_output_saving\";\nexport type SegmentedReadView =\n\t| {\n\t\t\treadonly status: \"summary\";\n\t\t\treadonly segments: readonly ReadSegment[];\n\t\t\treadonly visibleSourceLines: number;\n\t\t\treadonly rendered: RenderedReadView;\n\t  }\n\t| { readonly status: \"no_summary\"; readonly reason: ReadSummaryFallback };\n\n/** Compose only untruncated default text reads; each reader owns its existing raw path. */\nexport function createDefaultReadSummary(input: {\n\treadonly path: string;\n\treadonly text: string;\n\treadonly offset?: number;\n\treadonly limit?: number;\n\treadonly folder?: ReadFolder;\n\treadonly truncated: boolean;\n}): RenderedReadView | undefined {\n\tconst { path, text, offset, limit, folder, truncated } = input;\n\tif (!folder || offset !== undefined || limit !== undefined || truncated || !isReadSummaryPath(path))\n\t\treturn undefined;\n\tif (text.includes(\"\\0\") || text.split(\"\\n\").length < READ_FOLD_SETTINGS.minTotalLines) return undefined;\n\tconst view = createSegmentedReadView({ text, parsed: folder.fold({ path, text, settings: READ_FOLD_SETTINGS }) });\n\tswitch (view.status) {\n\t\tcase \"summary\":\n\t\t\treturn view.rendered;\n\t\tcase \"no_summary\":\n\t\t\treturn undefined;\n\t\tdefault:\n\t\t\treturn view satisfies never;\n\t}\n}\n\nexport class InvalidReadSegmentsError extends Error {\n\treadonly code = \"invalid_segments\";\n\tconstructor() {\n\t\tsuper(\"Read segments must cover the source exactly, in order, without altering kept lines\");\n\t}\n}\n\nfunction validRange(range: ReadLineRange, total: number): boolean {\n\treturn (\n\t\tNumber.isSafeInteger(range.startLine) &&\n\t\tNumber.isSafeInteger(range.endLine) &&\n\t\trange.startLine >= 1 &&\n\t\trange.endLine >= range.startLine &&\n\t\trange.endLine <= total\n\t);\n}\n\n/** The sole validator/renderer/footer implementation. Synthetic lines are never source slices. */\nexport function renderSegmentedReadView({\n\ttext,\n\tsegments,\n}: {\n\treadonly text: string;\n\treadonly segments: readonly ReadSegment[];\n}): RenderedReadView {\n\tconst lines = text.split(\"\\n\");\n\tconst parts: string[] = [];\n\tconst elidedRanges: ReadLineRange[] = [];\n\tlet cursor = 1;\n\tfor (const segment of segments) {\n\t\tif (!validRange(segment, lines.length) || segment.startLine !== cursor) throw new InvalidReadSegmentsError();\n\t\tswitch (segment.kind) {\n\t\t\tcase \"kept\":\n\t\t\t\tif (segment.text !== lines.slice(segment.startLine - 1, segment.endLine).join(\"\\n\"))\n\t\t\t\t\tthrow new InvalidReadSegmentsError();\n\t\t\t\tparts.push(segment.text);\n\t\t\t\tbreak;\n\t\t\tcase \"elided\":\n\t\t\t\tparts.push(\"…\");\n\t\t\t\telidedRanges.push({ startLine: segment.startLine, endLine: segment.endLine });\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tsegment satisfies never;\n\t\t\t\tthrow new InvalidReadSegmentsError();\n\t\t}\n\t\tcursor = segment.endLine + 1;\n\t}\n\tif (cursor !== lines.length + 1) throw new InvalidReadSegmentsError();\n\tconst rereads = elidedRanges.map((range) => ({\n\t\toffset: range.startLine,\n\t\tlimit: range.endLine - range.startLine + 1,\n\t}));\n\tconst footerText = rereads.length\n\t\t? `[Elided source: ${rereads.map((r) => `offset=${r.offset} limit=${r.limit}`).join(\"; \")}. Reread source before editing; markers are not source.]`\n\t\t: \"\";\n\tif (footerText) parts.push(\"\", footerText);\n\treturn { text: parts.join(\"\\n\"), elidedRanges, footer: { text: footerText, rereads } };\n}\n\nfunction validHierarchy(ranges: readonly ReadFoldRange[], total: number): boolean {\n\tconst queue = [{ ranges, startLine: 0, endLine: total + 1 }];\n\tfor (let i = 0; i < queue.length; i++) {\n\t\tconst parent = queue[i];\n\t\tlet previous = parent.startLine;\n\t\tfor (const range of parent.ranges) {\n\t\t\tif (!validRange(range, total) || range.startLine <= previous || range.endLine >= parent.endLine) return false;\n\t\t\tprevious = range.endLine;\n\t\t\tqueue.push({ ranges: range.children, startLine: range.startLine, endLine: range.endLine });\n\t\t}\n\t}\n\treturn true;\n}\n\nconst lengthOf = (range: ReadLineRange) => range.endLine - range.startLine + 1;\n\n/** Breadth-first refinement counts only retained source lines, never sentinels/footer lines. */\nexport function createSegmentedReadView({\n\ttext,\n\tparsed,\n}: {\n\treadonly text: string;\n\treadonly parsed: ReadFolderResult;\n}): SegmentedReadView {\n\tconst raw = (reason: ReadSummaryFallback): SegmentedReadView => ({ status: \"no_summary\", reason });\n\tswitch (parsed.status) {\n\t\tcase \"unsupported\":\n\t\t\treturn raw(parsed.reason);\n\t\tcase \"parse_failure\":\n\t\t\treturn raw(\"parse_failure\");\n\t\tcase \"parsed\":\n\t\t\tbreak;\n\t\tdefault:\n\t\t\treturn parsed satisfies never;\n\t}\n\tif (parsed.text !== text) return raw(\"stale_source\");\n\tconst lines = text.split(\"\\n\");\n\tif (!validHierarchy(parsed.ranges, lines.length)) return raw(\"invalid_ranges\");\n\tif (lines.length < READ_FOLD_SETTINGS.minTotalLines) return raw(\"too_short\");\n\tif (!parsed.ranges.length) return raw(\"no_elision\");\n\tlet visible = lines.length - parsed.ranges.reduce((sum, r) => sum + lengthOf(r), 0);\n\tif (visible > READ_FOLD_SETTINGS.unfoldLimit) return raw(\"skeleton_exceeds_budget\");\n\tconst selected = new Set(parsed.ranges);\n\tconst queue = [...parsed.ranges];\n\tfor (let i = 0; visible < READ_FOLD_SETTINGS.unfoldUntil && i < queue.length; i++) {\n\t\tconst parent = queue[i];\n\t\tconst nextVisible = visible + lengthOf(parent) - parent.children.reduce((sum, r) => sum + lengthOf(r), 0);\n\t\t// Later steps only increase visibility, so an oversized step cannot become safe later.\n\t\tif (nextVisible > READ_FOLD_SETTINGS.unfoldLimit) continue;\n\t\tselected.delete(parent);\n\t\tfor (const child of parent.children) selected.add(child);\n\t\tqueue.push(...parent.children);\n\t\tvisible = nextVisible;\n\t}\n\tif (visible < READ_FOLD_SETTINGS.unfoldUntil) return raw(\"visible_budget_unreachable\");\n\tif (!selected.size) return raw(\"no_elision\");\n\tconst segments: ReadSegment[] = [];\n\tlet cursor = 1;\n\tfor (const range of [...selected].sort((a, b) => a.startLine - b.startLine)) {\n\t\tif (cursor < range.startLine)\n\t\t\tsegments.push({\n\t\t\t\tkind: \"kept\",\n\t\t\t\tstartLine: cursor,\n\t\t\t\tendLine: range.startLine - 1,\n\t\t\t\ttext: lines.slice(cursor - 1, range.startLine - 1).join(\"\\n\"),\n\t\t\t});\n\t\tsegments.push({ kind: \"elided\", startLine: range.startLine, endLine: range.endLine });\n\t\tcursor = range.endLine + 1;\n\t}\n\tif (cursor <= lines.length)\n\t\tsegments.push({\n\t\t\tkind: \"kept\",\n\t\t\tstartLine: cursor,\n\t\t\tendLine: lines.length,\n\t\t\ttext: lines.slice(cursor - 1).join(\"\\n\"),\n\t\t});\n\tconst rendered = renderSegmentedReadView({ text, segments });\n\tconst encoder = new TextEncoder();\n\tif (encoder.encode(rendered.text).length >= encoder.encode(text).length) return raw(\"no_output_saving\");\n\treturn { status: \"summary\", segments, visibleSourceLines: visible, rendered };\n}\n"]}

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export { AGENT_TELEMETRY_SCHEMAS, AI_TELEMETRY_SCHEMA, HARNESS_TELEMETRY_SCHEMA,
 export * from "./harness/tools/index.ts";
 export { type AgentHarnessResources, type AgentHarnessStreamOptions, type AgentHarnessStreamOptionsPatch, type AgentHarnessTool, type AgentHarnessToolContextSource, type AgentHarnessToolInvocation, type AgentHarnessToolUpdateCallback, type AgentHarnessToolUpdateOptions, BranchSummaryError, type BranchSummaryErrorCode, CompactionError, type CompactionErrorCode, type ExecutionEnv, ExecutionError, type ExecutionErrorCode, err, FileError, type FileErrorCode, type FileInfo, type FileKind, type FileSystem, getOrThrow, getOrUndefined, ok, type PromptTemplate, type Shell, type ShellExecOptions, type ShellExecResult, type ShellOutputCaptureOptions, type ShellOutputLimits, type ShellOutputMetadata, type ShellOutputRetention, type ShellOutputTruncation, type ShellOutputUpdate, type ShellOutputView, type Skill, toError, } from "./harness/types.ts";
 export { applyShellOutputUpdate } from "./harness/utils/output-capture.ts";
+export * from "./harness/utils/read-folders/index.ts";
+export * from "./harness/utils/segmented-read-view.ts";
 export * from "./harness/utils/shell-output.ts";
 export * from "./harness/utils/truncate.ts";
 export * from "./proxy.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,YAAY,EACX,cAAc,EACd,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,kCAAkC,EAClC,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,cAAc,IAAI,uBAAuB,EACzC,WAAW,EACX,UAAU,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,sBAAsB,EACtB,gBAAgB,EAChB,iCAAiC,EACjC,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,gCAAgC,EAChC,kCAAkC,EAClC,4BAA4B,EAC5B,uBAAuB,EACvB,kCAAkC,EAClC,wBAAwB,EACxB,aAAa,EACb,uBAAuB,EACvB,iCAAiC,EACjC,gBAAgB,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kCAAkC,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACpH,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,8BAA8B,EAC9B,KAAK,cAAc,EACnB,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,KAAK,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,YAAY,EACX,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,GAChB,MAAM,wBAAwB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,kBAAkB,EACvB,GAAG,EACH,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,UAAU,EACV,cAAc,EACd,EAAE,EACF,KAAK,cAAc,EACnB,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,OAAO,GACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -18,6 +18,8 @@ export { AGENT_TELEMETRY_SCHEMAS, AI_TELEMETRY_SCHEMA, HARNESS_TELEMETRY_SCHEMA,
 export * from "./harness/tools/index.js";
 export { BranchSummaryError, CompactionError, ExecutionError, err, FileError, getOrThrow, getOrUndefined, ok, toError, } from "./harness/types.js";
 export { applyShellOutputUpdate } from "./harness/utils/output-capture.js";
+export * from "./harness/utils/read-folders/index.js";
+export * from "./harness/utils/segmented-read-view.js";
 export * from "./harness/utils/shell-output.js";
 export * from "./harness/utils/truncate.js";
 export * from "./proxy.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAkC/C,OAAO,EACN,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kCAAkC,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACpH,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAKN,8BAA8B,EAG9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAIN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAA8B,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAmB3C,OAAO,EACN,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,GAChB,MAAM,wBAAwB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EASN,kBAAkB,EAElB,eAAe,EAGf,cAAc,EAEd,GAAG,EACH,SAAS,EAKT,UAAU,EACV,cAAc,EACd,EAAE,EAaF,OAAO,GACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,YAAY,CAAC","sourcesContent":["export { uuidv7 } from \"@earendil-works/pi-ai\";\nexport type {\n\tAttributeValue,\n\tExactTelemetryAttributes,\n\tInferEventAttributes,\n\tInferOptionalAttributes,\n\tInferRequiredAndOptionalAttributes,\n\tInferStartAttributes,\n\tRecordedTelemetryEvent,\n\tRecordedTelemetrySpan,\n\tSchemaTelemetrySpan,\n\tSpanAttributes,\n\tSpanAttributes as TelemetrySpanAttributes,\n\tSpanOptions,\n\tSpanStatus,\n\tTelemetryAttributeDefinition,\n\tTelemetryAttributeMetadata,\n\tTelemetryAttributeType,\n\tTelemetryContext,\n\tTelemetryEventAttributeDefinition,\n\tTelemetryEventDefinition,\n\tTelemetryParentDefinition,\n\tTelemetrySchemaDefinition,\n\tTelemetrySchemaSpanEndAttributes,\n\tTelemetrySchemaSpanEventAttributes,\n\tTelemetrySchemaSpanEventName,\n\tTelemetrySchemaSpanName,\n\tTelemetrySchemaSpanStartAttributes,\n\tTelemetrySchemaSpanUnion,\n\tTelemetrySpan,\n\tTelemetrySpanDefinition,\n\tTelemetryStartAttributeDefinition,\n\tTypedSpanStarter,\n} from \"@earendil-works/pi-telemetry\";\nexport {\n\tcreateTypedSpanStarter,\n\tdefineTelemetrySchema,\n\tInMemoryTelemetryContext,\n\tNOOP_TELEMETRY_CONTEXT,\n} from \"@earendil-works/pi-telemetry\";\nexport * from \"./agent.ts\";\nexport * from \"./agent-loop.ts\";\nexport { EMPTY_TOOL_USE_DEMOTION_DIAGNOSTIC, ProviderRetryWatchdogAbortError } from \"./assistant-terminal-state.ts\";\nexport * from \"./harness/agent-harness.ts\";\nexport {\n\ttype BranchPreparation,\n\ttype BranchSummaryDetails,\n\ttype BranchSummaryResult,\n\ttype CollectEntriesResult,\n\tcollectEntriesForBranchSummary,\n\ttype FileOperations,\n\ttype GenerateBranchSummaryOptions,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.ts\";\nexport {\n\ttype CompactionPreparation,\n\ttype CompactionSettings,\n\ttype CompactResult,\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgenerateSummaryWithUsage,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.ts\";\nexport * from \"./harness/context.ts\";\nexport * from \"./harness/messages.ts\";\nexport * from \"./harness/prompt-templates.ts\";\nexport * from \"./harness/result.ts\";\nexport { type LaneSnapshotReduction, reduceLaneSnapshot } from \"./harness/runtime/reducer.ts\";\nexport * from \"./harness/session/index.ts\";\nexport * from \"./harness/skills.ts\";\nexport * from \"./harness/system-prompt.ts\";\nexport type {\n\tAiSpan,\n\tAiSpanAttributes,\n\tAiSpanEndAttributes,\n\tAiSpanEventAttributes,\n\tAiSpanEventName,\n\tAiSpanName,\n\tAiSpanStartAttributes,\n\tAiTelemetrySpan,\n\tHarnessSpan,\n\tHarnessSpanAttributes,\n\tHarnessSpanEndAttributes,\n\tHarnessSpanEventAttributes,\n\tHarnessSpanEventName,\n\tHarnessSpanName,\n\tHarnessSpanStartAttributes,\n\tHarnessTelemetrySpan,\n} from \"./harness/telemetry.ts\";\nexport {\n\tAGENT_TELEMETRY_SCHEMAS,\n\tAI_TELEMETRY_SCHEMA,\n\tHARNESS_TELEMETRY_SCHEMA,\n\tstartAiSpan,\n\tstartHarnessSpan,\n} from \"./harness/telemetry.ts\";\nexport * from \"./harness/tools/index.ts\";\nexport {\n\ttype AgentHarnessResources,\n\ttype AgentHarnessStreamOptions,\n\ttype AgentHarnessStreamOptionsPatch,\n\ttype AgentHarnessTool,\n\ttype AgentHarnessToolContextSource,\n\ttype AgentHarnessToolInvocation,\n\ttype AgentHarnessToolUpdateCallback,\n\ttype AgentHarnessToolUpdateOptions,\n\tBranchSummaryError,\n\ttype BranchSummaryErrorCode,\n\tCompactionError,\n\ttype CompactionErrorCode,\n\ttype ExecutionEnv,\n\tExecutionError,\n\ttype ExecutionErrorCode,\n\terr,\n\tFileError,\n\ttype FileErrorCode,\n\ttype FileInfo,\n\ttype FileKind,\n\ttype FileSystem,\n\tgetOrThrow,\n\tgetOrUndefined,\n\tok,\n\ttype PromptTemplate,\n\ttype Shell,\n\ttype ShellExecOptions,\n\ttype ShellExecResult,\n\ttype ShellOutputCaptureOptions,\n\ttype ShellOutputLimits,\n\ttype ShellOutputMetadata,\n\ttype ShellOutputRetention,\n\ttype ShellOutputTruncation,\n\ttype ShellOutputUpdate,\n\ttype ShellOutputView,\n\ttype Skill,\n\ttoError,\n} from \"./harness/types.ts\";\nexport { applyShellOutputUpdate } from \"./harness/utils/output-capture.ts\";\nexport * from \"./harness/utils/shell-output.ts\";\nexport * from \"./harness/utils/truncate.ts\";\nexport * from \"./proxy.ts\";\nexport * from \"./search/index.ts\";\nexport { setDefaultStreamFn } from \"./stream-fn.ts\";\nexport * from \"./types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAkC/C,OAAO,EACN,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,GACtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,kCAAkC,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACpH,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAKN,8BAA8B,EAG9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAIN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAA8B,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9F,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAmB3C,OAAO,EACN,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,GAChB,MAAM,wBAAwB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EASN,kBAAkB,EAElB,eAAe,EAGf,cAAc,EAEd,GAAG,EACH,SAAS,EAKT,UAAU,EACV,cAAc,EACd,EAAE,EAaF,OAAO,GACP,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,cAAc,uCAAuC,CAAC;AACtD,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,YAAY,CAAC","sourcesContent":["export { uuidv7 } from \"@earendil-works/pi-ai\";\nexport type {\n\tAttributeValue,\n\tExactTelemetryAttributes,\n\tInferEventAttributes,\n\tInferOptionalAttributes,\n\tInferRequiredAndOptionalAttributes,\n\tInferStartAttributes,\n\tRecordedTelemetryEvent,\n\tRecordedTelemetrySpan,\n\tSchemaTelemetrySpan,\n\tSpanAttributes,\n\tSpanAttributes as TelemetrySpanAttributes,\n\tSpanOptions,\n\tSpanStatus,\n\tTelemetryAttributeDefinition,\n\tTelemetryAttributeMetadata,\n\tTelemetryAttributeType,\n\tTelemetryContext,\n\tTelemetryEventAttributeDefinition,\n\tTelemetryEventDefinition,\n\tTelemetryParentDefinition,\n\tTelemetrySchemaDefinition,\n\tTelemetrySchemaSpanEndAttributes,\n\tTelemetrySchemaSpanEventAttributes,\n\tTelemetrySchemaSpanEventName,\n\tTelemetrySchemaSpanName,\n\tTelemetrySchemaSpanStartAttributes,\n\tTelemetrySchemaSpanUnion,\n\tTelemetrySpan,\n\tTelemetrySpanDefinition,\n\tTelemetryStartAttributeDefinition,\n\tTypedSpanStarter,\n} from \"@earendil-works/pi-telemetry\";\nexport {\n\tcreateTypedSpanStarter,\n\tdefineTelemetrySchema,\n\tInMemoryTelemetryContext,\n\tNOOP_TELEMETRY_CONTEXT,\n} from \"@earendil-works/pi-telemetry\";\nexport * from \"./agent.ts\";\nexport * from \"./agent-loop.ts\";\nexport { EMPTY_TOOL_USE_DEMOTION_DIAGNOSTIC, ProviderRetryWatchdogAbortError } from \"./assistant-terminal-state.ts\";\nexport * from \"./harness/agent-harness.ts\";\nexport {\n\ttype BranchPreparation,\n\ttype BranchSummaryDetails,\n\ttype BranchSummaryResult,\n\ttype CollectEntriesResult,\n\tcollectEntriesForBranchSummary,\n\ttype FileOperations,\n\ttype GenerateBranchSummaryOptions,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.ts\";\nexport {\n\ttype CompactionPreparation,\n\ttype CompactionSettings,\n\ttype CompactResult,\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgenerateSummaryWithUsage,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.ts\";\nexport * from \"./harness/context.ts\";\nexport * from \"./harness/messages.ts\";\nexport * from \"./harness/prompt-templates.ts\";\nexport * from \"./harness/result.ts\";\nexport { type LaneSnapshotReduction, reduceLaneSnapshot } from \"./harness/runtime/reducer.ts\";\nexport * from \"./harness/session/index.ts\";\nexport * from \"./harness/skills.ts\";\nexport * from \"./harness/system-prompt.ts\";\nexport type {\n\tAiSpan,\n\tAiSpanAttributes,\n\tAiSpanEndAttributes,\n\tAiSpanEventAttributes,\n\tAiSpanEventName,\n\tAiSpanName,\n\tAiSpanStartAttributes,\n\tAiTelemetrySpan,\n\tHarnessSpan,\n\tHarnessSpanAttributes,\n\tHarnessSpanEndAttributes,\n\tHarnessSpanEventAttributes,\n\tHarnessSpanEventName,\n\tHarnessSpanName,\n\tHarnessSpanStartAttributes,\n\tHarnessTelemetrySpan,\n} from \"./harness/telemetry.ts\";\nexport {\n\tAGENT_TELEMETRY_SCHEMAS,\n\tAI_TELEMETRY_SCHEMA,\n\tHARNESS_TELEMETRY_SCHEMA,\n\tstartAiSpan,\n\tstartHarnessSpan,\n} from \"./harness/telemetry.ts\";\nexport * from \"./harness/tools/index.ts\";\nexport {\n\ttype AgentHarnessResources,\n\ttype AgentHarnessStreamOptions,\n\ttype AgentHarnessStreamOptionsPatch,\n\ttype AgentHarnessTool,\n\ttype AgentHarnessToolContextSource,\n\ttype AgentHarnessToolInvocation,\n\ttype AgentHarnessToolUpdateCallback,\n\ttype AgentHarnessToolUpdateOptions,\n\tBranchSummaryError,\n\ttype BranchSummaryErrorCode,\n\tCompactionError,\n\ttype CompactionErrorCode,\n\ttype ExecutionEnv,\n\tExecutionError,\n\ttype ExecutionErrorCode,\n\terr,\n\tFileError,\n\ttype FileErrorCode,\n\ttype FileInfo,\n\ttype FileKind,\n\ttype FileSystem,\n\tgetOrThrow,\n\tgetOrUndefined,\n\tok,\n\ttype PromptTemplate,\n\ttype Shell,\n\ttype ShellExecOptions,\n\ttype ShellExecResult,\n\ttype ShellOutputCaptureOptions,\n\ttype ShellOutputLimits,\n\ttype ShellOutputMetadata,\n\ttype ShellOutputRetention,\n\ttype ShellOutputTruncation,\n\ttype ShellOutputUpdate,\n\ttype ShellOutputView,\n\ttype Skill,\n\ttoError,\n} from \"./harness/types.ts\";\nexport { applyShellOutputUpdate } from \"./harness/utils/output-capture.ts\";\nexport * from \"./harness/utils/read-folders/index.ts\";\nexport * from \"./harness/utils/segmented-read-view.ts\";\nexport * from \"./harness/utils/shell-output.ts\";\nexport * from \"./harness/utils/truncate.ts\";\nexport * from \"./proxy.ts\";\nexport * from \"./search/index.ts\";\nexport { setDefaultStreamFn } from \"./stream-fn.ts\";\nexport * from \"./types.ts\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-agent-core",
-	"version": "2026.9.15",
+	"version": "2026.9.16-3",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -56,8 +56,8 @@
 	},
 	"dependencies": {
 		"@earendil-works/chord": "0.85.1",
-		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.9.15",
-		"@earendil-works/pi-telemetry": "npm:@code-yeongyu/senpi-telemetry@2026.9.15",
+		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.9.16-3",
+		"@earendil-works/pi-telemetry": "npm:@code-yeongyu/senpi-telemetry@2026.9.16-3",
 		"diff": "9.0.0",
 		"ignore": "7.0.8",
 		"typebox": "1.3.27",