clinkx 0.2.2 → 0.3.0

package/dist/context-builder/delegate-validation.js

@@ -0,0 +1,367 @@
+import { z } from "zod";
+import { InvalidParamsError } from "../errors.js";
+import { contextBuilderCandidateId } from "./delegate-packet.js";
+import { normalizeContextBuilderPublicBudget, } from "./schema.js";
+import { hasEmbeddedAbsolutePath } from "./diagnostics.js";
+import { scanHighConfidenceSecretContent, scanSecretPath, } from "./secrets.js";
+const MAX_TEXT_CHARS = 1_000;
+const MAX_SELECTED = 100;
+const MAX_RANGES_PER_SELECTION = 100;
+const MAX_DIAGNOSTICS = 100;
+const SafeTextSchema = z.string().trim().min(1).max(MAX_TEXT_CHARS);
+const CandidateIdSchema = z.string().trim().min(1).max(600);
+const RangeSchema = z
+    .object({
+    start_line: z.number().int().positive(),
+    end_line: z.number().int().positive(),
+    reason: SafeTextSchema,
+})
+    .strict();
+const SelectionSchema = z
+    .object({
+    candidate_id: CandidateIdSchema,
+    ranges: z.array(RangeSchema).min(1).max(MAX_RANGES_PER_SELECTION),
+    reason: SafeTextSchema,
+})
+    .strict();
+const CuratorOutputSchema = z
+    .object({
+    selected: z.array(SelectionSchema).min(1).max(MAX_SELECTED),
+    warnings: z.array(SafeTextSchema).max(MAX_DIAGNOSTICS),
+    open_questions: z.array(SafeTextSchema).max(MAX_DIAGNOSTICS),
+})
+    .strict();
+const FinalizerOutputSchema = z
+    .object({
+    score: z.number().min(0).max(10),
+    approved: z.boolean(),
+    selected: z.array(SelectionSchema).min(1).max(MAX_SELECTED),
+    warnings: z.array(SafeTextSchema).max(MAX_DIAGNOSTICS),
+    omissions: z.array(SafeTextSchema).max(MAX_DIAGNOSTICS),
+})
+    .strict();
+const FORBIDDEN_PROVIDER_KEYS = new Set([
+    "absolute_path",
+    "content",
+    "contents",
+    "excerpt",
+    "preview",
+    "root_index",
+    "source",
+    "text",
+]);
+export function validateContextBuilderCuratorOutput(output, options) {
+    rejectProviderSuppliedSource(output);
+    rejectEmptySelectedArray(output, "curator");
+    const parsed = parseWithSchema(CuratorOutputSchema, output, "curator");
+    const candidates = buildCandidateIndex(options.candidates);
+    validateSelections(parsed.selected, candidates);
+    validateTextFields([
+        ...parsed.selected.flatMap((selection) => [
+            selection.reason,
+            ...selection.ranges.map((range) => range.reason),
+        ]),
+        ...parsed.warnings,
+        ...parsed.open_questions,
+    ]);
+    validateBudget(parsed.selected, options.budget);
+    return parsed;
+}
+export function validateContextBuilderFinalizerOutput(output, options) {
+    rejectProviderSuppliedSource(output);
+    rejectEmptySelectedArray(output, "finalizer");
+    const parsed = parseWithSchema(FinalizerOutputSchema, output, "finalizer");
+    if (parsed.score < options.minScore) {
+        throw invalid(`context_builder finalizer score ${parsed.score} is below minimum ${options.minScore}`);
+    }
+    if (parsed.approved !== true) {
+        throw invalid("context_builder finalizer output must be approved");
+    }
+    if (parsed.omissions.length > 0) {
+        throw invalid("context_builder finalizer output cannot approve while reporting omissions");
+    }
+    validateTextFields([
+        ...parsed.selected.flatMap((selection) => [
+            selection.reason,
+            ...selection.ranges.map((range) => range.reason),
+        ]),
+        ...parsed.warnings,
+        ...parsed.omissions,
+    ]);
+    const materialWarning = parsed.warnings.find(isMaterialEvidenceGapWarning);
+    if (materialWarning != null) {
+        throw invalid("context_builder finalizer output cannot hide required evidence gaps in warnings");
+    }
+    const candidates = buildCandidateIndex(options.candidates);
+    validateSelections(parsed.selected, candidates);
+    validateBudget(parsed.selected, options.budget);
+    return {
+        ...parsed,
+        approved: true,
+    };
+}
+function rejectEmptySelectedArray(output, stage) {
+    if (output == null || typeof output !== "object" || Array.isArray(output)) {
+        return;
+    }
+    const selected = output["selected"];
+    if (Array.isArray(selected) && selected.length === 0) {
+        throw invalid(`Invalid context_builder ${stage} output: selected must contain at least one local candidate when candidates are available`);
+    }
+}
+function parseWithSchema(schema, output, stage) {
+    const result = schema.safeParse(output);
+    if (!result.success) {
+        throw invalid(`Invalid context_builder ${stage} output: ${result.error.issues
+            .map(formatZodIssue)
+            .join("; ")}`);
+    }
+    return result.data;
+}
+function formatZodIssue(issue) {
+    const path = formatZodIssuePath(issue.path);
+    if (issue.code === "unrecognized_keys") {
+        return `${path}: unrecognized keys are not allowed`;
+    }
+    if (issue.code === "invalid_type") {
+        return `${path}: invalid_type expected=${issue.expected} received=${issue.received}`;
+    }
+    if (issue.code === "too_small" || issue.code === "too_big") {
+        return `${path}: ${issue.code} type=${issue.type}`;
+    }
+    return `${path}: ${issue.code}`;
+}
+function formatZodIssuePath(path) {
+    if (path.length === 0) {
+        return "root";
+    }
+    return path
+        .map((segment) => `[${typeof segment === "number" ? "#" : segment}]`)
+        .join("");
+}
+function buildCandidateIndex(candidates) {
+    const byId = new Map();
+    for (const candidate of candidates) {
+        if (candidate.id.includes("\u0000") || byId.has(candidate.id)) {
+            throw invalid("context_builder delegate candidate universe is invalid");
+        }
+        if (!isSafeCandidatePath(candidate.path)) {
+            throw invalid("context_builder delegate candidate path is unsafe");
+        }
+        assertCandidateIdentity(candidate);
+        byId.set(candidate.id, candidate);
+    }
+    return { byId };
+}
+function validateSelections(selections, candidates) {
+    const seenCandidates = new Set();
+    for (const selection of selections) {
+        assertSafeCandidateId(selection.candidate_id);
+        if (seenCandidates.has(selection.candidate_id)) {
+            throw invalid("context_builder delegate output has duplicate candidate_id");
+        }
+        seenCandidates.add(selection.candidate_id);
+        const candidate = candidates.byId.get(selection.candidate_id);
+        if (candidate == null) {
+            throw invalid("context_builder delegate output references unknown candidate_id");
+        }
+        if (selection.ranges.length === 0) {
+            throw invalid("context_builder delegate output has empty ranges");
+        }
+        const seenRanges = new Set();
+        for (const range of selection.ranges) {
+            const key = `${range.start_line}:${range.end_line}`;
+            if (seenRanges.has(key)) {
+                throw invalid("context_builder delegate output has duplicate range");
+            }
+            seenRanges.add(key);
+            validateRange(candidate, range);
+        }
+    }
+}
+function validateRange(candidate, range) {
+    if (candidate.line_count <= 0) {
+        throw invalid("context_builder delegate output selected a range from zero-line candidate");
+    }
+    if (range.start_line > range.end_line) {
+        throw invalid("context_builder delegate output has reversed range");
+    }
+    if (range.end_line > candidate.line_count) {
+        throw invalid("context_builder delegate output range exceeds local line count");
+    }
+    if (!isCoveredByCandidateRanges(candidate, range)) {
+        throw invalid("context_builder delegate output range is outside eligible packet ranges");
+    }
+}
+function validateBudget(selections, budget) {
+    const effectiveBudget = budget ?? normalizeContextBuilderPublicBudget();
+    if (selections.length > effectiveBudget.max_files) {
+        throw invalid("context_builder delegate output exceeds max_files budget");
+    }
+}
+function validateTextFields(fields) {
+    for (const field of fields) {
+        if (isUnsafeDelegateText(field)) {
+            throw invalid("context_builder delegate output contains unsafe text");
+        }
+    }
+}
+function isUnsafeDelegateText(text) {
+    if (text.includes("\u0000") ||
+        scanHighConfidenceSecretContent(text).length > 0 ||
+        hasEmbeddedAbsolutePath(text)) {
+        return true;
+    }
+    const decodedText = decodePathToken(text);
+    if (decodedText !== text && hasEmbeddedAbsolutePath(decodedText)) {
+        return true;
+    }
+    const tokens = decodedText.split(/\s+/).filter(Boolean);
+    return tokens.some((token) => isUnsafePathLikeToken(trimPunctuation(token)));
+}
+function isMaterialEvidenceGapWarning(message) {
+    const text = message.toLowerCase();
+    if (isNonBlockingDelegateWarning(text)) {
+        return false;
+    }
+    return (/\b(required|requested|focus(?:ed)?)\b.{0,80}\b(missing|missed|incomplete|unavailable|insufficient|omitted|not selected|not selectable|unselectable|not present)\b/.test(text) ||
+        /\b(missing|missed|incomplete|unavailable|insufficient|omitted|not selected|not selectable|unselectable|not present)\b.{0,80}\b(required|requested|focus(?:ed)?)\b/.test(text) ||
+        /\bselected\b.{0,80}\b(not selectable|unselectable|not present)\b/.test(text) ||
+        /\boutside (?:the )?selected ranges?\b/.test(text));
+}
+function isNonBlockingDelegateWarning(text) {
+    return (/\bpacket evidence omitted full source excerpts\b/.test(text) ||
+        /\bfull source excerpts? (?:were )?omitted\b/.test(text) ||
+        /\bfull-file focus ranges?\b.{0,120}\b(?:excerpts?|full source)\b.{0,80}\b(?:omitted|truncated)\b/.test(text) ||
+        /\bfull source excerpts?\b.{0,80}\bunavailable\b.{0,120}\bwhole-file focus ranges?\b/.test(text) ||
+        /\bblank excerpts?\b.{0,80}\bpacket\b.{0,160}\bselected ranges?\b.{0,80}\bprioritize\b.{0,120}\b(?:deterministic focus ranges?|task-critical)\b/.test(text) ||
+        /\blarge integration files?\b.{0,120}\brepresented only by available packet slices\b.{0,160}\bavoid claiming coverage outside selected ranges\b/.test(text) ||
+        isSecretSafetyOmissionWarning(text) ||
+        /\bomitted from deterministic_selection\b.{0,120}\bbut selected\b/.test(text) ||
+        isFocusPreservingSkipWarning(text) ||
+        isDeterministicExpansionWarning(text));
+}
+function isSecretSafetyOmissionWarning(text) {
+    return (/\b(?:high-confidence secret|secret detection|secret safety|secret[- ]safe|redacted|redacted-safe|redaction)\b/.test(text) &&
+        /\b(?:omitted|excluded|not selected|not requested|should not be requested|unavailable)\b/.test(text));
+}
+function isFocusPreservingSkipWarning(text) {
+    return (/\b(?:unrelated|irrelevant|out-of-scope|low[- ]signal)\b.{0,120}\b(?:not selected|omitted|skipped)\b.{0,80}\bpreserve focus\b/.test(text) ||
+        /\b(?:not selected|omitted|skipped)\b.{0,120}\b(?:unrelated|irrelevant|out-of-scope|low[- ]signal)\b.{0,80}\bpreserve focus\b/.test(text));
+}
+function isDeterministicExpansionWarning(text) {
+    return (/\bselection\b.{0,80}\b(?:intentionally\s+)?(?:exceeds|exceeded|expands beyond|expanded beyond|extends beyond|extended beyond)\b.{0,120}\bdeterministic\b.{0,160}\binsufficient\b/.test(text) &&
+        !/\b(missing|missed|omitted|not selected|not selectable|unselectable|not present|unavailable)\b/.test(text));
+}
+function trimPunctuation(token) {
+    return token.replace(/^[("'`[{]+/, "").replace(/[)"'`,.;:\]}]+$/, "");
+}
+function isUnsafePathLikeToken(token) {
+    const decoded = decodePathToken(token);
+    const values = decoded === token ? [token] : [token, decoded];
+    return values.some((value) => {
+        if (value.includes("\u0000")) {
+            return true;
+        }
+        if (value.startsWith("/") ||
+            value.startsWith("\\") ||
+            value.startsWith("~/") ||
+            /^[A-Za-z]:/.test(value) ||
+            /^file:\/\//i.test(value) ||
+            /^\\\\/.test(value)) {
+            return true;
+        }
+        if (value.includes("/") && value.includes("\\")) {
+            return true;
+        }
+        const slashNormalized = value.replaceAll("\\", "/");
+        return (slashNormalized === ".." ||
+            slashNormalized.startsWith("../") ||
+            slashNormalized.includes("/../") ||
+            slashNormalized.endsWith("/.."));
+    });
+}
+function decodePathToken(token) {
+    try {
+        return decodeURIComponent(token);
+    }
+    catch {
+        return token;
+    }
+}
+function assertSafeCandidateId(candidateId) {
+    const parsed = parseCandidateId(candidateId);
+    if (parsed == null ||
+        !isSafeCandidatePath(parsed.path) ||
+        contextBuilderCandidateId(parsed.rootIndex, parsed.path) !== candidateId) {
+        throw invalid("context_builder delegate output has unsafe candidate_id");
+    }
+}
+function parseCandidateId(candidateId) {
+    const match = /^c:([0-9]+):(.+)$/.exec(candidateId);
+    if (match == null) {
+        return null;
+    }
+    const rawRootIndex = match[1];
+    const path = match[2];
+    if (rawRootIndex == null || path == null) {
+        return null;
+    }
+    const rootIndex = Number(rawRootIndex);
+    if (!Number.isSafeInteger(rootIndex)) {
+        return null;
+    }
+    return { rootIndex, path };
+}
+function assertCandidateIdentity(candidate) {
+    const expectedId = contextBuilderCandidateId(candidate.root_index, candidate.path);
+    if (candidate.id !== expectedId) {
+        throw invalid(`context_builder delegate candidate id mismatch: expected ${expectedId} for ${candidate.path}`);
+    }
+}
+function isCoveredByCandidateRanges(candidate, range) {
+    let nextLine = range.start_line;
+    for (const candidateRange of [...candidate.ranges].sort((left, right) => left.start_line - right.start_line || left.end_line - right.end_line)) {
+        if (candidateRange.end_line < nextLine) {
+            continue;
+        }
+        if (candidateRange.start_line > nextLine) {
+            return false;
+        }
+        nextLine = Math.max(nextLine, candidateRange.end_line + 1);
+        if (nextLine > range.end_line) {
+            return true;
+        }
+    }
+    return false;
+}
+function isSafeCandidatePath(path) {
+    const decoded = decodePathToken(path);
+    const values = decoded === path ? [path] : [path, decoded];
+    return (path.length > 0 &&
+        !isUnsafePathLikeToken(path) &&
+        values.every((value) => scanSecretPath(value).length === 0));
+}
+function rejectProviderSuppliedSource(value) {
+    const stack = [value];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current == null || typeof current !== "object") {
+            continue;
+        }
+        if (Array.isArray(current)) {
+            stack.push(...current);
+            continue;
+        }
+        for (const [key, child] of Object.entries(current)) {
+            if (FORBIDDEN_PROVIDER_KEYS.has(key)) {
+                throw invalid(`context_builder delegate output must not include provider-supplied ${key}`);
+            }
+            stack.push(child);
+        }
+    }
+}
+function invalid(message) {
+    return new InvalidParamsError(message);
+}
+//# sourceMappingURL=delegate-validation.js.map

package/dist/context-builder/delegate-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-validation.js","sourceRoot":"","sources":["../../src/context-builder/delegate-validation.ts"],"names":[],"mappings":"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"}

package/dist/context-builder/delegate.d.ts

@@ -0,0 +1,24 @@
+import { type PipelineResult } from "../pipeline.js";
+import type { AdapterRegistry } from "../registry.js";
+import type { ContextBuilderDelegateProviderConfig } from "./schema.js";
+export type ContextBuilderDelegateFailureReason = "pipeline_error" | "empty_output" | "timeout" | "strict_json_fidelity" | "invalid_json";
+export type ContextBuilderDelegateCallInput = {
+    prompt: string;
+    provider: ContextBuilderDelegateProviderConfig;
+    registry: AdapterRegistry;
+    timeout_seconds: number;
+    max_response_chars: number;
+    signal?: AbortSignal;
+};
+export type ContextBuilderDelegateCallResult = {
+    ok: true;
+    json: Record<string, unknown>;
+    raw: string;
+    pipeline: PipelineResult;
+} | {
+    ok: false;
+    reason: ContextBuilderDelegateFailureReason;
+    message: string;
+    pipeline?: PipelineResult;
+};
+export declare function runContextBuilderDelegateCall(input: ContextBuilderDelegateCallInput): Promise<ContextBuilderDelegateCallResult>;

package/dist/context-builder/delegate.js

@@ -0,0 +1,133 @@
+import { CancellationError } from "../errors.js";
+import { executePipeline } from "../pipeline.js";
+export async function runContextBuilderDelegateCall(input) {
+    const child = new AbortController();
+    let timedOut = false;
+    let parentCancelled = input.signal?.aborted === true;
+    const timeoutMs = Math.max(0, Math.floor(input.timeout_seconds * 1_000));
+    const timeout = setTimeout(() => {
+        timedOut = true;
+        child.abort();
+    }, timeoutMs);
+    const abortFromParent = () => {
+        parentCancelled = true;
+        child.abort();
+    };
+    if (parentCancelled) {
+        child.abort();
+    }
+    else {
+        input.signal?.addEventListener("abort", abortFromParent, { once: true });
+    }
+    try {
+        const clinkInput = {
+            prompt: input.prompt,
+            cli_name: input.provider.cli_name,
+            role: input.provider.role,
+            expect_json: true,
+            max_response_chars: input.max_response_chars,
+            timeout_seconds: input.timeout_seconds,
+            debug: false,
+            debug_keep_artifacts: false,
+        };
+        const pipeline = await executePipeline(clinkInput, input.registry, {
+            signal: child.signal,
+            jsonFidelity: "strict",
+            allowTimeoutBelowAdapter: true,
+        });
+        const termination = pipeline.jsonFidelity?.termination;
+        if (parentCancelled) {
+            throw new CancellationError();
+        }
+        if (termination?.timedOut === true || termination?.reason === "wall") {
+            return failure("timeout", "context_builder delegate call timed out", pipeline);
+        }
+        if (termination?.reason === "cancel") {
+            throw new CancellationError();
+        }
+        const fidelity = pipeline.jsonFidelity;
+        const strict = fidelity?.strict;
+        if (fidelity == null ||
+            fidelity.mode !== "strict" ||
+            strict?.acceptable !== true) {
+            return failure("strict_json_fidelity", strictJsonFidelityMessage(fidelity), pipeline);
+        }
+        if (pipeline.isError === true) {
+            return failure("pipeline_error", "context_builder delegate pipeline returned an error", pipeline);
+        }
+        const raw = pipeline.content[0]?.text?.trim() ?? "";
+        if (raw.length === 0 || raw === "(no output)") {
+            return failure("empty_output", "context_builder delegate returned empty output", pipeline);
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed == null ||
+                typeof parsed !== "object" ||
+                Array.isArray(parsed)) {
+                return failure("invalid_json", "context_builder delegate output must be one JSON object", pipeline);
+            }
+            return {
+                ok: true,
+                json: parsed,
+                raw,
+                pipeline,
+            };
+        }
+        catch {
+            return failure("invalid_json", "context_builder delegate output was not valid JSON", pipeline);
+        }
+    }
+    catch (err) {
+        if (err instanceof CancellationError) {
+            if (parentCancelled) {
+                throw err;
+            }
+            if (timedOut) {
+                return failure("timeout", "context_builder delegate call timed out");
+            }
+            throw err;
+        }
+        return failure("pipeline_error", err instanceof Error
+            ? `context_builder delegate pipeline failed: ${err.message}`
+            : "context_builder delegate pipeline failed");
+    }
+    finally {
+        clearTimeout(timeout);
+        input.signal?.removeEventListener("abort", abortFromParent);
+    }
+}
+function failure(reason, message, pipeline) {
+    return {
+        ok: false,
+        reason,
+        message,
+        ...(pipeline == null ? {} : { pipeline }),
+    };
+}
+function strictJsonFidelityMessage(fidelity) {
+    const details = [];
+    if (fidelity == null) {
+        details.push("missing jsonFidelity metadata");
+    }
+    else {
+        if (fidelity.mode !== "strict") {
+            details.push(`mode=${fidelity.mode}`);
+        }
+        if (fidelity.rejectionReason != null) {
+            details.push(`rejection=${fidelity.rejectionReason}`);
+        }
+        if (fidelity.parseStatus != null) {
+            details.push(`parse=${fidelity.parseStatus}`);
+        }
+        if (fidelity.strict?.acceptable !== true) {
+            details.push("strict.acceptable is not true");
+        }
+        if ((fidelity.strict?.violations.length ?? 0) > 0) {
+            details.push(`violations=${fidelity.strict.violations.join(", ")}`);
+        }
+    }
+    return details.length === 0
+        ? "context_builder delegate JSON fidelity rejected output"
+        : `context_builder delegate JSON fidelity rejected output: ${details.join("; ")}`;
+}
+//# sourceMappingURL=delegate.js.map

