clinkx 0.3.0 → 1.0.0

package/dist/config.d.ts

@@ -2,17 +2,17 @@ import { z } from "zod";
 declare const RoleConfigSchema: z.ZodObject<{
     inline_prompt: z.ZodOptional<z.ZodString>;
     prompt_file: z.ZodOptional<z.ZodString>;
-    parser: z.ZodOptional<z.ZodEnum<["text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
+    parser: z.ZodOptional<z.ZodEnum<["text", "json_extract", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
     extra_args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     inline_prompt?: string | undefined;
     prompt_file?: string | undefined;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+    parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     extra_args?: string[] | undefined;
 }, {
     inline_prompt?: string | undefined;
     prompt_file?: string | undefined;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+    parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     extra_args?: string[] | undefined;
 }>;
 export type RoleConfig = z.infer<typeof RoleConfigSchema>;
@@ -34,23 +34,23 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     timeout_seconds: z.ZodDefault<z.ZodNumber>;
     idle_timeout_seconds: z.ZodOptional<z.ZodNumber>;
     idle_timeout_startup_seconds: z.ZodOptional<z.ZodNumber>;
-    parser: z.ZodDefault<z.ZodEnum<["text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
+    parser: z.ZodDefault<z.ZodEnum<["text", "json_extract", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
     tolerate_nonzero_exit_for_parse: z.ZodDefault<z.ZodBoolean>;
     capabilities_hint: z.ZodOptional<z.ZodString>;
     roles: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         inline_prompt: z.ZodOptional<z.ZodString>;
         prompt_file: z.ZodOptional<z.ZodString>;
-        parser: z.ZodOptional<z.ZodEnum<["text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
+        parser: z.ZodOptional<z.ZodEnum<["text", "json_extract", "codex_jsonl", "claude_json", "claude_stream_json"]>>;
         extra_args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }>>>;
     supports_images: z.ZodDefault<z.ZodBoolean>;
@@ -70,20 +70,85 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     native_output_file_flag: z.ZodOptional<z.ZodString>;
     suppress_stdout: z.ZodDefault<z.ZodBoolean>;
     stderr_to_file: z.ZodDefault<z.ZodBoolean>;
+    context_builder: z.ZodOptional<z.ZodObject<{
+        budget_defaults: z.ZodOptional<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;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        budget_defaults?: {
+            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;
+    }, {
+        budget_defaults?: {
+            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;
+    }>>;
+    backend: z.ZodDefault<z.ZodEnum<["subprocess", "app_server"]>>;
+    app_server: z.ZodOptional<z.ZodObject<{
+        command: z.ZodOptional<z.ZodString>;
+        args: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        default_sandbox: z.ZodDefault<z.ZodEnum<["read-only", "workspace-write", "danger-full-access"]>>;
+        default_approval: z.ZodDefault<z.ZodEnum<["untrusted", "on-failure", "on-request", "granular", "never"]>>;
+        default_model: z.ZodOptional<z.ZodString>;
+        allow_danger_full_access: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        args: string[];
+        default_sandbox: "read-only" | "workspace-write" | "danger-full-access";
+        default_approval: "never" | "untrusted" | "on-failure" | "on-request" | "granular";
+        allow_danger_full_access: boolean;
+        command?: string | undefined;
+        default_model?: string | undefined;
+    }, {
+        command?: string | undefined;
+        args?: string[] | undefined;
+        default_sandbox?: "read-only" | "workspace-write" | "danger-full-access" | undefined;
+        default_approval?: "never" | "untrusted" | "on-failure" | "on-request" | "granular" | undefined;
+        default_model?: string | undefined;
+        allow_danger_full_access?: boolean | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
-    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
+    timeout_seconds: number;
     name: string;
+    parser: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     command: string;
     args: string[];
     unsafe_args: string[];
     env: Record<string, string>;
     env_allowlist: string[];
-    timeout_seconds: number;
     tolerate_nonzero_exit_for_parse: boolean;
     roles: Record<string, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }>;
     supports_images: boolean;
@@ -95,22 +160,41 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     prompt_mode: "stdin" | "arg" | "file";
     suppress_stdout: boolean;
     stderr_to_file: boolean;
+    backend: "subprocess" | "app_server";
     runner?: string | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
     capabilities_hint?: string | undefined;
     stdin_placeholder_arg?: string | undefined;
     native_output_file_flag?: string | undefined;
+    context_builder?: {
+        budget_defaults?: {
+            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;
+    } | undefined;
+    app_server?: {
+        args: string[];
+        default_sandbox: "read-only" | "workspace-write" | "danger-full-access";
+        default_approval: "never" | "untrusted" | "on-failure" | "on-request" | "granular";
+        allow_danger_full_access: boolean;
+        command?: string | undefined;
+        default_model?: string | undefined;
+    } | undefined;
 }, {
     name: string;
     command: string;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+    timeout_seconds?: number | undefined;
+    parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     runner?: string | undefined;
     args?: string[] | undefined;
     unsafe_args?: string[] | undefined;
     env?: Record<string, string> | undefined;
     env_allowlist?: string[] | undefined;
-    timeout_seconds?: number | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
     tolerate_nonzero_exit_for_parse?: boolean | undefined;
@@ -118,7 +202,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     roles?: Record<string, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }> | undefined;
     supports_images?: boolean | undefined;
@@ -132,20 +216,39 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     native_output_file_flag?: string | undefined;
     suppress_stdout?: boolean | undefined;
     stderr_to_file?: boolean | undefined;
+    context_builder?: {
+        budget_defaults?: {
+            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;
+    } | undefined;
+    app_server?: {
+        command?: string | undefined;
+        args?: string[] | undefined;
+        default_sandbox?: "read-only" | "workspace-write" | "danger-full-access" | undefined;
+        default_approval?: "never" | "untrusted" | "on-failure" | "on-request" | "granular" | undefined;
+        default_model?: string | undefined;
+        allow_danger_full_access?: boolean | undefined;
+    } | undefined;
+    backend?: "subprocess" | "app_server" | undefined;
 }>, {
-    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
+    timeout_seconds: number;
     name: string;
+    parser: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     command: string;
     args: string[];
     unsafe_args: string[];
     env: Record<string, string>;
     env_allowlist: string[];
-    timeout_seconds: number;
     tolerate_nonzero_exit_for_parse: boolean;
     roles: Record<string, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }>;
     supports_images: boolean;
@@ -157,22 +260,41 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     prompt_mode: "stdin" | "arg" | "file";
     suppress_stdout: boolean;
     stderr_to_file: boolean;
+    backend: "subprocess" | "app_server";
     runner?: string | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
     capabilities_hint?: string | undefined;
     stdin_placeholder_arg?: string | undefined;
     native_output_file_flag?: string | undefined;
+    context_builder?: {
+        budget_defaults?: {
+            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;
+    } | undefined;
+    app_server?: {
+        args: string[];
+        default_sandbox: "read-only" | "workspace-write" | "danger-full-access";
+        default_approval: "never" | "untrusted" | "on-failure" | "on-request" | "granular";
+        allow_danger_full_access: boolean;
+        command?: string | undefined;
+        default_model?: string | undefined;
+    } | undefined;
 }, {
     name: string;
     command: string;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+    timeout_seconds?: number | undefined;
+    parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     runner?: string | undefined;
     args?: string[] | undefined;
     unsafe_args?: string[] | undefined;
     env?: Record<string, string> | undefined;
     env_allowlist?: string[] | undefined;
-    timeout_seconds?: number | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
     tolerate_nonzero_exit_for_parse?: boolean | undefined;
@@ -180,7 +302,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     roles?: Record<string, {
         inline_prompt?: string | undefined;
         prompt_file?: string | undefined;
-        parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
+        parser?: "text" | "json_extract" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
         extra_args?: string[] | undefined;
     }> | undefined;
     supports_images?: boolean | undefined;
@@ -194,6 +316,50 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     native_output_file_flag?: string | undefined;
     suppress_stdout?: boolean | undefined;
     stderr_to_file?: boolean | undefined;
+    context_builder?: {
+        budget_defaults?: {
+            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;
+    } | undefined;
+    app_server?: {
+        command?: string | undefined;
+        args?: string[] | undefined;
+        default_sandbox?: "read-only" | "workspace-write" | "danger-full-access" | undefined;
+        default_approval?: "never" | "untrusted" | "on-failure" | "on-request" | "granular" | undefined;
+        default_model?: string | undefined;
+        allow_danger_full_access?: boolean | undefined;
+    } | undefined;
+    backend?: "subprocess" | "app_server" | undefined;
 }>;
 export type CliAdapterConfig = z.infer<typeof CliAdapterConfigSchema>;
+/**
+ * Master opt-in for the Codex app-server backend & async tools (4-7).
+ * Default OFF: app_server adapters are hidden from the `clink` cli_name enum,
+ * the async tools are not advertised, and explicit app_server dispatch is
+ * rejected with -32602 rather than silently falling back to the subprocess path.
+ */
+export declare function appServerEnabled(): boolean;
+/**
+ * Master opt-in for the Elaris remote agent-session HTTP tools.
+ * Default OFF: Elaris tools are hidden from advertisement/integration until
+ * server wiring enables them and explicit calls are rejected by the caller.
+ */
+export declare function elarisEnabled(): boolean;
+export declare const DIRECT_SESSION_LOGS_ENABLED_ENV = "CLINKX_DIRECT_SESSION_LOGS_ENABLED";
+/**
+ * Master opt-OUT for synthesizing an activity-family SessionLogOwnerV1 on direct
+ * `clink` calls that did not supply one. Default ON: single-run session logs for
+ * structured-parser providers (claude_stream_json, codex_jsonl) are retained and
+ * surface in the dashboard "Single calls" list. Set to "false" to opt out — runs
+ * then show "This session log was not retained." as before.
+ *
+ * Workflow/context paths and any caller that supplies its own sessionLogOwner are
+ * unaffected; this gate only governs the synthesized owner for one-shot clink runs.
+ */
+export declare function directSessionLogsEnabled(): boolean;
 export {};

package/dist/config.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
+import { ContextBuilderAdapterBudgetDefaultsSchema } from "./context-builder/schema.js";
 const ParserNameSchema = z.enum([
-    "text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json",
+    "text", "json_extract", "codex_jsonl", "claude_json", "claude_stream_json",
 ]);
 const RoleConfigSchema = z.object({
     inline_prompt: z.string().optional(),
@@ -45,6 +46,33 @@ export const CliAdapterConfigSchema = z.object({
     native_output_file_flag: z.string().min(1).optional(),
     suppress_stdout: z.boolean().default(false),
     stderr_to_file: z.boolean().default(false),
+    context_builder: z
+        .object({
+        budget_defaults: ContextBuilderAdapterBudgetDefaultsSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    // Codex app-server backend (opt-in). "subprocess" is the default one-shot
+    // `codex exec` path; "app_server" routes through the long-lived
+    // CodexAppServerClient/AppServerRegistry. New fields must live in this inner
+    // z.object BEFORE the superRefine (the wrapper is a ZodEffects and cannot be
+    // .extend()-ed). See docs/CODEX-APP-SERVER-PLAN.md task 3-5.
+    backend: z.enum(["subprocess", "app_server"]).default("subprocess"),
+    app_server: z
+        .object({
+        command: z.string().min(1).optional(), // defaults to top-level `command`
+        args: z.array(z.string()).default(["app-server"]),
+        default_sandbox: z
+            .enum(["read-only", "workspace-write", "danger-full-access"])
+            .default("read-only"),
+        default_approval: z
+            .enum(["untrusted", "on-failure", "on-request", "granular", "never"])
+            .default("never"),
+        default_model: z.string().optional(),
+        // Explicit opt-in gate for danger-full-access (config + per-call clamp).
+        allow_danger_full_access: z.boolean().default(false),
+    })
+        .optional(),
 }).superRefine((data, ctx) => {
     if (data.suppress_stdout && !data.native_output_file_flag) {
         ctx.addIssue({
@@ -60,21 +88,59 @@ export const CliAdapterConfigSchema = z.object({
             path: ["native_output_file_flag"],
         });
     }
-    if (data.stderr_to_file) {
-        if ((data.idle_timeout_seconds ?? 0) > 0) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                message: "stderr_to_file is incompatible with idle_timeout_seconds > 0 (stderr data events are needed for idle detection)",
-                path: ["stderr_to_file"],
-            });
-        }
-        if ((data.idle_timeout_startup_seconds ?? 0) > 0) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                message: "stderr_to_file is incompatible with idle_timeout_startup_seconds > 0 (stderr data events are needed for idle detection)",
-                path: ["stderr_to_file"],
-            });
-        }
+    // App-server guards (3-5). The superRefine sees CONFIG only — the per-call
+    // narrow-only privilege clamp (decision 3) is enforced in the async tool
+    // handlers, since the frozen `clink` schema cannot express per-call
+    // sandbox/approval and superRefine never sees per-call params.
+    if (data.app_server != null && data.backend !== "app_server") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'app_server block requires backend: "app_server"',
+            path: ["app_server"],
+        });
+    }
+    if (data.app_server?.default_sandbox === "danger-full-access" &&
+        !data.app_server.allow_danger_full_access) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'app_server.default_sandbox "danger-full-access" requires app_server.allow_danger_full_access: true',
+            path: ["app_server", "default_sandbox"],
+        });
     }
 });
+/**
+ * Master opt-in for the Codex app-server backend & async tools (4-7).
+ * Default OFF: app_server adapters are hidden from the `clink` cli_name enum,
+ * the async tools are not advertised, and explicit app_server dispatch is
+ * rejected with -32602 rather than silently falling back to the subprocess path.
+ */
+export function appServerEnabled() {
+    return process.env["CLINKX_APP_SERVER_ENABLED"] === "true";
+}
+/**
+ * Master opt-in for the Elaris remote agent-session HTTP tools.
+ * Default OFF: Elaris tools are hidden from advertisement/integration until
+ * server wiring enables them and explicit calls are rejected by the caller.
+ */
+export function elarisEnabled() {
+    return process.env["CLINKX_ELARIS_ENABLED"] === "true";
+}
+export const DIRECT_SESSION_LOGS_ENABLED_ENV = "CLINKX_DIRECT_SESSION_LOGS_ENABLED";
+/**
+ * Master opt-OUT for synthesizing an activity-family SessionLogOwnerV1 on direct
+ * `clink` calls that did not supply one. Default ON: single-run session logs for
+ * structured-parser providers (claude_stream_json, codex_jsonl) are retained and
+ * surface in the dashboard "Single calls" list. Set to "false" to opt out — runs
+ * then show "This session log was not retained." as before.
+ *
+ * Workflow/context paths and any caller that supplies its own sessionLogOwner are
+ * unaffected; this gate only governs the synthesized owner for one-shot clink runs.
+ */
+export function directSessionLogsEnabled() {
+    const raw = process.env[DIRECT_SESSION_LOGS_ENABLED_ENV];
+    if (raw == null || raw.trim() === "") {
+        return true;
+    }
+    return raw.trim().toLowerCase() !== "false";
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

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

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

@@ -6,6 +6,7 @@ export type ContextBuilderAnchorInput = {
     focus_paths: ResolvedContextBuilderFocusPath[];
     include_globs: string[];
     search_terms: string[];
+    allowRootWideDiscovery?: boolean;
 };
 export declare function assertContextBuilderAnchorSufficiency(input: ContextBuilderAnchorInput): void;
 export declare function hasBoundedFocusPath(focusPaths: ResolvedContextBuilderFocusPath[]): boolean;

package/dist/context-builder/anchors.js

@@ -6,6 +6,9 @@ export function assertContextBuilderAnchorSufficiency(input) {
     if (input.search_terms.some((term) => term.trim().length > 0)) {
         return;
     }
+    if (input.allowRootWideDiscovery === true) {
+        return;
+    }
     throw new InvalidParamsError("context_builder requires at least one bounded focus_paths entry or nonblank search_terms entry; include_globs may narrow scanning but does not select context alone");
 }
 export function hasBoundedFocusPath(focusPaths) {

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

@@ -1 +1 @@
-{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../src/context-builder/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAalD,MAAM,UAAU,qCAAqC,CACnD,KAAgC;IAEhC,IAAI,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,MAAM,IAAI,kBAAkB,CAC1B,qKAAqK,CACtK,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAA6C;IAE7C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,MAAM,UAAU,GAAG,SAAS,CAAC,kBAAkB;aAC5C,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,UAAU,KAAK,EAAE,IAAI,UAAU,KAAK,GAAG,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../src/context-builder/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAclD,MAAM,UAAU,qCAAqC,CACnD,KAAgC;IAEhC,IAAI,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,MAAM,IAAI,kBAAkB,CAC1B,qKAAqK,CACtK,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAA6C;IAE7C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,MAAM,UAAU,GAAG,SAAS,CAAC,kBAAkB;aAC5C,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,UAAU,KAAK,EAAE,IAAI,UAAU,KAAK,GAAG,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,11 +1,14 @@
 import { type ContextBuilderOmission, type ContextBuilderWarning } from "./diagnostics.js";
-import type { ContextBuilderSearchRecord, ContextBuilderSliceRecord, ContextBuilderTreeFile } from "./discovery.js";
+import type { ContextBuilderSearchCoverage, ContextBuilderSearchRecord, ContextBuilderSliceRecord, ContextBuilderTreeFile } from "./discovery.js";
+import type { ContextBuilderDelegatePacketCompactionMetrics } from "./delegate-packet.js";
 import { type ContextBuilderDelegateReceiptMetadata, type ContextBuilderMetrics, type ContextBuilderReceipt, type ContextBuilderStatus } from "./receipt.js";
-import type { ContextBuilderPublicBudget } from "./schema.js";
+import type { ContextBuilderPublicBudget, RefineOp } from "./schema.js";
+import type { ContextCoverageReport } from "./review-coverage.js";
 import type { ContextBuilderSelectedFile } from "./selection.js";
 import { type ContextBuilderStatusEvidence } from "./status.js";
 import { type ContextBuilderManifestDraft, type ContextBuilderStorageOps, type ContextBuilderStoragePaths } from "./storage.js";
 import { type ContextBuilderInternalCaps } from "./config.js";
+export declare const CONTEXT_BUILDER_RENDERER_VERSION = 2;
 export type ContextBuilderBundleRoot = {
     root_index: number;
     input_path?: string;
@@ -18,10 +21,25 @@ export type ContextBuilderDebugDiagnostics = {
     notes?: readonly string[];
     counters?: Readonly<Record<string, number | string | boolean>>;
 };
+export type ContextBuilderObservabilityMetrics = {
+    curator_ms: number | null;
+    finalizer_ms: number | null;
+    candidate_pool_size: number;
+    /**
+     * @deprecated Misleading name kept for wire compatibility: the value is the
+     * delegate packet's ESTIMATED TOKEN count (`packet.metrics.packet_estimated_tokens`),
+     * not a byte size. Always equals `delegate_packet_estimated_tokens`; prefer
+     * that field for new readers.
+     */
+    delegate_packet_size: number;
+    delegate_packet_estimated_tokens: number;
+    delegate_packet_compaction?: ContextBuilderDelegatePacketCompactionMetrics;
+};
 export type ContextBuilderRenderInput = {
     run_id: string;
     created_at: string;
     task: string;
+    allowSecrets?: boolean;
     roots: readonly ContextBuilderBundleRoot[];
     inputs: Record<string, unknown>;
     budget: ContextBuilderPublicBudget;
@@ -33,14 +51,26 @@ export type ContextBuilderRenderInput = {
     omissions?: readonly ContextBuilderOmission[];
     warnings?: readonly ContextBuilderWarning[];
     metrics: ContextBuilderMetrics;
+    search_coverage?: ContextBuilderSearchCoverage;
     open_questions?: readonly (string | ContextBuilderOpenQuestion)[];
     status_evidence?: ContextBuilderStatusEvidence;
+    coverage?: ContextCoverageReport;
     delegate?: ContextBuilderDelegateReceiptMetadata;
+    observability?: ContextBuilderObservabilityMetrics;
+    parent_run_id?: string;
+    refine_ops?: readonly RefineOp[];
+    file_fingerprints?: readonly {
+        root_index: number;
+        path: string;
+        sha256: string;
+        byte_length: number;
+    }[];
     debug?: boolean;
     debug_diagnostics?: ContextBuilderDebugDiagnostics;
 };
 export type ContextBuilderArtifactContents = {
     bundle_md: string;
+    selected_context_jsonl: string;
     tree_json: string;
     search_jsonl: string;
     slices_jsonl: string;
@@ -53,6 +83,7 @@ export declare function buildContextBuilderStatus(input: {
     internal_caps?: ContextBuilderInternalCaps;
     omissions?: readonly ContextBuilderOmission[];
     warnings?: readonly ContextBuilderWarning[];
+    search_coverage?: ContextBuilderSearchCoverage | undefined;
     status_evidence?: ContextBuilderStatusEvidence | undefined;
     delegate?: ContextBuilderDelegateReceiptMetadata | undefined;
 }): ContextBuilderStatus;
@@ -61,6 +92,7 @@ export declare function buildContextBuilderStatusEvidence(input: {
     internal_caps?: ContextBuilderInternalCaps;
     omissions?: readonly ContextBuilderOmission[];
     warnings?: readonly ContextBuilderWarning[];
+    search_coverage?: ContextBuilderSearchCoverage | undefined;
     status_evidence?: ContextBuilderStatusEvidence | undefined;
     delegate?: ContextBuilderDelegateReceiptMetadata | undefined;
 }, boundedDiagnostics?: {
@@ -73,4 +105,5 @@ export declare function writeContextBuilderFinalArtifacts(storage: ContextBuilde
     signal?: AbortSignal;
     ownerNonce?: string;
     ops?: ContextBuilderStorageOps;
+    beforeManifestCommit?: () => void | Promise<void>;
 }): Promise<ContextBuilderReceipt>;