clinkx 0.3.0 → 1.1.0

package/dist/config.js

@@ -1,6 +1,8 @@
 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",
+    "agy_stream_json",
 ]);
 const RoleConfigSchema = z.object({
     inline_prompt: z.string().optional(),
@@ -12,6 +14,63 @@ const ResultContractSchema = z.object({
     enabled: z.boolean().default(false),
     filename: z.enum(["RESULT.md", "RESULT.json"]).default("RESULT.md"),
 });
+const INVOCATION_VALUE_TOKEN = "{value}";
+function refineInvocationTemplate(data, ctx) {
+    const flag = data.args[0];
+    const valueToken = data.args[1];
+    if (flag == null || valueToken == null)
+        return;
+    if (!flag.startsWith("-") || flag.includes(INVOCATION_VALUE_TOKEN)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "invocation template args[0] must be a literal flag token",
+            path: ["args", 0],
+        });
+    }
+    if (valueToken.split(INVOCATION_VALUE_TOKEN).length - 1 !== 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'invocation template args[1] must contain "{value}" exactly once',
+            path: ["args", 1],
+        });
+    }
+}
+const InvocationTemplateBaseSchema = z
+    .object({
+    args: z.array(z.string().min(1)).length(2),
+})
+    .strict();
+const InvocationEffortBaseSchema = InvocationTemplateBaseSchema.extend({
+    allowed_values: z
+        .array(z.string().regex(/^[a-z0-9][a-z0-9_-]*$/))
+        .min(1)
+        .max(16),
+}).strict();
+export const InvocationOverrideTemplateSchema = InvocationTemplateBaseSchema.superRefine(refineInvocationTemplate);
+export const InvocationEffortOverrideSchema = InvocationEffortBaseSchema.superRefine(refineInvocationTemplate);
+export const InvocationOverridesSchema = z
+    .object({
+    model: InvocationOverrideTemplateSchema.optional(),
+    effort: InvocationEffortOverrideSchema.optional(),
+})
+    .strict()
+    .superRefine(({ model, effort }, ctx) => {
+    if (model == null || effort == null || model.args[0] !== effort.args[0])
+        return;
+    const modelValue = model.args[1];
+    const effortValue = effort.args[1];
+    if (modelValue == null || effortValue == null)
+        return;
+    const modelPrefix = modelValue.slice(0, modelValue.indexOf(INVOCATION_VALUE_TOKEN));
+    const effortPrefix = effortValue.slice(0, effortValue.indexOf(INVOCATION_VALUE_TOKEN));
+    if (modelPrefix.startsWith(effortPrefix) || effortPrefix.startsWith(modelPrefix)) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "model and effort templates sharing a flag must have disjoint static value prefixes",
+            path: ["effort", "args"],
+        });
+    }
+});
 /**
  * CLI adapter config schema — defines how ClinkX talks to a particular CLI.
  *
@@ -42,9 +101,38 @@ export const CliAdapterConfigSchema = z.object({
     }),
     prompt_mode: z.enum(["stdin", "arg", "file"]).default("stdin"),
     stdin_placeholder_arg: z.string().min(1).optional(),
+    prompt_file_flag: z.string().min(1).regex(/^-/).optional(),
     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(),
+    invocation_overrides: InvocationOverridesSchema.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 +148,102 @@ 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"],
-            });
+    if (data.prompt_file_flag != null && data.prompt_mode !== "file") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'prompt_file_flag requires prompt_mode: "file"',
+            path: ["prompt_file_flag"],
+        });
+    }
+    if (data.backend === "app_server" && data.invocation_overrides != null) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "invocation_overrides are not supported for backend: app_server",
+            path: ["invocation_overrides"],
+        });
+    }
+    // Override flags must not steal runner-owned delivery/safety tokens.
+    // Matching flags in base args / role extra_args remain legal replacement targets.
+    const invocationOverrides = data.invocation_overrides;
+    if (invocationOverrides != null) {
+        for (const knob of ["model", "effort"]) {
+            const flag = invocationOverrides[knob]?.args[0];
+            if (flag == null)
+                continue;
+            const collidingChannels = [];
+            if (data.unsafe_args.includes(flag))
+                collidingChannels.push("unsafe_args");
+            if (data.prompt_file_flag === flag)
+                collidingChannels.push("prompt_file_flag");
+            if (data.native_output_file_flag === flag) {
+                collidingChannels.push("native_output_file_flag");
+            }
+            if (data.stdin_placeholder_arg === flag) {
+                collidingChannels.push("stdin_placeholder_arg");
+            }
+            for (const channel of collidingChannels) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `invocation override flag collides with ${channel}`,
+                    path: ["invocation_overrides", knob, "args", 0],
+                });
+            }
         }
     }
+    // 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, agy_stream_json)
+ * 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,32 @@ 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;
+    known_missing_evidence?: readonly ContextBuilderKnownMissingEvidence[];
+};
+export type ContextBuilderKnownMissingEvidence = {
+    path: string;
+    provenance: string;
+    reason: string;
 };
 export type ContextBuilderArtifactContents = {
     bundle_md: string;
+    selected_context_jsonl: string;
     tree_json: string;
     search_jsonl: string;
     slices_jsonl: string;
@@ -48,11 +84,19 @@ export type ContextBuilderArtifactContents = {
     summary_json: string;
 };
 export declare function renderContextBuilderBundle(input: ContextBuilderRenderInput): string;
+/**
+ * CommonMark inline code span for arbitrary (single-line) text: the fence is
+ * one backtick longer than the longest backtick run inside, and the content is
+ * space-padded when it starts/ends with a backtick (which would otherwise merge
+ * with the fence) or is space-wrapped (renderers strip one space per side).
+ */
+export declare function markdownCodeSpan(text: string): string;
 export declare function buildContextBuilderStatus(input: {
     metrics: ContextBuilderMetrics;
     internal_caps?: ContextBuilderInternalCaps;
     omissions?: readonly ContextBuilderOmission[];
     warnings?: readonly ContextBuilderWarning[];
+    search_coverage?: ContextBuilderSearchCoverage | undefined;
     status_evidence?: ContextBuilderStatusEvidence | undefined;
     delegate?: ContextBuilderDelegateReceiptMetadata | undefined;
 }): ContextBuilderStatus;
@@ -61,6 +105,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 +118,5 @@ export declare function writeContextBuilderFinalArtifacts(storage: ContextBuilde
     signal?: AbortSignal;
     ownerNonce?: string;
     ops?: ContextBuilderStorageOps;
+    beforeManifestCommit?: () => void | Promise<void>;
 }): Promise<ContextBuilderReceipt>;