package/dist/context-builder/delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.js","sourceRoot":"","sources":["../../src/context-builder/delegate.ts"],"names":[],"mappings":"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"}

package/dist/context-builder/diagnostics.d.ts

@@ -0,0 +1,27 @@
+import { type ContextBuilderInternalCaps } from "./config.js";
+export type ContextBuilderWarning = {
+    code: string;
+    message: string;
+};
+export type ContextBuilderOmission = {
+    root_index?: number;
+    reason: string;
+    message: string;
+    paths?: string[];
+    omitted_path_count?: number;
+};
+export declare const CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON = "requested_evidence_omission";
+export type ContextBuilderRequestedEvidenceOmissionKind = "unavailable" | "too_large" | "candidate_cap" | "discovery_candidate_cap" | "packet_token_cap" | "pruned";
+export declare function requestedEvidenceOmission(input: {
+    root_index?: number;
+    kind: ContextBuilderRequestedEvidenceOmissionKind;
+    message: string;
+    paths?: string[];
+}): ContextBuilderOmission;
+export declare function isRequestedEvidenceOmission(omission: Pick<ContextBuilderOmission, "reason">): boolean;
+export declare function boundContextBuilderWarnings(warnings: ContextBuilderWarning[], caps?: Pick<ContextBuilderInternalCaps, "max_warnings">): ContextBuilderWarning[];
+export declare function boundContextBuilderOmissions(omissions: ContextBuilderOmission[], caps?: Pick<ContextBuilderInternalCaps, "max_omissions" | "max_paths_per_omission">): ContextBuilderOmission[];
+export declare function boundContextBuilderPathList(paths: string[], maxPaths?: number): string[];
+export declare function sanitizeDiagnosticText(text: string): string;
+export declare function hasEmbeddedAbsolutePath(text: string): boolean;
+export declare function sanitizeProgressMessage(message: string): string;

