clinkx 0.2.3 → 1.0.0

package/dist/parsers/codex-jsonl.js

@@ -1,4 +1,4 @@
-import { preferredText } from "./utils.js";
+import { joinBuffers, preferredText } from "./utils.js";
 function extractCodexMessageText(value) {
     if (value == null || typeof value !== "object")
         return null;
@@ -167,12 +167,57 @@ function inspectCodexJsonl(text) {
         },
     };
 }
+function isFinalResult(result) {
+    return result != null && result.metadata?.["parse_status"] === "final";
+}
+function threadIdFrom(result) {
+    const threadId = result?.metadata?.["thread_id"];
+    return typeof threadId === "string" ? threadId : undefined;
+}
 export const codexJsonlParser = {
     name: "codex_jsonl",
     preferredBuffers: ["stdoutTail", "stdoutHead"],
     parse(input) {
-        const fromTail = inspectCodexJsonl(preferredText(input, ["stdoutTail"]));
-        return fromTail ?? inspectCodexJsonl(preferredText(input, ["stdoutHead"]));
+        const headText = preferredText(input, ["stdoutHead"]);
+        const tailText = preferredText(input, ["stdoutTail"]);
+        const headR = inspectCodexJsonl(headText);
+        const tailR = inspectCodexJsonl(tailText);
+        // Prefer final content: tail over head. Join only when neither window is final.
+        let base;
+        if (isFinalResult(tailR)) {
+            base = tailR;
+        }
+        else if (isFinalResult(headR)) {
+            base = headR;
+        }
+        let joinedR;
+        if (base === undefined && headText.length > 0 && tailText.length > 0) {
+            joinedR = inspectCodexJsonl(joinBuffers([headText, tailText]));
+            if (isFinalResult(joinedR)) {
+                base = joinedR;
+            }
+            else if (joinedR != null) {
+                base = joinedR;
+            }
+        }
+        if (base === undefined) {
+            base = tailR ?? headR;
+        }
+        if (base == null)
+            return null;
+        // Lift thread_id across windows: head → join (if ran) → tail.
+        const liftedThreadId = threadIdFrom(headR) ??
+            (joinedR !== undefined ? threadIdFrom(joinedR) : undefined) ??
+            threadIdFrom(tailR);
+        const metadata = { ...(base.metadata ?? {}) };
+        if (liftedThreadId !== undefined) {
+            metadata["thread_id"] = liftedThreadId;
+        }
+        return {
+            content: base.content,
+            source: base.source,
+            metadata,
+        };
     },
 };
 //# sourceMappingURL=codex-jsonl.js.map

package/dist/parsers/codex-jsonl.js.map

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

package/dist/parsers/extract.d.ts

