clinkx 0.3.0 → 1.0.0

package/dist/context-builder/lifecycle-reconcile.js

@@ -0,0 +1,191 @@
+import { randomBytes } from "node:crypto";
+import { hostname as osHostname } from "node:os";
+import { readdir as fsReaddir, readFile as fsReadFile } from "node:fs/promises";
+import { open as fsOpen, rename as fsRename, rm as fsRm, } from "node:fs/promises";
+import { join } from "node:path";
+import { logger } from "../logger.js";
+import { CONTEXT_BUILDER_LIFECYCLE_DIRECTORY, MAX_CONTEXT_BUILDER_LIFECYCLE_DURATION_MS, isContextBuilderOperationId, isLegalContextBuilderLifecycleTransition, isTerminalContextBuilderLifecycleStatus, parseContextBuilderLifecycleStateV1, resolveContextBuilderLifecycleLocation, } from "./lifecycle-contract.js";
+import { resolveContextBuilderRunsDir } from "./config.js";
+import { cleanupContextBuilderIncompleteRun, resolveContextBuilderRunPaths, } from "./storage.js";
+/**
+ * Terminalize standalone/refine journals frozen as pending/running whose
+ * same-host `.building.json` pid is dead. Foreign-host and missing/unparseable
+ * pid evidence is `unknown` and is never touched — same asymmetry as workflow
+ * `reconcileStaleRunDirectories`. Does not invent a dedicated worker lock;
+ * liveness is the building-json pid probe only.
+ *
+ * Writes `failed`/`terminal` + `internal_failure`. Never `cancelled`. Never
+ * rewrites curator/finalizer outcomes. Best-effort incomplete-artifact cleanup
+ * after the journal write. Idempotent. Log-and-continue on malformed rows.
+ */
+export async function reconcileStaleContextBuilderJournals(options = {}) {
+    const runsDir = await resolveContextBuilderRunsDir(options.runsDir);
+    const now = options.now ?? (() => new Date());
+    const hostname = options.hostname ?? osHostname();
+    const isAlive = options.isProcessAlive ?? isProcessAlive;
+    const journalDir = join(runsDir, CONTEXT_BUILDER_LIFECYCLE_DIRECTORY);
+    let entries = [];
+    try {
+        entries = await fsReaddir(journalDir);
+    }
+    catch {
+        return { scanned: 0, reconciled: 0, skipped: 0, failed: 0 };
+    }
+    let scanned = 0;
+    let reconciled = 0;
+    let skipped = 0;
+    let failed = 0;
+    for (const name of entries) {
+        if (!isContextBuilderOperationId(name))
+            continue;
+        scanned += 1;
+        try {
+            const location = resolveContextBuilderLifecycleLocation(runsDir, name);
+            const raw = await fsReadFile(location.state_json, "utf8");
+            const previous = parseContextBuilderLifecycleStateV1(JSON.parse(raw));
+            if (isTerminalContextBuilderLifecycleStatus(previous.status)) {
+                skipped += 1;
+                continue;
+            }
+            const observation = await observeContextRunWorker({
+                runsDir,
+                state: previous,
+                hostname,
+                isProcessAlive: isAlive,
+            });
+            if (observation !== "dead") {
+                skipped += 1;
+                continue;
+            }
+            const next = buildReconciledFailureSnapshot(previous, now());
+            if (!isLegalContextBuilderLifecycleTransition(previous, next)) {
+                logger.warn({ contextRunId: name }, "stale context run reconcile produced an illegal transition");
+                failed += 1;
+                continue;
+            }
+            await writeAtomicLifecycleSnapshot(location.state_json, next);
+            reconciled += 1;
+            await cleanupReconciledArtifact(runsDir, previous).catch((error) => {
+                logger.warn({
+                    contextRunId: name,
+                    err: error instanceof Error ? error.message : String(error),
+                }, "stale context run artifact cleanup failed");
+            });
+        }
+        catch (error) {
+            failed += 1;
+            logger.warn({
+                contextRunId: name,
+                err: error instanceof Error ? error.message : String(error),
+            }, "stale context run reconcile skipped a malformed journal");
+        }
+    }
+    return { scanned, reconciled, skipped, failed };
+}
+export async function observeContextRunWorker(input) {
+    const artifactRunId = input.state.artifact_run_id;
+    if (artifactRunId == null)
+        return "unknown";
+    let buildingRaw;
+    try {
+        const paths = resolveContextBuilderRunPaths(input.runsDir, artifactRunId);
+        buildingRaw = await fsReadFile(paths.buildingJson, "utf8");
+    }
+    catch {
+        return "unknown";
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(buildingRaw);
+    }
+    catch {
+        return "unknown";
+    }
+    if (parsed === null || typeof parsed !== "object")
+        return "unknown";
+    const building = parsed;
+    if (typeof building.hostname !== "string" || typeof building.pid !== "number") {
+        return "unknown";
+    }
+    if (!Number.isInteger(building.pid) || building.pid <= 0)
+        return "unknown";
+    if (building.hostname !== input.hostname)
+        return "unknown";
+    return input.isProcessAlive(building.pid) ? "live" : "dead";
+}
+function buildReconciledFailureSnapshot(previous, now) {
+    const completedAt = monotonicTimestamp(now.toISOString(), previous.updated_at);
+    return parseContextBuilderLifecycleStateV1({
+        ...previous,
+        status: "failed",
+        phase: "terminal",
+        updated_at: completedAt,
+        completed_at: completedAt,
+        duration_ms: boundedDuration(previous.created_at, completedAt),
+        reason_codes: [...new Set([...previous.reason_codes, "internal_failure"])],
+    });
+}
+async function cleanupReconciledArtifact(runsDir, state) {
+    const artifactRunId = state.artifact_run_id;
+    if (artifactRunId == null)
+        return;
+    const paths = resolveContextBuilderRunPaths(runsDir, artifactRunId);
+    let ownerNonce;
+    try {
+        const parsed = JSON.parse(await fsReadFile(paths.buildingJson, "utf8"));
+        if (parsed !== null &&
+            typeof parsed === "object" &&
+            typeof parsed.owner_nonce === "string") {
+            ownerNonce = parsed.owner_nonce;
+        }
+    }
+    catch {
+        return;
+    }
+    if (ownerNonce == null)
+        return;
+    await cleanupContextBuilderIncompleteRun(paths, ownerNonce);
+}
+async function writeAtomicLifecycleSnapshot(finalPath, snapshot) {
+    const tempPath = `${finalPath}.${randomBytes(8).toString("hex")}.tmp`;
+    let handle;
+    let renamed = false;
+    try {
+        handle = await fsOpen(tempPath, "wx", 0o600);
+        await handle.writeFile(`${JSON.stringify(snapshot)}\n`, { encoding: "utf8" });
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await fsRename(tempPath, finalPath);
+        renamed = true;
+    }
+    finally {
+        if (handle !== undefined) {
+            await handle.close().catch(() => { });
+        }
+        if (!renamed) {
+            await fsRm(tempPath, { force: true }).catch(() => { });
+        }
+    }
+}
+function monotonicTimestamp(candidate, floor) {
+    return Date.parse(candidate) < Date.parse(floor) ? floor : candidate;
+}
+function boundedDuration(createdAt, completedAt) {
+    return Math.min(MAX_CONTEXT_BUILDER_LIFECYCLE_DURATION_MS, Math.max(0, Date.parse(completedAt) - Date.parse(createdAt)));
+}
+function isProcessAlive(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !(typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "ESRCH");
+    }
+}
+//# sourceMappingURL=lifecycle-reconcile.js.map

