clinkx 0.2.3 → 1.0.0

package/dist/context-builder/run-id.js

@@ -0,0 +1,31 @@
+import { randomBytes } from "node:crypto";
+import { InvalidParamsError } from "../errors.js";
+const CALLER_RUN_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const GENERATED_RUN_ID_PATTERN = /^ctx_\d{8}T\d{6}Z_[0-9a-f]{8,12}$/;
+export function validateCallerRunId(runId) {
+    if (!CALLER_RUN_ID_PATTERN.test(runId)) {
+        throw new InvalidParamsError("context_builder run_id must match [A-Za-z0-9_-]{1,64}");
+    }
+    return runId;
+}
+export function generateContextBuilderRunId(options = {}) {
+    const now = options.now?.() ?? new Date();
+    const timestamp = now.toISOString().replace(/[-:]/g, "").slice(0, 15);
+    const suffix = normalizeGeneratedHex(options.randomHex?.() ?? randomBytes(6).toString("hex"));
+    const runId = `ctx_${timestamp}Z_${suffix}`;
+    if (!GENERATED_RUN_ID_PATTERN.test(runId)) {
+        throw new Error(`Generated context_builder run_id is invalid: ${runId}`);
+    }
+    return runId;
+}
+export function isGeneratedContextBuilderRunId(runId) {
+    return GENERATED_RUN_ID_PATTERN.test(runId);
+}
+function normalizeGeneratedHex(input) {
+    const hex = input.toLowerCase();
+    if (!/^[0-9a-f]{8,12}$/.test(hex)) {
+        throw new Error("context_builder generated run_id suffix must be 8-12 hex");
+    }
+    return hex;
+}
+//# sourceMappingURL=run-id.js.map

