clinkx 0.3.0 → 1.1.0

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

@@ -31,6 +31,7 @@ export declare const CONTEXT_BUILDER_DELEGATE_DEFAULTS: Readonly<{
     readonly timeout_seconds: 120;
     readonly max_response_chars: 20000;
     readonly failure_policy: "fallback";
+    readonly external_gap_policy: "fail";
     readonly finalizer_min_score: 8.5;
 }>;
 export declare const CONTEXT_BUILDER_DELEGATE_HARD_LIMITS: Readonly<{
@@ -92,19 +93,49 @@ export declare const CONTEXT_BUILDER_INTENT_PROFILE_DEFAULTS: Readonly<{
         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;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
 }, {
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
 }>;
 declare const DelegateFinalizerConfigSchema: z.ZodObject<{
     cli_name: z.ZodString;
     role: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
 } & {
     enabled: z.ZodOptional<z.ZodBoolean>;
     min_score: z.ZodDefault<z.ZodNumber>;
@@ -112,10 +143,14 @@ declare const DelegateFinalizerConfigSchema: z.ZodObject<{
     cli_name: string;
     role: string;
     min_score: number;
+    model?: string | undefined;
+    effort?: string | undefined;
     enabled?: boolean | undefined;
 }, {
     cli_name: string;
     role: string;
+    model?: string | undefined;
+    effort?: string | undefined;
     enabled?: boolean | undefined;
     min_score?: number | undefined;
 }>;
@@ -131,16 +166,24 @@ declare const EnabledDelegateSchema: z.ZodObject<{
     curator: z.ZodObject<{
         cli_name: z.ZodString;
         role: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
     }, {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
     }>;
     finalizer: z.ZodObject<{
         cli_name: z.ZodString;
         role: z.ZodString;
+        model: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
     } & {
         enabled: z.ZodOptional<z.ZodBoolean>;
         min_score: z.ZodDefault<z.ZodNumber>;
@@ -148,53 +191,69 @@ declare const EnabledDelegateSchema: z.ZodObject<{
         cli_name: string;
         role: string;
         min_score: number;
+        model?: string | undefined;
+        effort?: string | undefined;
         enabled?: boolean | undefined;
     }, {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         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"]>>;
+    external_gap_policy: z.ZodOptional<z.ZodEnum<["fail", "degrade"]>>;
 }, "strict", z.ZodTypeAny, {
     enabled: true;
     curator: {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
     };
     finalizer: {
         cli_name: string;
         role: string;
         min_score: number;
+        model?: string | undefined;
+        effort?: string | undefined;
         enabled?: boolean | undefined;
     };
     timeout_seconds?: number | undefined;
     max_response_chars?: number | undefined;
     failure_policy?: "fallback" | "fail" | undefined;
+    external_gap_policy?: "fail" | "degrade" | undefined;
 }, {
     enabled: true;
     curator: {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
     };
     finalizer: {
         cli_name: string;
         role: string;
+        model?: string | undefined;
+        effort?: string | undefined;
         enabled?: boolean | undefined;
         min_score?: number | undefined;
     };
     timeout_seconds?: number | undefined;
     max_response_chars?: number | undefined;
     failure_policy?: "fallback" | "fail" | undefined;
+    external_gap_policy?: "fail" | "degrade" | 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"> & {
+export type ContextBuilderEnabledDelegateConfig = Omit<z.infer<typeof EnabledDelegateSchema>, "timeout_seconds" | "max_response_chars" | "failure_policy" | "external_gap_policy"> & {
     timeout_seconds: number;
     max_response_chars: number;
     failure_policy: "fallback" | "fail";
+    external_gap_policy: "fail" | "degrade";
 };
 export type ContextBuilderDelegateConfig = ContextBuilderEnabledDelegateConfig | z.infer<typeof DisabledDelegateSchema>;
 /**
@@ -203,6 +262,7 @@ export type ContextBuilderDelegateConfig = ContextBuilderEnabledDelegateConfig |
  */
 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">>;
@@ -236,16 +296,24 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
         curator: z.ZodObject<{
             cli_name: z.ZodString;
             role: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         }, {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         }>;
         finalizer: z.ZodObject<{
             cli_name: z.ZodString;
             role: z.ZodString;
+            model: z.ZodOptional<z.ZodString>;
+            effort: z.ZodOptional<z.ZodString>;
         } & {
             enabled: z.ZodOptional<z.ZodBoolean>;
             min_score: z.ZodDefault<z.ZodNumber>;
@@ -253,46 +321,61 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
             cli_name: string;
             role: string;
             min_score: number;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
         }, {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             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"]>>;
+        external_gap_policy: z.ZodOptional<z.ZodEnum<["fail", "degrade"]>>;
     }, "strict", z.ZodTypeAny, {
         enabled: true;
         curator: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         };
         finalizer: {
             cli_name: string;
             role: string;
             min_score: number;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
         };
         timeout_seconds?: number | undefined;
         max_response_chars?: number | undefined;
         failure_policy?: "fallback" | "fail" | undefined;
+        external_gap_policy?: "fail" | "degrade" | undefined;
     }, {
         enabled: true;
         curator: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         };
         finalizer: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
             min_score?: number | undefined;
         };
         timeout_seconds?: number | undefined;
         max_response_chars?: number | undefined;
         failure_policy?: "fallback" | "fail" | undefined;
+        external_gap_policy?: "fail" | "degrade" | undefined;
     }>, z.ZodObject<{
         enabled: z.ZodDefault<z.ZodLiteral<false>>;
     }, "strict", z.ZodTypeAny, {
@@ -324,23 +407,30 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
         curator: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         };
         finalizer: {
             cli_name: string;
             role: string;
             min_score: number;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
         };
         timeout_seconds?: number | undefined;
         max_response_chars?: number | undefined;
         failure_policy?: "fallback" | "fail" | undefined;
+        external_gap_policy?: "fail" | "degrade" | 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;
@@ -362,16 +452,21 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
         curator: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         };
         finalizer: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
             min_score?: number | undefined;
         };
         timeout_seconds?: number | undefined;
         max_response_chars?: number | undefined;
         failure_policy?: "fallback" | "fail" | undefined;
+        external_gap_policy?: "fail" | "degrade" | undefined;
     } | undefined;
     run_id?: string | undefined;
 }>, {
@@ -384,11 +479,13 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
     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;
@@ -410,22 +507,238 @@ export declare const ContextBuilderInputSchema: z.ZodEffects<z.ZodObject<{
         curator: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
         };
         finalizer: {
             cli_name: string;
             role: string;
+            model?: string | undefined;
+            effort?: string | undefined;
             enabled?: boolean | undefined;
             min_score?: number | undefined;
         };
         timeout_seconds?: number | undefined;
         max_response_chars?: number | undefined;
         failure_policy?: "fallback" | "fail" | undefined;
+        external_gap_policy?: "fail" | "degrade" | undefined;
     } | undefined;
     run_id?: string | undefined;
 }>;
 export type ContextBuilderInput = z.infer<typeof ContextBuilderInputSchema>;
-export declare function parseContextBuilderInput(input: unknown): ContextBuilderInput;
+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 {};