package/dist/context-builder/lifecycle-reconcile.js.map

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

package/dist/context-builder/lifecycle-recovery.d.ts

@@ -0,0 +1,2 @@
+import type { ContextBuilderReceipt } from "./receipt.js";
+export declare function appendLifecycleCompletionWarning(receipt: ContextBuilderReceipt, maxWarnings: number): ContextBuilderReceipt;

package/dist/context-builder/lifecycle-recovery.js

@@ -0,0 +1,14 @@
+export function appendLifecycleCompletionWarning(receipt, maxWarnings) {
+    const warning = {
+        code: "lifecycle_completion_unavailable",
+        message: "Context Run completion could not be persisted after two attempts.",
+    };
+    return {
+        ...receipt,
+        warnings: [
+            ...receipt.warnings.slice(0, Math.max(0, maxWarnings - 1)),
+            warning,
+        ],
+    };
+}
+//# sourceMappingURL=lifecycle-recovery.js.map

package/dist/context-builder/lifecycle-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-recovery.js","sourceRoot":"","sources":["../../src/context-builder/lifecycle-recovery.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gCAAgC,CAC9C,OAA8B,EAC9B,WAAmB;IAEnB,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,mEAAmE;KAC7E,CAAC;IACF,OAAO;QACL,GAAG,OAAO;QACV,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;YAC1D,OAAO;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/context-builder/path-signals.js

