clinkx 0.2.3 → 0.3.0

package/dist/context-builder/schema.js

@@ -0,0 +1,293 @@
+import { z } from "zod";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { InvalidParamsError } from "../errors.js";
+import { validateCallerRunId } from "./run-id.js";
+import { assertNoHighConfidenceSecretsInTask } from "./secrets.js";
+export const CONTEXT_BUILDER_INTENT_PROFILES = [
+    "handoff_small",
+    "implementation_medium",
+    "review_deep",
+];
+export const CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS = Object.freeze({
+    max_estimated_tokens: 24_000,
+    max_files: 200,
+    max_scan_files: 10_000,
+    max_bytes_per_file: 1_000_000,
+    max_total_bytes: 5_000_000,
+    max_search_results: 1_000,
+});
+export const CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS = Object.freeze({
+    max_estimated_tokens: 200_000,
+    max_files: 300,
+    max_scan_files: 50_000,
+    max_bytes_per_file: 1_000_000,
+    max_total_bytes: 5_000_000,
+    max_search_results: 5_000,
+});
+export const CONTEXT_BUILDER_DELEGATE_DEFAULTS = Object.freeze({
+    timeout_seconds: 120,
+    max_response_chars: 20_000,
+    failure_policy: "fallback",
+    finalizer_min_score: 8.5,
+});
+export const CONTEXT_BUILDER_DELEGATE_HARD_LIMITS = Object.freeze({
+    timeout_seconds: 600,
+    max_response_chars: 200_000,
+});
+export const CONTEXT_BUILDER_INTENT_PROFILE_DEFAULTS = Object.freeze({
+    handoff_small: {
+        budget: {
+            max_estimated_tokens: 12_000,
+            max_files: 80,
+            max_scan_files: 5_000,
+            max_bytes_per_file: 1_000_000,
+            max_total_bytes: 2_500_000,
+            max_search_results: 500,
+        },
+        delegate: {
+            timeout_seconds: 90,
+            max_response_chars: 12_000,
+        },
+        finalizer_enabled: false,
+    },
+    implementation_medium: {
+        budget: {
+            max_estimated_tokens: 48_000,
+            max_files: 200,
+            max_scan_files: 15_000,
+            max_bytes_per_file: 1_000_000,
+            max_total_bytes: 5_000_000,
+            max_search_results: 1_500,
+        },
+        delegate: {
+            timeout_seconds: 120,
+            max_response_chars: 20_000,
+        },
+        finalizer_enabled: false,
+    },
+    review_deep: {
+        budget: {
+            max_estimated_tokens: 96_000,
+            max_files: 300,
+            max_scan_files: 30_000,
+            max_bytes_per_file: 1_000_000,
+            max_total_bytes: 5_000_000,
+            max_search_results: 3_000,
+        },
+        delegate: {
+            timeout_seconds: 180,
+            max_response_chars: 40_000,
+        },
+        finalizer_enabled: true,
+    },
+});
+const ContextBuilderProfileSchema = z.enum(CONTEXT_BUILDER_INTENT_PROFILES);
+const ContextBuilderBudgetSchema = z
+    .object({
+    max_estimated_tokens: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_estimated_tokens)
+        .optional(),
+    max_files: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_files)
+        .optional(),
+    max_scan_files: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_scan_files)
+        .optional(),
+    max_bytes_per_file: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_bytes_per_file)
+        .optional(),
+    max_total_bytes: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_total_bytes)
+        .optional(),
+    max_search_results: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS.max_search_results)
+        .optional(),
+})
+    .strict()
+    .default({});
+const NonBlankStringSchema = z.string().trim().min(1);
+const TaskSchema = NonBlankStringSchema.max(4_000).describe("Task for context curation");
+const DelegateProviderConfigSchema = z
+    .object({
+    cli_name: NonBlankStringSchema,
+    role: NonBlankStringSchema,
+})
+    .strict();
+const DelegateFinalizerConfigSchema = DelegateProviderConfigSchema.extend({
+    enabled: z.boolean().optional(),
+    min_score: z
+        .number()
+        .min(0)
+        .max(10)
+        .default(CONTEXT_BUILDER_DELEGATE_DEFAULTS.finalizer_min_score),
+}).strict();
+const DisabledDelegateSchema = z
+    .object({
+    enabled: z.literal(false).default(false),
+})
+    .strict();
+const EnabledDelegateSchema = z
+    .object({
+    enabled: z.literal(true),
+    curator: DelegateProviderConfigSchema,
+    finalizer: DelegateFinalizerConfigSchema,
+    timeout_seconds: z
+        .number()
+        .int()
+        .min(1)
+        .max(CONTEXT_BUILDER_DELEGATE_HARD_LIMITS.timeout_seconds)
+        .optional(),
+    max_response_chars: z
+        .number()
+        .int()
+        .positive()
+        .max(CONTEXT_BUILDER_DELEGATE_HARD_LIMITS.max_response_chars)
+        .optional(),
+    failure_policy: z
+        .enum(["fallback", "fail"])
+        .optional(),
+})
+    .strict();
+const DelegateSchema = z
+    .union([EnabledDelegateSchema, DisabledDelegateSchema])
+    .default({ enabled: false });
+/**
+ * Strict context_builder input schema. Delegate provider names are explicit
+ * request fields; no curator or finalizer provider defaults are hardcoded.
+ */
+export const ContextBuilderInputSchema = z
+    .object({
+    task: TaskSchema,
+    // Frozen v1 input schema: `profile` is an additive optional v1 extension.
+    profile: ContextBuilderProfileSchema.optional(),
+    roots: z.array(NonBlankStringSchema).max(8).optional(),
+    focus_paths: z.array(NonBlankStringSchema).max(200).default([]),
+    include_globs: z.array(NonBlankStringSchema).max(50).default([]),
+    exclude_globs: z.array(NonBlankStringSchema).max(100).default([]),
+    search_terms: z.array(NonBlankStringSchema).max(20).default([]),
+    budget: ContextBuilderBudgetSchema,
+    delegate: DelegateSchema,
+    run_id: z.string().optional().transform(validateOptionalRunId),
+    debug: z.boolean().default(false),
+})
+    .strict()
+    .transform((input) => ({
+    ...input,
+    roots: input.roots ?? [process.cwd()],
+    budget: resolveContextBuilderProfileBudget(input.profile, compactContextBuilderBudgetInput(input.budget)),
+    delegate: resolveContextBuilderProfileDelegate(input.profile, input.delegate),
+}));
+export function parseContextBuilderInput(input) {
+    const result = ContextBuilderInputSchema.safeParse(input);
+    if (!result.success) {
+        throw new InvalidParamsError(`Invalid context_builder input: ${result.error.issues
+            .map((issue) => issue.message)
+            .join("; ")}`);
+    }
+    assertNoHighConfidenceSecretsInTask(result.data.task);
+    return result.data;
+}
+export function normalizeContextBuilderPublicBudget(budget = {}) {
+    const maxEstimatedTokens = budget.max_estimated_tokens ??
+        CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_estimated_tokens;
+    const normalized = {
+        max_estimated_tokens: maxEstimatedTokens,
+        target_estimated_tokens: Math.floor(0.9 * maxEstimatedTokens),
+        max_files: budget.max_files ?? CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_files,
+        max_scan_files: budget.max_scan_files ??
+            CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_scan_files,
+        max_bytes_per_file: budget.max_bytes_per_file ??
+            CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_bytes_per_file,
+        max_total_bytes: budget.max_total_bytes ??
+            CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_total_bytes,
+        max_search_results: budget.max_search_results ??
+            CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS.max_search_results,
+    };
+    for (const [key, value] of Object.entries(normalized)) {
+        if (key === "target_estimated_tokens") {
+            continue;
+        }
+        const hardLimit = CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS[key];
+        if (!Number.isInteger(value) || value <= 0 || value > hardLimit) {
+            throw new InvalidParamsError(`context_builder budget.${key} must be a positive integer <= ${hardLimit}`);
+        }
+    }
+    return normalized;
+}
+export function resolveContextBuilderProfileBudget(profile, budget = {}) {
+    const profileBudget = profile == null ? {} : CONTEXT_BUILDER_INTENT_PROFILE_DEFAULTS[profile].budget;
+    return normalizeContextBuilderPublicBudget({
+        ...profileBudget,
+        ...budget,
+    });
+}
+function resolveContextBuilderProfileDelegate(profile, delegate) {
+    if (!delegate.enabled) {
+        return delegate;
+    }
+    const profileDelegate = profile == null
+        ? {}
+        : CONTEXT_BUILDER_INTENT_PROFILE_DEFAULTS[profile].delegate;
+    return {
+        ...delegate,
+        timeout_seconds: delegate.timeout_seconds ??
+            profileDelegate.timeout_seconds ??
+            CONTEXT_BUILDER_DELEGATE_DEFAULTS.timeout_seconds,
+        max_response_chars: delegate.max_response_chars ??
+            profileDelegate.max_response_chars ??
+            CONTEXT_BUILDER_DELEGATE_DEFAULTS.max_response_chars,
+        failure_policy: delegate.failure_policy ??
+            CONTEXT_BUILDER_DELEGATE_DEFAULTS.failure_policy,
+    };
+}
+function compactContextBuilderBudgetInput(budget) {
+    return {
+        ...(budget.max_estimated_tokens == null
+            ? {}
+            : { max_estimated_tokens: budget.max_estimated_tokens }),
+        ...(budget.max_files == null ? {} : { max_files: budget.max_files }),
+        ...(budget.max_scan_files == null
+            ? {}
+            : { max_scan_files: budget.max_scan_files }),
+        ...(budget.max_bytes_per_file == null
+            ? {}
+            : { max_bytes_per_file: budget.max_bytes_per_file }),
+        ...(budget.max_total_bytes == null
+            ? {}
+            : { max_total_bytes: budget.max_total_bytes }),
+        ...(budget.max_search_results == null
+            ? {}
+            : { max_search_results: budget.max_search_results }),
+    };
+}
+export function contextBuilderJsonSchema() {
+    return zodToJsonSchema(ContextBuilderInputSchema, {
+        target: "jsonSchema7",
+        $refStrategy: "none",
+    });
+}
+function validateOptionalRunId(runId) {
+    if (runId == null) {
+        return undefined;
+    }
+    return validateCallerRunId(runId);
+}
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,13 @@
+export type SecretFindingKind = "path" | "content";
+export type SecretFinding = {
+    kind: SecretFindingKind;
+    confidence: "high";
+    provenance: string;
+    line?: number;
+};
+export declare function scanSecretPath(rootRelativePath: string): SecretFinding[];
+export declare function scanHighConfidenceSecretContent(text: string): SecretFinding[];
+export declare function isBlockingSecretFinding(finding: SecretFinding): boolean;
+export declare function redactHighConfidenceAssignmentSecrets(text: string): string;
+export declare function assertNoHighConfidenceSecretsInTask(task: string): void;
+export declare function hasHighConfidenceSecret(text: string): boolean;