package/dist/context-builder/run-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id.js","sourceRoot":"","sources":["../../src/context-builder/run-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AACtD,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAOrE,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,kBAAkB,CAC1B,uDAAuD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,UAAiC,EAAE;IAEnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,qBAAqB,CAClC,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACxD,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,SAAS,KAAK,MAAM,EAAE,CAAC;IAE5C,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAa;IAC1D,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAEhC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,669 @@
+import { z } from "zod";
+export type ContextBuilderPublicBudget = {
+    max_estimated_tokens: number;
+    target_estimated_tokens: number;
+    max_files: number;
+    max_scan_files: number;
+    max_bytes_per_file: number;
+    max_total_bytes: number;
+    max_search_results: number;
+};
+export type ContextBuilderPublicBudgetInput = Partial<Omit<ContextBuilderPublicBudget, "target_estimated_tokens">>;
+export declare const CONTEXT_BUILDER_INTENT_PROFILES: readonly ["handoff_small", "implementation_medium", "review_deep"];
+export type ContextBuilderIntentProfile = (typeof CONTEXT_BUILDER_INTENT_PROFILES)[number];
+export declare const CONTEXT_BUILDER_PUBLIC_BUDGET_DEFAULTS: Readonly<{
+    max_estimated_tokens: number;
+    max_files: number;
+    max_scan_files: number;
+    max_bytes_per_file: number;
+    max_total_bytes: number;
+    max_search_results: number;
+}>;
+export declare const CONTEXT_BUILDER_PUBLIC_BUDGET_HARD_LIMITS: Readonly<{
+    max_estimated_tokens: number;
+    max_files: number;
+    max_scan_files: number;
+    max_bytes_per_file: number;
+    max_total_bytes: number;
+    max_search_results: number;
+}>;
+export declare const CONTEXT_BUILDER_DELEGATE_DEFAULTS: Readonly<{
+    readonly timeout_seconds: 120;
+    readonly max_response_chars: 20000;
+    readonly failure_policy: "fallback";
+    readonly finalizer_min_score: 8.5;
+}>;
+export declare const CONTEXT_BUILDER_DELEGATE_HARD_LIMITS: Readonly<{
+    readonly timeout_seconds: 600;
+    readonly max_response_chars: 200000;
+}>;
+export type ContextBuilderIntentProfileDefaults = {
+    budget: ContextBuilderPublicBudgetInput;
+    delegate: Partial<{
+        timeout_seconds: number;
+        max_response_chars: number;
+    }>;
+    finalizer_enabled: boolean;
+};
+export declare const CONTEXT_BUILDER_INTENT_PROFILE_DEFAULTS: Readonly<{
+    handoff_small: {
+        budget: {
+            max_estimated_tokens: number;
+            max_files: number;
+            max_scan_files: number;
+            max_bytes_per_file: number;
+            max_total_bytes: number;
+            max_search_results: number;
+        };
+        delegate: {
+            timeout_seconds: number;
+            max_response_chars: number;
+        };
+        finalizer_enabled: false;
+    };
+    implementation_medium: {
+        budget: {
+            max_estimated_tokens: number;
+            max_files: number;
+            max_scan_files: number;
+            max_bytes_per_file: number;
+            max_total_bytes: number;
+            max_search_results: number;
+        };
+        delegate: {
+            timeout_seconds: number;
+            max_response_chars: number;
+        };
+        finalizer_enabled: false;
+    };
+    review_deep: {
+        budget: {
+            max_estimated_tokens: number;
+            max_files: number;
+            max_scan_files: number;
+            max_bytes_per_file: number;
+            max_total_bytes: number;
+            max_search_results: number;
+        };
+        delegate: {
+            timeout_seconds: number;
+            max_response_chars: number;
+        };
+        finalizer_enabled: true;
+    };
+}>;
+export declare const ContextBuilderAdapterBudgetDefaultsSchema: z.ZodObject<{
+    max_estimated_tokens: z.ZodOptional<z.ZodNumber>;
+    max_files: z.ZodOptional<z.ZodNumber>;
+    max_scan_files: z.ZodOptional<z.ZodNumber>;
+    max_bytes_per_file: z.ZodOptional<z.ZodNumber>;
+    max_total_bytes: z.ZodOptional<z.ZodNumber>;
+    max_search_results: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    max_estimated_tokens?: number | undefined;
+    max_files?: number | undefined;
+    max_scan_files?: number | undefined;
+    max_bytes_per_file?: number | undefined;
+    max_total_bytes?: number | undefined;
+    max_search_results?: number | undefined;
+}, {
+    max_estimated_tokens?: number | undefined;
+    max_files?: number | undefined;
+    max_scan_files?: number | undefined;
+    max_bytes_per_file?: number | undefined;
+    max_total_bytes?: number | undefined;
+    max_search_results?: number | undefined;
+}>;
+declare const DelegateProviderConfigSchema: z.ZodObject<{
+    cli_name: z.ZodString;
+    role: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    cli_name: string;
+    role: string;
+}, {
+    cli_name: string;
+    role: string;
+}>;
+declare const DelegateFinalizerConfigSchema: z.ZodObject<{
+    cli_name: z.ZodString;
+    role: z.ZodString;
+} & {
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    min_score: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    cli_name: string;
+    role: string;
+    min_score: number;
+    enabled?: boolean | undefined;
+}, {
+    cli_name: string;
+    role: string;
+    enabled?: boolean | undefined;
+    min_score?: number | undefined;
+}>;
+declare const DisabledDelegateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodLiteral<false>>;
+}, "strict", z.ZodTypeAny, {
+    enabled: false;
+}, {
+    enabled?: false | undefined;
+}>;
+declare const EnabledDelegateSchema: z.ZodObject<{
+    enabled: z.ZodLiteral<true>;
+    curator: z.ZodObject<{
+        cli_name: z.ZodString;
+        role: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: string;
+        role: string;
+    }, {
+        cli_name: string;
+        role: string;
+    }>;
+    finalizer: z.ZodObject<{
+        cli_name: z.ZodString;
+        role: z.ZodString;
+    } & {
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        min_score: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        cli_name: string;
+        role: string;
+        min_score: number;
+        enabled?: boolean | undefined;
+    }, {
+        cli_name: string;
+        role: string;
+        enabled?: boolean | undefined;
+        min_score?: number | undefined;
+    }>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    max_response_chars: z.ZodOptional<z.ZodNumber>;
+    failure_policy: z.ZodOptional<z.ZodEnum<["fallback", "fail"]>>;
+}, "strict", z.ZodTypeAny, {
+    enabled: true;
+    curator: {
+        cli_name: string;
+        role: string;
+    };
+    finalizer: {
+        cli_name: string;
+        role: string;
+        min_score: number;
+        enabled?: boolean | undefined;
+    };
+    timeout_seconds?: number | undefined;
+    max_response_chars?: number | undefined;
+    failure_policy?: "fallback" | "fail" | undefined;
+}, {
+    enabled: true;
+    curator: {
+        cli_name: string;
+        role: string;
+    };
+    finalizer: {
+        cli_name: string;
+        role: string;
+        enabled?: boolean | undefined;
+        min_score?: number | undefined;
+    };
+    timeout_seconds?: number | undefined;
+    max_response_chars?: number | undefined;
+    failure_policy?: "fallback" | "fail" | undefined;
+}>;
+export type ContextBuilderDelegateProviderConfig = z.infer<typeof DelegateProviderConfigSchema>;
+export type ContextBuilderDelegateFinalizerConfig = z.infer<typeof DelegateFinalizerConfigSchema>;
+export type ContextBuilderEnabledDelegateConfig = Omit<z.infer<typeof EnabledDelegateSchema>, "timeout_seconds" | "max_response_chars" | "failure_policy"> & {
+    timeout_seconds: number;
+    max_response_chars: number;
+    failure_policy: "fallback" | "fail";
+};
+export type ContextBuilderDelegateConfig = ContextBuilderEnabledDelegateConfig | z.infer<typeof DisabledDelegateSchema>;
+/**
+ * Strict context_builder input schema. Delegate provider names are explicit
+ * request fields; no curator or finalizer provider defaults are hardcoded.
+ */
+export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
+    task: z.ZodString;
+    allow_secrets: z.ZodOptional<z.ZodBoolean>;
+    profile: z.ZodOptional<z.ZodEnum<["handoff_small", "implementation_medium", "review_deep"]>>;
+    roots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    focus_paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    include_globs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    exclude_globs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    search_terms: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    budget: z.ZodDefault<z.ZodObject<{
+        max_estimated_tokens: z.ZodOptional<z.ZodNumber>;
+        max_files: z.ZodOptional<z.ZodNumber>;
+        max_scan_files: z.ZodOptional<z.ZodNumber>;
+        max_bytes_per_file: z.ZodOptional<z.ZodNumber>;
+        max_total_bytes: z.ZodOptional<z.ZodNumber>;
+        max_search_results: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        max_estimated_tokens?: number | undefined;
+        max_files?: number | undefined;
+        max_scan_files?: number | undefined;
+        max_bytes_per_file?: number | undefined;
+        max_total_bytes?: number | undefined;
+        max_search_results?: number | undefined;
+    }, {
+        max_estimated_tokens?: number | undefined;
+        max_files?: number | undefined;
+        max_scan_files?: number | undefined;
+        max_bytes_per_file?: number | undefined;
+        max_total_bytes?: number | undefined;
+        max_search_results?: number | undefined;
+    }>>;
+    delegate: z.ZodDefault<z.ZodUnion<[z.ZodObject<{
+        enabled: z.ZodLiteral<true>;
+        curator: z.ZodObject<{
+            cli_name: z.ZodString;
+            role: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            cli_name: string;
+            role: string;
+        }, {
+            cli_name: string;
+            role: string;
+        }>;
+        finalizer: z.ZodObject<{
+            cli_name: z.ZodString;
+            role: z.ZodString;
+        } & {
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            min_score: z.ZodDefault<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            cli_name: string;
+            role: string;
+            min_score: number;
+            enabled?: boolean | undefined;
+        }, {
+            cli_name: string;
+            role: string;
+            enabled?: boolean | undefined;
+            min_score?: number | undefined;
+        }>;
+        timeout_seconds: z.ZodOptional<z.ZodNumber>;
+        max_response_chars: z.ZodOptional<z.ZodNumber>;
+        failure_policy: z.ZodOptional<z.ZodEnum<["fallback", "fail"]>>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: true;
+        curator: {
+            cli_name: string;
+            role: string;
+        };
+        finalizer: {
+            cli_name: string;
+            role: string;
+            min_score: number;
+            enabled?: boolean | undefined;
+        };
+        timeout_seconds?: number | undefined;
+        max_response_chars?: number | undefined;
+        failure_policy?: "fallback" | "fail" | undefined;
+    }, {
+        enabled: true;
+        curator: {
+            cli_name: string;
+            role: string;
+        };
+        finalizer: {
+            cli_name: string;
+            role: string;
+            enabled?: boolean | undefined;
+            min_score?: number | undefined;
+        };
+        timeout_seconds?: number | undefined;
+        max_response_chars?: number | undefined;
+        failure_policy?: "fallback" | "fail" | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodLiteral<false>>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: false;
+    }, {
+        enabled?: false | undefined;
+    }>]>>;
+    run_id: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    debug: boolean;
+    task: string;
+    focus_paths: string[];
+    include_globs: string[];
+    exclude_globs: string[];
+    search_terms: string[];
+    budget: {
+        max_estimated_tokens?: number | undefined;
+        max_files?: number | undefined;
+        max_scan_files?: number | undefined;
+        max_bytes_per_file?: number | undefined;
+        max_total_bytes?: number | undefined;
+        max_search_results?: number | undefined;
+    };
+    delegate: {
+        enabled: false;
+    } | {
+        enabled: true;
+        curator: {
+            cli_name: string;
+            role: string;
+        };
+        finalizer: {
+            cli_name: string;
+            role: string;
+            min_score: number;
+            enabled?: boolean | undefined;
+        };
+        timeout_seconds?: number | undefined;
+        max_response_chars?: number | undefined;
+        failure_policy?: "fallback" | "fail" | undefined;
+    };
+    allow_secrets?: boolean | undefined;
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    roots?: string[] | undefined;
+    run_id?: string | undefined;
+}, {
+    task: string;
+    debug?: boolean | undefined;
+    allow_secrets?: boolean | undefined;
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    roots?: string[] | undefined;
+    focus_paths?: string[] | undefined;
+    include_globs?: string[] | undefined;
+    exclude_globs?: string[] | undefined;
+    search_terms?: string[] | undefined;
+    budget?: {
+        max_estimated_tokens?: number | undefined;
+        max_files?: number | undefined;
+        max_scan_files?: number | undefined;
+        max_bytes_per_file?: number | undefined;
+        max_total_bytes?: number | undefined;
+        max_search_results?: number | undefined;
+    } | undefined;
+    delegate?: {
+        enabled?: false | undefined;
+    } | {
+        enabled: true;
+        curator: {
+            cli_name: string;
+            role: string;
+        };
+        finalizer: {
+            cli_name: string;
+            role: string;
+            enabled?: boolean | undefined;
+            min_score?: number | undefined;
+        };
+        timeout_seconds?: number | undefined;
+        max_response_chars?: number | undefined;
+        failure_policy?: "fallback" | "fail" | undefined;
+    } | undefined;
+    run_id?: string | undefined;
+}>, {
+    roots: string[];
+    budget: ContextBuilderPublicBudget;
+    delegate: ContextBuilderDelegateConfig;
+    debug: boolean;
+    task: string;
+    focus_paths: string[];
+    include_globs: string[];
+    exclude_globs: string[];
+    search_terms: string[];
+    allow_secrets?: boolean | undefined;
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    run_id?: string | undefined;
+}, {
+    task: string;
+    debug?: boolean | undefined;
+    allow_secrets?: boolean | undefined;
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    roots?: string[] | undefined;
+    focus_paths?: string[] | undefined;
+    include_globs?: string[] | undefined;
+    exclude_globs?: string[] | undefined;
+    search_terms?: string[] | undefined;
+    budget?: {
+        max_estimated_tokens?: number | undefined;
+        max_files?: number | undefined;
+        max_scan_files?: number | undefined;
+        max_bytes_per_file?: number | undefined;
+        max_total_bytes?: number | undefined;
+        max_search_results?: number | undefined;
+    } | undefined;
+    delegate?: {
+        enabled?: false | undefined;
+    } | {
+        enabled: true;
+        curator: {
+            cli_name: string;
+            role: string;
+        };
+        finalizer: {
+            cli_name: string;
+            role: string;
+            enabled?: boolean | undefined;
+            min_score?: number | undefined;
+        };
+        timeout_seconds?: number | undefined;
+        max_response_chars?: number | undefined;
+        failure_policy?: "fallback" | "fail" | undefined;
+    } | undefined;
+    run_id?: string | undefined;
+}>;
+export type ContextBuilderInput = z.infer<typeof ContextBuilderInputSchema>;
+export type ResolvedContextBuilderInput = ContextBuilderInput & {
+    allow_secrets: boolean;
+};
+export declare const SELECTION_DISPOSITIONS: readonly ["full", "slices", "codemap_only"];
+export type SelectionDisposition = (typeof SELECTION_DISPOSITIONS)[number];
+export declare const SelectionDispositionSchema: z.ZodEnum<["full", "slices", "codemap_only"]>;
+declare const RefineOpSchema: z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
+    op: z.ZodLiteral<"add">;
+    paths: z.ZodArray<z.ZodString, "many">;
+    mode: z.ZodDefault<z.ZodEnum<["full", "slices", "codemap_only"]>>;
+}, "strict", z.ZodTypeAny, {
+    mode: "full" | "slices" | "codemap_only";
+    op: "add";
+    paths: string[];
+}, {
+    op: "add";
+    paths: string[];
+    mode?: "full" | "slices" | "codemap_only" | undefined;
+}>, z.ZodObject<{
+    op: z.ZodLiteral<"remove">;
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    op: "remove";
+    paths: string[];
+}, {
+    op: "remove";
+    paths: string[];
+}>, z.ZodObject<{
+    op: z.ZodLiteral<"set_slices">;
+    path: z.ZodString;
+    ranges: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        start_line: z.ZodNumber;
+        end_line: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        start_line: number;
+        end_line: number;
+    }, {
+        start_line: number;
+        end_line: number;
+    }>, {
+        start_line: number;
+        end_line: number;
+    }, {
+        start_line: number;
+        end_line: number;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    op: "set_slices";
+    ranges: {
+        start_line: number;
+        end_line: number;
+    }[];
+}, {
+    path: string;
+    op: "set_slices";
+    ranges: {
+        start_line: number;
+        end_line: number;
+    }[];
+}>, z.ZodObject<{
+    op: z.ZodLiteral<"promote">;
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    op: "promote";
+    paths: string[];
+}, {
+    op: "promote";
+    paths: string[];
+}>, z.ZodObject<{
+    op: z.ZodLiteral<"demote">;
+    paths: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    op: "demote";
+    paths: string[];
+}, {
+    op: "demote";
+    paths: string[];
+}>]>;
+export type RefineOp = z.infer<typeof RefineOpSchema>;
+export declare const RefineContextRunInputSchema: z.ZodObject<{
+    prior_run_id: z.ZodEffects<z.ZodString, string, string>;
+    allow_secrets: z.ZodOptional<z.ZodBoolean>;
+    ops: z.ZodArray<z.ZodDiscriminatedUnion<"op", [z.ZodObject<{
+        op: z.ZodLiteral<"add">;
+        paths: z.ZodArray<z.ZodString, "many">;
+        mode: z.ZodDefault<z.ZodEnum<["full", "slices", "codemap_only"]>>;
+    }, "strict", z.ZodTypeAny, {
+        mode: "full" | "slices" | "codemap_only";
+        op: "add";
+        paths: string[];
+    }, {
+        op: "add";
+        paths: string[];
+        mode?: "full" | "slices" | "codemap_only" | undefined;
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"remove">;
+        paths: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        op: "remove";
+        paths: string[];
+    }, {
+        op: "remove";
+        paths: string[];
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"set_slices">;
+        path: z.ZodString;
+        ranges: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            start_line: z.ZodNumber;
+            end_line: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            start_line: number;
+            end_line: number;
+        }, {
+            start_line: number;
+            end_line: number;
+        }>, {
+            start_line: number;
+            end_line: number;
+        }, {
+            start_line: number;
+            end_line: number;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        op: "set_slices";
+        ranges: {
+            start_line: number;
+            end_line: number;
+        }[];
+    }, {
+        path: string;
+        op: "set_slices";
+        ranges: {
+            start_line: number;
+            end_line: number;
+        }[];
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"promote">;
+        paths: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        op: "promote";
+        paths: string[];
+    }, {
+        op: "promote";
+        paths: string[];
+    }>, z.ZodObject<{
+        op: z.ZodLiteral<"demote">;
+        paths: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        op: "demote";
+        paths: string[];
+    }, {
+        op: "demote";
+        paths: string[];
+    }>]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    prior_run_id: string;
+    ops: ({
+        mode: "full" | "slices" | "codemap_only";
+        op: "add";
+        paths: string[];
+    } | {
+        op: "remove";
+        paths: string[];
+    } | {
+        path: string;
+        op: "set_slices";
+        ranges: {
+            start_line: number;
+            end_line: number;
+        }[];
+    } | {
+        op: "promote";
+        paths: string[];
+    } | {
+        op: "demote";
+        paths: string[];
+    })[];
+    allow_secrets?: boolean | undefined;
+}, {
+    prior_run_id: string;
+    ops: ({
+        op: "add";
+        paths: string[];
+        mode?: "full" | "slices" | "codemap_only" | undefined;
+    } | {
+        op: "remove";
+        paths: string[];
+    } | {
+        path: string;
+        op: "set_slices";
+        ranges: {
+            start_line: number;
+            end_line: number;
+        }[];
+    } | {
+        op: "promote";
+        paths: string[];
+    } | {
+        op: "demote";
+        paths: string[];
+    })[];
+    allow_secrets?: boolean | undefined;
+}>;
+export type RefineContextRunInput = z.infer<typeof RefineContextRunInputSchema>;
+export declare function parseContextBuilderInput(input: unknown): ResolvedContextBuilderInput;
+export declare function normalizeContextBuilderPublicBudget(budget?: ContextBuilderPublicBudgetInput): ContextBuilderPublicBudget;
+export declare function resolveContextBuilderAdapterBudgetInput(args: {
+    adapterDefaults?: ContextBuilderPublicBudgetInput;
+    profile?: ContextBuilderIntentProfile | undefined;
+    explicit?: ContextBuilderPublicBudgetInput;
+}): ContextBuilderPublicBudgetInput;
+export declare function resolveContextBuilderProfileBudget(profile: ContextBuilderIntentProfile | undefined, budget?: ContextBuilderPublicBudgetInput): ContextBuilderPublicBudget;
+export declare function contextBuilderJsonSchema(): Record<string, unknown>;
+export {};