@@ -3,12 +3,16 @@
 // helpers previously had divergent copies in both modules; unify here so the
 // two can never silently re-diverge.
 export function isTestPath(relativePath) {
-    return (relativePath.startsWith("test/") ||
-        relativePath.startsWith("tests/") ||
-        relativePath.startsWith("frontend/tests/") ||
-        relativePath.startsWith("backend/tests/") ||
-        relativePath.includes("/__tests__/") ||
+    return (
+    // A `test/` or `tests/` path SEGMENT anywhere (leading or nested) — e.g.
+    // `tests/foo`, `pkg/test/bar`, `<anyrepo>/tests/baz`. Repo-agnostic: no
+    // hardcoded top-level prefixes tied to a particular project layout.
+    /(?:^|\/)tests?\//.test(relativePath) ||
+        // A `__tests__/` directory segment anywhere (leading or nested).
+        /(?:^|\/)__tests__\//.test(relativePath) ||
+        // `.test.`/`.spec.` JS/TS filename suffix.
         /\.(?:test|spec)\.[cm]?[jt]sx?$/.test(relativePath) ||
+        // Python `test_*.py` filename.
         /(?:^|\/)test_[^/]+\.py$/.test(relativePath));
 }
 export function isGenericConfigPath(relativePath) {

package/dist/context-builder/path-signals.js.map

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

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

@@ -1,4 +1,5 @@
 import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ContextBuilderLifecycleObserver } from "./lifecycle-observer.js";
 export type ContextBuilderProgressStage = "validating" | "scanning" | "searching" | "selecting" | "curating" | "finalizing" | "writing" | "complete";
 export type ContextBuilderProgressTarget = {
     server: Server;
@@ -9,7 +10,8 @@ export declare class ContextBuilderProgressReporter {
     private highestEmitted;
     private chain;
     constructor(target: ContextBuilderProgressTarget);
-    emit(stage: ContextBuilderProgressStage): Promise<void>;
+    observe: ContextBuilderLifecycleObserver;
+    private emit;
     private emitNow;
 }
 export declare function createContextBuilderProgressReporter(target: ContextBuilderProgressTarget | undefined): ContextBuilderProgressReporter | undefined;

package/dist/context-builder/progress.js

@@ -37,6 +37,10 @@ export class ContextBuilderProgressReporter {
     constructor(target) {
         this.target = target;
     }
+    observe = (transition) => {
+        const stage = progressStageForTransition(transition);
+        return stage == null ? Promise.resolve() : this.emit(stage);
+    };
     emit(stage) {
         const next = this.chain.then(() => this.emitNow(stage));
         this.chain = next.catch(() => { });
@@ -64,6 +68,25 @@ export class ContextBuilderProgressReporter {
         }
     }
 }
+function progressStageForTransition(transition) {
+    switch (transition.snapshot.phase) {
+        case "validating":
+        case "scanning":
+        case "searching":
+        case "selecting":
+        case "curating":
+        case "finalizing":
+        case "writing":
+        case "complete":
+            return transition.snapshot.phase;
+        case "resolving":
+        case "cache_lookup":
+        case "materializing":
+        case "committing":
+        case "terminal":
+            return undefined;
+    }
+}
 export function createContextBuilderProgressReporter(target) {
     return target == null ? undefined : new ContextBuilderProgressReporter(target);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/context-builder/progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAiB3D,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,GAAG;CACwC,CAAC,CAAC;AAEzD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;CAC0C,CAAC,CAAC;AAEzD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,UAAU,EAAE,4BAA4B;IACxC,QAAQ,EAAE,0BAA0B;IACpC,SAAS,EAAE,2BAA2B;IACtC,SAAS,EAAE,2BAA2B;IACtC,QAAQ,EAAE,0BAA0B;IACpC,UAAU,EAAE,4BAA4B;IACxC,OAAO,EAAE,yBAAyB;IAClC,QAAQ,EAAE,0BAA0B;CACiB,CAAC,CAAC;AAEzD,MAAM,OAAO,8BAA8B;IAIZ;IAHrB,cAAc,GAAG,CAAC,CAAC,CAAC;IACpB,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEjD,YAA6B,MAAoC;QAApC,WAAM,GAAN,MAAM,CAA8B;IAAG,CAAC;IAErE,IAAI,CAAC,KAAkC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAkC;QACtD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;gBACpC,MAAM,EAAE,wBAAwB;gBAChC,MAAM,EAAE;oBACN,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;oBAChC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC/B,KAAK,EAAE,GAAG;oBACV,OAAO,EAAE,uBAAuB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;iBACxD;aACF,CAAC,CAAC;YACH,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,yCAAyC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,oCAAoC,CAClD,MAAgD;IAEhD,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/context-builder/progress.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,11 @@
 export declare const CONTEXT_BUILDER_NO_DELEGATE_SCHEMA_VERSION = 1;
 export declare const CONTEXT_BUILDER_DELEGATE_SCHEMA_VERSION = 2;
 export declare const CONTEXT_BUILDER_SCHEMA_VERSION = 1;
-export declare const CONTEXT_BUILDER_NO_DELEGATE_ARTIFACT_KEYS: readonly ["manifest_json", "bundle_md", "tree_json", "search_jsonl", "slices_jsonl", "codemap_jsonl", "summary_json"];
+export declare const CONTEXT_BUILDER_NO_DELEGATE_ARTIFACT_KEYS: readonly ["manifest_json", "bundle_md", "selected_context_jsonl", "tree_json", "search_jsonl", "slices_jsonl", "codemap_jsonl", "summary_json"];
 export type ContextBuilderArtifactKey = (typeof CONTEXT_BUILDER_NO_DELEGATE_ARTIFACT_KEYS)[number];
-export declare const CONTEXT_BUILDER_ATTACHABLE_ARTIFACT_KEYS: readonly ["bundle_md", "manifest_json"];
+export declare const CONTEXT_BUILDER_LEGACY_ARTIFACT_KEYS: readonly ["manifest_json", "bundle_md", "tree_json", "search_jsonl", "slices_jsonl", "codemap_jsonl", "summary_json"];
+export type ContextBuilderArtifactMap = Record<(typeof CONTEXT_BUILDER_LEGACY_ARTIFACT_KEYS)[number], string> & Partial<Record<"selected_context_jsonl", string>>;
+export declare const CONTEXT_BUILDER_ATTACHABLE_ARTIFACT_KEYS: readonly ["bundle_md", "selected_context_jsonl", "manifest_json"];
 export declare const CONTEXT_BUILDER_RECEIPT_TOP_LEVEL_KEYS: readonly ["schema_version", "run_id", "status", "artifact_dir", "artifacts", "attachable_file_paths", "recommended_clink", "metrics", "warnings", "omissions"];
 export type ContextBuilderStatus = "succeeded" | "partial";
 export type ContextBuilderReceiptSchemaVersion = typeof CONTEXT_BUILDER_NO_DELEGATE_SCHEMA_VERSION | typeof CONTEXT_BUILDER_DELEGATE_SCHEMA_VERSION;
@@ -50,7 +52,7 @@ export type ContextBuilderReceipt = {
     run_id: string;
     status: ContextBuilderStatus;
     artifact_dir: string;
-    artifacts: Record<ContextBuilderArtifactKey, string>;
+    artifacts: ContextBuilderArtifactMap;
     attachable_file_paths: string[];
     recommended_clink: {
         absolute_file_paths: string[];
@@ -77,7 +79,7 @@ export declare function createContextBuilderReceipt(input: {
     run_id: string;
     status: ContextBuilderStatus;
     artifact_dir: string;
-    artifacts: Record<ContextBuilderArtifactKey, string>;
+    artifacts: ContextBuilderArtifactMap;
     metrics: ContextBuilderMetrics;
     warnings?: unknown[];
     omissions?: unknown[];

package/dist/context-builder/receipt.js

@@ -2,6 +2,16 @@ export const CONTEXT_BUILDER_NO_DELEGATE_SCHEMA_VERSION = 1;
 export const CONTEXT_BUILDER_DELEGATE_SCHEMA_VERSION = 2;
 export const CONTEXT_BUILDER_SCHEMA_VERSION = CONTEXT_BUILDER_NO_DELEGATE_SCHEMA_VERSION;
 export const CONTEXT_BUILDER_NO_DELEGATE_ARTIFACT_KEYS = [
+    "manifest_json",
+    "bundle_md",
+    "selected_context_jsonl",
+    "tree_json",
+    "search_jsonl",
+    "slices_jsonl",
+    "codemap_jsonl",
+    "summary_json",
+];
+export const CONTEXT_BUILDER_LEGACY_ARTIFACT_KEYS = [
     "manifest_json",
     "bundle_md",
     "tree_json",
@@ -12,6 +22,7 @@ export const CONTEXT_BUILDER_NO_DELEGATE_ARTIFACT_KEYS = [
 ];
 export const CONTEXT_BUILDER_ATTACHABLE_ARTIFACT_KEYS = [
     "bundle_md",
+    "selected_context_jsonl",
     "manifest_json",
 ];
 export const CONTEXT_BUILDER_RECEIPT_TOP_LEVEL_KEYS = [
@@ -50,7 +61,7 @@ export const CONTEXT_BUILDER_DELEGATE_FINALIZER_METADATA_KEYS = [
 ];
 export function createContextBuilderReceipt(input) {
     const artifacts = { ...input.artifacts };
-    const attachableFilePaths = CONTEXT_BUILDER_ATTACHABLE_ARTIFACT_KEYS.map((key) => artifacts[key]);
+    const attachableFilePaths = CONTEXT_BUILDER_ATTACHABLE_ARTIFACT_KEYS.map((key) => artifacts[key]).filter((path) => typeof path === "string");
     const baseReceipt = {
         run_id: input.run_id,
         status: input.status,

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

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

package/dist/context-builder/refine-handler.d.ts

@@ -0,0 +1,14 @@
+import { ContextBuilderSemaphore, type ContextBuilderInternalCaps } from "./config.js";
+import { type ContextBuilderReceiptTextResponse } from "./receipt.js";
+import { type ContextBuilderLifecycleInjection } from "./lifecycle-observer.js";
+export type RefineContextRunHandlerOptions = {
+    signal?: AbortSignal;
+    allowSecrets?: boolean;
+    runsDir?: string;
+    now?: () => Date;
+    semaphore?: ContextBuilderSemaphore;
+    internalCaps?: ContextBuilderInternalCaps;
+    lifecycle?: ContextBuilderLifecycleInjection;
+};
+export declare function handleRefineContextRun(args: unknown, options?: RefineContextRunHandlerOptions): Promise<ContextBuilderReceiptTextResponse>;
+export declare function refineContextRunJsonSchema(): Record<string, unknown>;