@@ -1,4 +1,4 @@
-import type { ParseInput, ParseResult } from "./types.js";
+import type { ParseInput, ParseResult, Parser } from "./types.js";
 import { type ResultContractStatus } from "../result-contract.js";
 export interface ExtractInput extends ParseInput {
     exitCode: number | null;
@@ -14,6 +14,15 @@ export interface ExtractOutput {
     exitCode: number | null;
     resultContractStatus?: ResultContractStatus;
 }
+export declare function parserByName(name: string): Parser | null;
+/**
+ * Parse only through the adapter's declared production parser.
+ *
+ * This deliberately excludes result-contract reads, generic parser fallbacks,
+ * raw stdout/stderr fallbacks, and exit-code tolerance. Security-sensitive
+ * callers use it when incidental output must never be promoted to evidence.
+ */
+export declare function parseWithDeclaredParser(input: ParseInput): ParseResult | null;
 /**
  * Deterministically extract the final user-facing content from captured buffers.
  *

package/dist/parsers/extract.js

@@ -1,7 +1,6 @@
 import { joinBuffers, preferredText } from "./utils.js";
 import { textParser } from "./text.js";
 import { jsonExtractParser } from "./json-extract.js";
-import { geminiJsonParser } from "./gemini-json.js";
 import { codexJsonlParser } from "./codex-jsonl.js";
 import { claudeJsonParser } from "./claude-json.js";
 import { claudeStreamJsonParser } from "./claude-stream-json.js";
@@ -12,14 +11,23 @@ import { logger } from "../logger.js";
 const PARSERS = [
     textParser,
     jsonExtractParser,
-    geminiJsonParser,
     codexJsonlParser,
     claudeJsonParser,
     claudeStreamJsonParser,
 ];
-function parserByName(name) {
+export function parserByName(name) {
     return PARSERS.find((p) => p.name === name) ?? null;
 }
+/**
+ * Parse only through the adapter's declared production parser.
+ *
+ * This deliberately excludes result-contract reads, generic parser fallbacks,
+ * raw stdout/stderr fallbacks, and exit-code tolerance. Security-sensitive
+ * callers use it when incidental output must never be promoted to evidence.
+ */
+export function parseWithDeclaredParser(input) {
+    return parserByName(input.adapter.parser)?.parse(input) ?? null;
+}
 async function tryReadResultContract(workdir, contract) {
     if (!contract?.enabled)
         return { content: null, status: "disabled" };

package/dist/parsers/extract.js.map

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

package/dist/paths.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Parse CLINKX_ALLOWED_ROOTS env into an array of resolved absolute paths.
+ * Falls back to process.cwd() when not set.
+ */
+export declare function getCurrentAllowedRoots(): string[];
 /**
  * Startup guard: refuse to run if cwd resolves to filesystem root
  * unless CLINKX_ALLOWED_ROOTS is explicitly set.
@@ -15,3 +20,6 @@ export declare function assertNotRootDir(): void;
  * Throws InvalidParamsError if validation fails.
  */
 export declare function validatePath(inputPath: string): string;
+export declare function validateExistingPath(inputPath: string): string;
+export declare function validateExistingDirectory(inputPath: string): string;
+export declare function validateProspectiveChildPath(realpathedParent: string, childPath: string): string;

package/dist/paths.js

@@ -1,42 +1,14 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { isFilesystemRoot, isPathWithinAllowedRoots, isSamePathOrDescendant, parseAllowedRootsEnv, } from "./allowed-roots.js";
 import { InvalidParamsError } from "./errors.js";
 import { logger } from "./logger.js";
 /**
  * Parse CLINKX_ALLOWED_ROOTS env into an array of resolved absolute paths.
  * Falls back to process.cwd() when not set.
  */
-function getAllowedRoots() {
-    const envVal = process.env["CLINKX_ALLOWED_ROOTS"];
-    const raw = envVal != null && envVal.length > 0
-        ? envVal
-            .split(",")
-            .map((r) => r.trim())
-            .filter((r) => r.length > 0)
-        : [process.cwd()];
-    // Resolve through realpath so symlinks (e.g. macOS /var → /private/var)
-    // are consistent with how we resolve validated paths.
-    return raw.map((r) => {
-        try {
-            return fs.realpathSync(path.resolve(r));
-        }
-        catch {
-            return path.resolve(r);
-        }
-    });
-}
-/**
- * Check whether a resolved path is a filesystem root.
- * Handles Unix (/) and Windows drive roots (C:\).
- */
-function isFilesystemRoot(resolved) {
-    // Unix root
-    if (resolved === "/")
-        return true;
-    // Windows drive root: single letter + colon + backslash (or just colon + backslash)
-    if (/^[a-zA-Z]:[/\\]?$/.test(resolved))
-        return true;
-    return false;
+export function getCurrentAllowedRoots() {
+    return parseAllowedRootsEnv();
 }
 /**
  * Startup guard: refuse to run if cwd resolves to filesystem root
@@ -66,22 +38,38 @@ export function assertNotRootDir() {
  * Throws InvalidParamsError if validation fails.
  */
 export function validatePath(inputPath) {
-    const roots = getAllowedRoots();
-    let resolved;
+    return validateExistingPath(inputPath);
+}
+export function validateExistingPath(inputPath) {
+    const roots = getCurrentAllowedRoots();
+    const resolved = realpathExistingPath(inputPath);
+    if (!isPathWithinAllowedRoots(resolved, roots)) {
+        throw new InvalidParamsError(`Path "${inputPath}" (resolved: ${resolved}) is outside allowed roots. ` +
+            `Allowed: ${roots.join(", ")}`);
+    }
+    return resolved;
+}
+export function validateExistingDirectory(inputPath) {
+    const resolved = validateExistingPath(inputPath);
+    const stats = fs.statSync(resolved);
+    if (!stats.isDirectory()) {
+        throw new InvalidParamsError(`Path is not a directory: ${inputPath}`);
+    }
+    return resolved;
+}
+export function validateProspectiveChildPath(realpathedParent, childPath) {
+    const resolvedChild = path.resolve(realpathedParent, childPath);
+    if (!isSamePathOrDescendant(resolvedChild, realpathedParent)) {
+        throw new InvalidParamsError(`Path "${childPath}" escapes parent directory: ${realpathedParent}`);
+    }
+    return resolvedChild;
+}
+function realpathExistingPath(inputPath) {
     try {
-        resolved = fs.realpathSync(inputPath);
+        return fs.realpathSync(inputPath);
     }
     catch {
         throw new InvalidParamsError(`Path does not exist or is not accessible: ${inputPath}`);
     }
-    const withinRoot = roots.some((root) => {
-        const normalizedRoot = root.endsWith(path.sep) ? root : root + path.sep;
-        return resolved === root || resolved.startsWith(normalizedRoot);
-    });
-    if (!withinRoot) {
-        throw new InvalidParamsError(`Path "${inputPath}" (resolved: ${resolved}) is outside allowed roots. ` +
-            `Allowed: ${roots.join(", ")}`);
-    }
-    return resolved;
 }
 //# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,oBAAoB,EAAE,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,MAAM,gBAAgB,GACpB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,IAAI;QAC3C,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjD,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,2CAA2C,GAAG,KAAK;YACjD,gFAAgF;YAChF,iFAAiF;YACjF,8BAA8B,CACjC,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,+BAA+B,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,kBAAkB,CAC1B,SAAS,SAAS,gBAAgB,QAAQ,8BAA8B;YACtE,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjC,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEpC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,gBAAwB,EACxB,SAAiB;IAEjB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAEhE,IAAI,CAAC,sBAAsB,CAAC,aAAa,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,kBAAkB,CAC1B,SAAS,SAAS,+BAA+B,gBAAgB,EAAE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAC1B,6CAA6C,SAAS,EAAE,CACzD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/pipeline.d.ts

@@ -1,6 +1,9 @@
 import type { ClinkInput } from "./schema.js";
 import type { AdapterRegistry } from "./registry.js";
+import { type RunResult } from "./runner.js";
+import type { SessionLogOwnerV1 } from "../clinkx-workflows/dist/dashboard/session-log-contract.js";
 import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ActivityJournal } from "./activity-journal.js";
 export declare function pickPreferTail(head: string, tail: string): string;
 export declare function formatStdStreamsForError(options: {
     stdout?: string;
@@ -11,16 +14,57 @@ export declare function formatStdStreamsForError(options: {
 export declare function classifyStdoutCrash(stdout: string, stderr?: string): string | null;
 export declare function panicSpecificity(panicClass: string): number;
 /**
- * Resolve the effective timeout: adapter timeout acts as a floor.
- * Callers may extend above it, but never shorten below it.
+ * Resolve the effective timeout.
+ *
+ * Normal clink calls treat the adapter timeout as a floor. Internal delegate
+ * calls may opt into an honest request ceiling so their watchdog and subprocess
+ * wall timeout share one deadline.
  */
-export declare function resolveEffectiveTimeout(requested: number | undefined, adapterTimeout: number): number;
+export declare function resolveEffectiveTimeout(requested: number | undefined, adapterTimeout: number, options?: {
+    allowBelowAdapter?: boolean;
+}): number;
 export interface PipelineResult {
     content: Array<{
         type: "text";
         text: string;
     }>;
     isError?: boolean;
+    jsonFidelity?: PipelineJsonFidelityMetadata;
+}
+export type PipelineJsonTopLevelType = "object" | "array" | "string" | "number" | "boolean" | "null";
+export interface PipelineJsonFidelityMetadata {
+    readonly mode: "strict";
+    readonly enforced: boolean;
+    readonly parseSource: string;
+    readonly parseStatus: string | null;
+    readonly rejectionReason: string | null;
+    readonly valid: boolean;
+    readonly topLevelType: PipelineJsonTopLevelType | null;
+    readonly salvaged: boolean;
+    readonly salvageMethod: string | null;
+    readonly blockCount: number | null;
+    readonly rawFallback: boolean;
+    readonly capture: {
+        readonly truncated: boolean;
+        readonly streams: string[];
+        readonly stdoutTruncated: boolean;
+        readonly stderrTruncated: boolean;
+    };
+    readonly response: {
+        readonly truncated: boolean;
+        readonly maxChars: number;
+    };
+    readonly termination: {
+        readonly reason: RunResult["terminationReason"];
+        readonly timedOut: boolean;
+        readonly idleTimedOut: boolean;
+        readonly killed: boolean;
+        readonly signal: string | null;
+    };
+    readonly strict: {
+        readonly acceptable: boolean;
+        readonly violations: string[];
+    };
 }
 export declare function executePipeline(input: ClinkInput, registry: AdapterRegistry, options?: {
     signal?: AbortSignal;
@@ -28,6 +72,10 @@ export declare function executePipeline(input: ClinkInput, registry: AdapterRegi
         server: Server;
         token: string | number;
     };
+    jsonFidelity?: "strict";
+    allowTimeoutBelowAdapter?: boolean;
+    activityJournal?: ActivityJournal;
+    sessionLogOwner?: SessionLogOwnerV1;
 }): Promise<PipelineResult>;
 /**
  * Limit output to maxChars with JSON-aware truncation.