package/dist/context-builder/diagnostics.js

@@ -0,0 +1,74 @@
+import { CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS, } from "./config.js";
+import { hasHighConfidenceSecret, scanSecretPath } from "./secrets.js";
+export const CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON = "requested_evidence_omission";
+export function requestedEvidenceOmission(input) {
+    return {
+        ...(input.root_index == null ? {} : { root_index: input.root_index }),
+        reason: CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON,
+        message: `Requested local evidence omitted (${input.kind}): ${input.message}`,
+        ...(input.paths == null ? {} : { paths: input.paths }),
+    };
+}
+export function isRequestedEvidenceOmission(omission) {
+    return omission.reason === CONTEXT_BUILDER_REQUESTED_EVIDENCE_OMISSION_REASON;
+}
+const MAX_DIAGNOSTIC_TEXT_LENGTH = 240;
+const MAX_PROGRESS_TEXT_LENGTH = 120;
+const MAX_PATH_TEXT_LENGTH = 300;
+const EMBEDDED_ABSOLUTE_PATH_PATTERN = /(^|[\s=:(\["'`])((?:~\/|\/(?!\/)|[A-Za-z]:[\\/]|\\\\)[^\s"'`,;)\]}]*)/g;
+export function boundContextBuilderWarnings(warnings, caps = CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS) {
+    return warnings.slice(0, caps.max_warnings).map((warning) => ({
+        code: sanitizeDiagnosticText(warning.code),
+        message: sanitizeDiagnosticText(warning.message),
+    }));
+}
+export function boundContextBuilderOmissions(omissions, caps = CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS) {
+    return omissions.slice(0, caps.max_omissions).map((omission) => ({
+        ...(omission.root_index == null ? {} : { root_index: omission.root_index }),
+        reason: sanitizeDiagnosticText(omission.reason),
+        message: sanitizeDiagnosticText(omission.message),
+        ...(omission.paths == null
+            ? {}
+            : {
+                paths: boundContextBuilderPathList(omission.paths, caps.max_paths_per_omission),
+                omitted_path_count: Math.max(0, omission.paths.length - caps.max_paths_per_omission),
+            }),
+    }));
+}
+export function boundContextBuilderPathList(paths, maxPaths = CONTEXT_BUILDER_INTERNAL_CAP_DEFAULTS.max_paths_per_omission) {
+    return paths.slice(0, maxPaths).map(sanitizePathText);
+}
+export function sanitizeDiagnosticText(text) {
+    const collapsed = redactEmbeddedAbsolutePaths(text.replace(/\s+/g, " ").trim());
+    if (hasHighConfidenceSecret(collapsed)) {
+        return "[redacted-sensitive]";
+    }
+    const bounded = collapsed.length > MAX_DIAGNOSTIC_TEXT_LENGTH
+        ? `${collapsed.slice(0, MAX_DIAGNOSTIC_TEXT_LENGTH - 3)}...`
+        : collapsed;
+    return bounded;
+}
+export function hasEmbeddedAbsolutePath(text) {
+    EMBEDDED_ABSOLUTE_PATH_PATTERN.lastIndex = 0;
+    return EMBEDDED_ABSOLUTE_PATH_PATTERN.test(text);
+}
+function redactEmbeddedAbsolutePaths(text) {
+    EMBEDDED_ABSOLUTE_PATH_PATTERN.lastIndex = 0;
+    return text.replace(EMBEDDED_ABSOLUTE_PATH_PATTERN, "$1[redacted-absolute-path]");
+}
+export function sanitizeProgressMessage(message) {
+    const sanitized = sanitizeDiagnosticText(message);
+    return sanitized.length > MAX_PROGRESS_TEXT_LENGTH
+        ? `${sanitized.slice(0, MAX_PROGRESS_TEXT_LENGTH - 3)}...`
+        : sanitized;
+}
+function sanitizePathText(path) {
+    const normalized = path.replace(/[\r\n\u0000]/g, "?");
+    if (scanSecretPath(normalized).length > 0 ||
+        hasHighConfidenceSecret(normalized)) {
+        return "[redacted-sensitive-path]";
+    }
+    const bounded = normalized.slice(0, MAX_PATH_TEXT_LENGTH);
+    return bounded;
+}
+//# sourceMappingURL=diagnostics.js.map