package/dist/context-builder/secrets.js

@@ -0,0 +1,222 @@
+import { InvalidParamsError } from "../errors.js";
+const PRIVATE_KEY_BLOCK_PATTERN = /-----BEGIN [A-Z0-9][A-Z0-9 ]{0,48}PRIVATE KEY-----/;
+const WELL_KNOWN_TOKEN_PATTERNS = [
+    { provenance: "aws_access_key_id", pattern: /\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/ },
+    { provenance: "github_token", pattern: /\bgh[opusr]_[A-Za-z0-9_]{30,}\b/ },
+    {
+        provenance: "github_fine_grained_token",
+        pattern: /\bgithub_pat_[A-Za-z0-9_]{20,}_[A-Za-z0-9_]{20,}\b/,
+    },
+    { provenance: "npm_token", pattern: /\bnpm_[A-Za-z0-9]{30,}\b/ },
+    { provenance: "slack_token", pattern: /\bxox[baprs]-[A-Za-z0-9-]{20,}\b/ },
+];
+const ASSIGNMENT_PATTERN = /\b(password|passwd|api[_-]?key|secret|token|access[_-]?token|private[_-]?key|client[_-]?secret)\b\s*[:=]\s*(['"]?)([^'"\s;,#]{8,})\2/i;
+const PLACEHOLDER_VALUES = new Set([
+    "changeme",
+    "example",
+    "placeholder",
+    "redacted",
+    "secret",
+    "token",
+    "password",
+    "apikey",
+    "api_key",
+    "your_token_here",
+    "your_api_key",
+    "notasecret",
+    "dummy",
+    "test",
+]);
+export function scanSecretPath(rootRelativePath) {
+    const normalized = normalizeSecretPath(rootRelativePath);
+    const comparable = normalized.toLowerCase();
+    const segments = comparable.split("/").filter(Boolean);
+    const basename = segments.at(-1) ?? normalized;
+    const findings = [];
+    if (basename === ".env" || basename.startsWith(".env.")) {
+        findings.push(pathFinding("path_basename_dotenv"));
+    }
+    if ([".npmrc", ".netrc", ".pypirc"].includes(basename)) {
+        findings.push(pathFinding(`path_basename_${basename.slice(1)}`));
+    }
+    if (basename.endsWith(".pem")) {
+        findings.push(pathFinding("path_extension_pem"));
+    }
+    if (basename.endsWith(".key")) {
+        findings.push(pathFinding("path_extension_key"));
+    }
+    if (basename === "id_rsa" || basename === "id_ed25519") {
+        findings.push(pathFinding(`path_basename_${basename}`));
+    }
+    if (basename === "credentials.json") {
+        findings.push(pathFinding("path_basename_credentials_json"));
+    }
+    if (segments.some((segment) => isSecretDirectorySegment(segment))) {
+        findings.push(pathFinding("path_secret_directory_segment"));
+    }
+    if (hasPathSuffix(segments, [".aws", "credentials"])) {
+        findings.push(pathFinding("path_aws_credentials"));
+    }
+    if (hasPathPrefix(segments, [".config", "gcloud"])) {
+        findings.push(pathFinding("path_gcloud_config"));
+    }
+    if (hasPathPrefix(segments, [".azure"])) {
+        findings.push(pathFinding("path_azure_config"));
+    }
+    return dedupeFindings(findings);
+}
+export function scanHighConfidenceSecretContent(text) {
+    const findings = [];
+    const privateKeyLine = findPatternLine(text, PRIVATE_KEY_BLOCK_PATTERN);
+    if (privateKeyLine != null) {
+        findings.push(contentFinding("private_key_block", privateKeyLine));
+    }
+    for (const { provenance, pattern } of WELL_KNOWN_TOKEN_PATTERNS) {
+        const line = findPatternLine(text, pattern);
+        if (line != null) {
+            findings.push(contentFinding(provenance, line));
+        }
+    }
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index++) {
+        const match = ASSIGNMENT_PATTERN.exec(lines[index] ?? "");
+        if (match == null) {
+            continue;
+        }
+        const value = match[3] ?? "";
+        const quote = match[2] ?? "";
+        if (quote.length === 0 && looksLikeCodeExpression(value)) {
+            continue;
+        }
+        if (isHighConfidenceAssignedSecret(value)) {
+            findings.push(contentFinding("assignment_secret", index + 1));
+            break;
+        }
+    }
+    return dedupeFindings(findings);
+}
+export function isBlockingSecretFinding(finding) {
+    return finding.provenance !== "assignment_secret";
+}
+export function redactHighConfidenceAssignmentSecrets(text) {
+    return text
+        .split(/(\r?\n)/)
+        .map((part) => {
+        if (part === "\n" || part === "\r\n") {
+            return part;
+        }
+        return redactAssignmentSecretLine(part);
+    })
+        .join("");
+}
+export function assertNoHighConfidenceSecretsInTask(task) {
+    const findings = scanHighConfidenceSecretContent(task);
+    if (findings.length === 0) {
+        return;
+    }
+    const provenances = findings.map((finding) => finding.provenance).join(", ");
+    throw new InvalidParamsError(`context_builder task contains high-confidence secret material (${provenances})`);
+}
+export function hasHighConfidenceSecret(text) {
+    return scanHighConfidenceSecretContent(text).length > 0;
+}
+function normalizeSecretPath(rootRelativePath) {
+    return rootRelativePath.replaceAll("\\", "/").replace(/^\.\/+/, "");
+}
+function pathFinding(provenance) {
+    return { kind: "path", confidence: "high", provenance };
+}
+function contentFinding(provenance, line) {
+    return { kind: "content", confidence: "high", provenance, line };
+}
+function hasPathSuffix(segments, suffix) {
+    if (suffix.length > segments.length) {
+        return false;
+    }
+    return suffix.every((segment, index) => segments[segments.length - suffix.length + index] === segment);
+}
+function hasPathPrefix(segments, prefix) {
+    if (prefix.length > segments.length) {
+        return false;
+    }
+    return prefix.every((segment, index) => segments[index] === segment);
+}
+function isSecretDirectorySegment(segment) {
+    return (segment === "secrets" ||
+        segment === ".secrets" ||
+        segment === "private_keys" ||
+        segment === "credentials");
+}
+function findPatternLine(text, pattern) {
+    const lines = text.split(/\r?\n/);
+    for (let index = 0; index < lines.length; index++) {
+        if (pattern.test(lines[index] ?? "")) {
+            return index + 1;
+        }
+    }
+    return undefined;
+}
+function looksLikeCodeExpression(value) {
+    return (/^[A-Za-z_][A-Za-z0-9_:.]*\([^"'`]*\)$/.test(value) ||
+        /^[A-Za-z_][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_.]*$/.test(value) ||
+        /^[A-Za-z_][A-Za-z0-9_]*_[A-Za-z0-9_]*$/.test(value));
+}
+function isHighConfidenceAssignedSecret(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized.length < 16) {
+        return false;
+    }
+    if (PLACEHOLDER_VALUES.has(normalized)) {
+        return false;
+    }
+    if (/^(?:x+|\*+|0+|1+|a+)$/.test(normalized)) {
+        return false;
+    }
+    if (/^<[^>]+>$/.test(normalized) || /^\$\{[^}]+}$/.test(normalized)) {
+        return false;
+    }
+    return shannonEntropy(value) >= 3;
+}
+function redactAssignmentSecretLine(line) {
+    const match = ASSIGNMENT_PATTERN.exec(line);
+    if (match == null) {
+        return line;
+    }
+    const value = match[3] ?? "";
+    const quote = match[2] ?? "";
+    if (quote.length === 0 && looksLikeCodeExpression(value)) {
+        return line;
+    }
+    if (!isHighConfidenceAssignedSecret(value)) {
+        return line;
+    }
+    const valueStart = match.index + match[0].lastIndexOf(value);
+    if (valueStart < match.index) {
+        return line;
+    }
+    return `${line.slice(0, valueStart)}[redacted-sensitive]${line.slice(valueStart + value.length)}`;
+}
+function shannonEntropy(value) {
+    const counts = new Map();
+    for (const char of value) {
+        counts.set(char, (counts.get(char) ?? 0) + 1);
+    }
+    let entropy = 0;
+    for (const count of counts.values()) {
+        const probability = count / value.length;
+        entropy -= probability * Math.log2(probability);
+    }
+    return entropy;
+}
+function dedupeFindings(findings) {
+    const seen = new Set();
+    return findings.filter((finding) => {
+        const key = `${finding.kind}:${finding.provenance}:${finding.line ?? ""}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=secrets.js.map

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

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

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

@@ -0,0 +1,52 @@
+import { type ContextBuilderSearchRecord, type ContextBuilderSliceRecord, type ContextBuilderTreeFile } from "./discovery.js";
+import type { ContextBuilderOmission } from "./diagnostics.js";
+import type { ContextBuilderPublicBudget } from "./schema.js";
+export type ContextBuilderSelectedRange = {
+    start_line: number;
+    end_line: number;
+};
+export type ContextBuilderSelectedFile = {
+    root_index: number;
+    path: string;
+    ranges: ContextBuilderSelectedRange[];
+    content: string;
+    bytes: number;
+    estimated_tokens: number;
+    source: "focus" | "search";
+};
+export type ContextBuilderSelectionMetrics = {
+    files_selected: number;
+    files_omitted: number;
+    bytes_selected: number;
+    estimated_tokens: number;
+    truncated: boolean;
+};
+export type ContextBuilderSelectionTier = "full_file" | "signature_slices" | "omitted";
+export type ContextBuilderSelectionSummaryFile = {
+    root_index: number;
+    path: string;
+    tier: ContextBuilderSelectionTier;
+    bytes: number;
+    estimated_tokens: number;
+    reason?: string;
+};
+export type ContextBuilderSelectionResult = {
+    selected: ContextBuilderSelectedFile[];
+    tree: ContextBuilderTreeFile[];
+    search: ContextBuilderSearchRecord[];
+    slices: ContextBuilderSliceRecord[];
+    omissions: ContextBuilderOmission[];
+    metrics: ContextBuilderSelectionMetrics;
+    summary?: {
+        files: ContextBuilderSelectionSummaryFile[];
+    };
+};
+export declare function selectContextBuilderFinalContext(input: {
+    task?: string;
+    tree: readonly ContextBuilderTreeFile[];
+    search: readonly ContextBuilderSearchRecord[];
+    slices: readonly ContextBuilderSliceRecord[];
+    budget: ContextBuilderPublicBudget;
+}): ContextBuilderSelectionResult;
+export declare function isContextBuilderTaskClosureAnchor(path: string, task: string): boolean;
+export declare function contextBuilderTaskClosureAnchorRank(path: string, task: string): number;