clinkx 0.2.3 → 0.3.0

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

@@ -0,0 +1,431 @@
+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;
+    };
+}>;
+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;
+    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;
+    };
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    roots?: string[] | undefined;
+    run_id?: string | undefined;
+}, {
+    task: string;
+    debug?: 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[];
+    profile?: "handoff_small" | "implementation_medium" | "review_deep" | undefined;
+    run_id?: string | undefined;
+}, {
+    task: string;
+    debug?: 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 declare function parseContextBuilderInput(input: unknown): ContextBuilderInput;
+export declare function normalizeContextBuilderPublicBudget(budget?: ContextBuilderPublicBudgetInput): ContextBuilderPublicBudget;
+export declare function resolveContextBuilderProfileBudget(profile: ContextBuilderIntentProfile | undefined, budget?: ContextBuilderPublicBudgetInput): ContextBuilderPublicBudget;
+export declare function contextBuilderJsonSchema(): Record<string, unknown>;
+export {};