clinkx 0.1.10 → 0.2.1

package/dist/config.d.ts

@@ -2,12 +2,18 @@ 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"]>>;
+    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;
+    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;
+    extra_args?: string[] | undefined;
 }>;
 export type RoleConfig = z.infer<typeof RoleConfigSchema>;
 /**
@@ -34,12 +40,18 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     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"]>>;
+        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;
+        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;
+        extra_args?: string[] | undefined;
     }>>>;
     supports_images: z.ZodDefault<z.ZodBoolean>;
     requires_tty: z.ZodDefault<z.ZodBoolean>;
@@ -57,7 +69,9 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     stdin_placeholder_arg: z.ZodOptional<z.ZodString>;
     native_output_file_flag: z.ZodOptional<z.ZodString>;
     suppress_stdout: z.ZodDefault<z.ZodBoolean>;
+    stderr_to_file: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     name: string;
     command: string;
     args: string[];
@@ -65,11 +79,12 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     env: Record<string, string>;
     env_allowlist: string[];
     timeout_seconds: number;
-    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     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;
+        extra_args?: string[] | undefined;
     }>;
     supports_images: boolean;
     requires_tty: boolean;
@@ -79,6 +94,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     prompt_mode: "stdin" | "arg" | "file";
     suppress_stdout: boolean;
+    stderr_to_file: boolean;
     runner?: string | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
@@ -88,6 +104,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
 }, {
     name: string;
     command: string;
+    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     runner?: string | undefined;
     args?: string[] | undefined;
     unsafe_args?: string[] | undefined;
@@ -96,12 +113,13 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     timeout_seconds?: number | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     tolerate_nonzero_exit_for_parse?: boolean | undefined;
     capabilities_hint?: string | undefined;
     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;
+        extra_args?: string[] | undefined;
     }> | undefined;
     supports_images?: boolean | undefined;
     requires_tty?: boolean | undefined;
@@ -113,7 +131,9 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     stdin_placeholder_arg?: string | undefined;
     native_output_file_flag?: string | undefined;
     suppress_stdout?: boolean | undefined;
+    stderr_to_file?: boolean | undefined;
 }>, {
+    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     name: string;
     command: string;
     args: string[];
@@ -121,11 +141,12 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     env: Record<string, string>;
     env_allowlist: string[];
     timeout_seconds: number;
-    parser: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json";
     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;
+        extra_args?: string[] | undefined;
     }>;
     supports_images: boolean;
     requires_tty: boolean;
@@ -135,6 +156,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     prompt_mode: "stdin" | "arg" | "file";
     suppress_stdout: boolean;
+    stderr_to_file: boolean;
     runner?: string | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
@@ -144,6 +166,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
 }, {
     name: string;
     command: string;
+    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     runner?: string | undefined;
     args?: string[] | undefined;
     unsafe_args?: string[] | undefined;
@@ -152,12 +175,13 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     timeout_seconds?: number | undefined;
     idle_timeout_seconds?: number | undefined;
     idle_timeout_startup_seconds?: number | undefined;
-    parser?: "text" | "json_extract" | "gemini_json" | "codex_jsonl" | "claude_json" | "claude_stream_json" | undefined;
     tolerate_nonzero_exit_for_parse?: boolean | undefined;
     capabilities_hint?: string | undefined;
     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;
+        extra_args?: string[] | undefined;
     }> | undefined;
     supports_images?: boolean | undefined;
     requires_tty?: boolean | undefined;
@@ -169,6 +193,7 @@ export declare const CliAdapterConfigSchema: z.ZodEffects<z.ZodObject<{
     stdin_placeholder_arg?: string | undefined;
     native_output_file_flag?: string | undefined;
     suppress_stdout?: boolean | undefined;
+    stderr_to_file?: boolean | undefined;
 }>;
 export type CliAdapterConfig = z.infer<typeof CliAdapterConfigSchema>;
 export {};

package/dist/config.js

@@ -1,7 +1,12 @@
 import { z } from "zod";
+const ParserNameSchema = z.enum([
+    "text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json",
+]);
 const RoleConfigSchema = z.object({
     inline_prompt: z.string().optional(),
     prompt_file: z.string().optional(),
+    parser: ParserNameSchema.optional(),
+    extra_args: z.array(z.string()).optional(),
 });
 const ResultContractSchema = z.object({
     enabled: z.boolean().default(false),
@@ -25,9 +30,7 @@ export const CliAdapterConfigSchema = z.object({
     timeout_seconds: z.number().positive().default(600),
     idle_timeout_seconds: z.number().nonnegative().optional(),
     idle_timeout_startup_seconds: z.number().nonnegative().optional(),
-    parser: z
-        .enum(["text", "json_extract", "gemini_json", "codex_jsonl", "claude_json", "claude_stream_json"])
-        .default("text"),
+    parser: ParserNameSchema.default("text"),
     tolerate_nonzero_exit_for_parse: z.boolean().default(false),
     capabilities_hint: z.string().optional(),
     roles: z.record(RoleConfigSchema).default({}),
@@ -41,6 +44,7 @@ export const CliAdapterConfigSchema = z.object({
     stdin_placeholder_arg: z.string().min(1).optional(),
     native_output_file_flag: z.string().min(1).optional(),
     suppress_stdout: z.boolean().default(false),
+    stderr_to_file: z.boolean().default(false),
 }).superRefine((data, ctx) => {
     if (data.suppress_stdout && !data.native_output_file_flag) {
         ctx.addIssue({
@@ -56,5 +60,21 @@ 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"],
+            });
+        }
+    }
 });
 //# 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/handler.d.ts

@@ -1,3 +1,4 @@
+import { AdapterRegistry } from "./registry.js";
 import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
 /**
  * Handle a clink tool invocation.
@@ -12,6 +13,7 @@ export declare function handleClink(rawInput: unknown, options?: {
         server: Server;
         token: string | number;
     };
+    registry?: AdapterRegistry;
 }): Promise<{
     content: Array<{
         type: "text";

package/dist/handler.js

@@ -34,12 +34,13 @@ export async function handleClink(rawInput, options) {
     }
     const input = parseResult.data;
     logger.debug({ cli_name: input.cli_name, role: input.role }, "clink invoked");
+    const effectiveRegistry = options?.registry ?? getRegistry();
     const pipelineOptions = options?.signal != null || options?.progress != null
         ? {
             ...(options?.signal != null ? { signal: options.signal } : {}),
             ...(options?.progress != null ? { progress: options.progress } : {}),
         }
         : undefined;
-    return await executePipeline(input, getRegistry(), pipelineOptions);
+    return await executePipeline(input, effectiveRegistry, pipelineOptions);
 }
 //# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,SAAS,cAAc,CAAC,GAAa;IACnC,OAAO,GAAG,CAAC,MAAM;SACd,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,iCAAiC;AACjC,IAAI,QAAqC,CAAC;AAE1C,SAAS,WAAW;IAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAiB,EACjB,OAGC;IAKD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;IAE9E,MAAM,eAAe,GACnB,OAAO,EAAE,MAAM,IAAI,IAAI,IAAI,OAAO,EAAE,QAAQ,IAAI,IAAI;QAClD,CAAC,CAAC;YACE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,MAAM,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,SAAS,cAAc,CAAC,GAAa;IACnC,OAAO,GAAG,CAAC,MAAM;SACd,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACrE,OAAO,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,iCAAiC;AACjC,IAAI,QAAqC,CAAC;AAE1C,SAAS,WAAW;IAClB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAiB,EACjB,OAIC;IAKD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC;IAC/B,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;IAE9E,MAAM,iBAAiB,GAAG,OAAO,EAAE,QAAQ,IAAI,WAAW,EAAE,CAAC;IAC7D,MAAM,eAAe,GACnB,OAAO,EAAE,MAAM,IAAI,IAAI,IAAI,OAAO,EAAE,QAAQ,IAAI,IAAI;QAClD,CAAC,CAAC;YACE,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE;QACH,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,MAAM,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAC;AAC1E,CAAC"}

package/dist/local-clink-backend.d.ts

@@ -0,0 +1,30 @@
+/**
+ * In-process ClinkBackend that calls handleClink() directly.
+ *
+ * Eliminates child process + MCP transport overhead by routing workflow
+ * engine calls straight into the root pipeline. The existing semaphore
+ * in pipeline.ts handles concurrency; the engine's DispatchQueue provides
+ * the outer rate limit.
+ */
+import type { ClinkBackend, ToolCallResult } from "../clinkx-workflows/dist/backend.js";
+import type { AdapterRegistry } from "./registry.js";
+export interface LocalClinkBackendOptions {
+    readonly registry?: AdapterRegistry | undefined;
+    readonly defaultMaxResponseChars?: number | undefined;
+}
+export declare class LocalClinkBackend implements ClinkBackend {
+    readonly cliNames: string[];
+    readonly roleNames: string[];
+    private terminated;
+    private readonly registry;
+    private readonly defaultMaxResponseChars;
+    constructor(cliNames: string[], roleNames: string[], options?: LocalClinkBackendOptions);
+    get isTerminated(): boolean;
+    get hasChildDied(): boolean;
+    connect(): Promise<void>;
+    callTool(args: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<ToolCallResult>;
+    terminate(): Promise<void>;
+}

package/dist/local-clink-backend.js

@@ -0,0 +1,106 @@
+/**
+ * In-process ClinkBackend that calls handleClink() directly.
+ *
+ * Eliminates child process + MCP transport overhead by routing workflow
+ * engine calls straight into the root pipeline. The existing semaphore
+ * in pipeline.ts handles concurrency; the engine's DispatchQueue provides
+ * the outer rate limit.
+ */
+import { WorkflowCancellationError } from "../clinkx-workflows/dist/errors.js";
+import { handleClink } from "./handler.js";
+import { CancellationError, InvalidParamsError } from "./errors.js";
+import { logger } from "./logger.js";
+export class LocalClinkBackend {
+    cliNames;
+    roleNames;
+    terminated = false;
+    registry;
+    defaultMaxResponseChars;
+    constructor(cliNames, roleNames, options) {
+        this.cliNames = cliNames;
+        this.roleNames = roleNames;
+        this.registry = options?.registry;
+        this.defaultMaxResponseChars = options?.defaultMaxResponseChars;
+    }
+    get isTerminated() {
+        return this.terminated;
+    }
+    get hasChildDied() {
+        // No child process — can never die unexpectedly
+        return false;
+    }
+    async connect() {
+        // No-op: in-process backend needs no handshake
+        logger.debug("LocalClinkBackend: connect (no-op)");
+    }
+    async callTool(args, options) {
+        if (this.terminated) {
+            throw new Error("LocalClinkBackend: already terminated");
+        }
+        // Compose timeout with existing signal for Layer 2 deadline enforcement.
+        // handleClink() only accepts AbortSignal, not a separate timeoutMs param,
+        // so we fold the deadline into a composite signal via AbortSignal.any().
+        let signal = options?.signal;
+        if (options?.timeoutMs != null) {
+            const timeoutSignal = AbortSignal.timeout(options.timeoutMs);
+            signal = signal != null
+                ? AbortSignal.any([signal, timeoutSignal])
+                : timeoutSignal;
+        }
+        // Task 3: Inject workflow-default max_response_chars if not already set.
+        let effectiveArgs = args;
+        if (this.defaultMaxResponseChars != null && args["max_response_chars"] == null) {
+            effectiveArgs = { ...args, max_response_chars: this.defaultMaxResponseChars };
+        }
+        // handleClink() validates input, acquires semaphore, runs pipeline,
+        // and returns the standard MCP tool result shape.
+        try {
+            const result = await handleClink(effectiveArgs, {
+                ...(signal != null ? { signal } : {}),
+                ...(this.registry != null ? { registry: this.registry } : {}),
+            });
+            return result;
+        }
+        catch (error) {
+            // Translate root error types to workflow-engine-expected types.
+            // handleClink() throws root CancellationError / InvalidParamsError,
+            // but the workflow engine (clink-client.ts) expects:
+            //   - WorkflowCancellationError for cancellations
+            //   - errors with code === -32602 for InvalidParams (isMcpInvalidParams check)
+            if (error instanceof CancellationError) {
+                // Distinguish per-call timeout from user cancellation.
+                // When AbortSignal.timeout() fires, the signal's reason is a TimeoutError —
+                // that should surface as a retriable error, not a halt-inducing cancellation.
+                if (signal?.reason instanceof Error && signal.reason.name === "TimeoutError") {
+                    // Task 2: Return isError + _debug metadata so clink-client.ts classifies
+                    // the timeout as transient (termination_reason: "wall" → retryable).
+                    // Previously this threw a plain Error, which classifyFailureClass() in
+                    // engine.ts treated as permanent — wrong for timeouts.
+                    const timeoutText = `Per-call timeout exceeded (${String(options?.timeoutMs ?? "unknown")}ms)`;
+                    return {
+                        content: [
+                            { type: "text", text: timeoutText },
+                            { type: "text", text: JSON.stringify({ _debug: { termination_reason: "wall" } }) },
+                        ],
+                        isError: true,
+                    };
+                }
+                throw new WorkflowCancellationError();
+            }
+            if (error instanceof InvalidParamsError) {
+                // clink-client.ts checks (err as any).code === -32602
+                const translated = new Error(error.message, { cause: error });
+                translated.code = -32602;
+                throw translated;
+            }
+            throw error;
+        }
+    }
+    async terminate() {
+        if (this.terminated)
+            return;
+        this.terminated = true;
+        logger.debug("LocalClinkBackend: terminated");
+    }
+}
+//# sourceMappingURL=local-clink-backend.js.map

package/dist/local-clink-backend.js.map

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

package/dist/parsers/claude-stream-json.d.ts

@@ -8,7 +8,7 @@ import type { Parser } from "./types.js";
  *   - type:"result", subtype:"success" — final result string (canonical)
  *
  * Extraction strategy:
- *   1. Find last `type=result` event → use its `result` field
+ *   1. Find first non-empty `type=result` event → use its `result` field (first-result-wins)
  *   2. Fallback: find last `type=assistant` event → extract message.content[].text
  */
 export declare const claudeStreamJsonParser: Parser;

package/dist/parsers/claude-stream-json.js

@@ -39,14 +39,14 @@ function extractAssistantText(value) {
  *   - type:"result", subtype:"success" — final result string (canonical)
  *
  * Extraction strategy:
- *   1. Find last `type=result` event → use its `result` field
+ *   1. Find first non-empty `type=result` event → use its `result` field (first-result-wins)
  *   2. Fallback: find last `type=assistant` event → extract message.content[].text
  */
 export const claudeStreamJsonParser = {
     name: "claude_stream_json",
-    preferredBuffers: ["stdoutTail", "stdoutHead"],
+    preferredBuffers: ["stdoutHead", "stdoutTail"],
     parse(input) {
-        const text = preferredText(input, ["stdoutTail", "stdoutHead"]);
+        const text = preferredText(input, ["stdoutHead", "stdoutTail"]);
         if (text.trim().length === 0)
             return null;
         const lines = text
@@ -54,7 +54,10 @@ export const claudeStreamJsonParser = {
             .map((l) => l.trim())
             .filter((l) => l.length > 0);
         let resultText = null;
+        let resultLatched = false;
+        let resultEventCount = 0;
         let lastAssistantText = null;
+        let assistantEventCount = 0;
         for (const line of lines) {
             let parsed;
             try {
@@ -66,25 +69,40 @@ export const claudeStreamJsonParser = {
             if (parsed == null || typeof parsed !== "object")
                 continue;
             const rec = parsed;
-            // Primary: type=result event with result field
+            // Primary: first non-empty type=result event wins (subsequent are ignored)
             if (rec["type"] === "result" && typeof rec["result"] === "string") {
-                resultText = rec["result"];
+                resultEventCount++;
+                const candidate = rec["result"];
+                if (candidate.trim().length > 0) {
+                    if (resultText == null) {
+                        resultText = candidate;
+                    }
+                    else {
+                        resultLatched = true;
+                    }
+                }
             }
-            // Fallback: type=assistant event
+            // Fallback: type=assistant event (last-wins — multi-turn sessions have many)
             const assistantText = extractAssistantText(parsed);
             if (assistantText != null) {
+                assistantEventCount++;
                 lastAssistantText = assistantText;
             }
         }
         // Prefer result event, but treat empty/whitespace-only result as absent
         // so we fall through to lastAssistantText via ??.
-        const content = (resultText && resultText.trim().length > 0 ? resultText : null) ?? lastAssistantText;
+        const content = resultText ?? lastAssistantText;
         if (content == null || content.trim().length === 0)
             return null;
         return {
             content,
             source: "parser",
-            metadata: { parser: "claude_stream_json" },
+            metadata: {
+                parser: "claude_stream_json",
+                resultEventCount,
+                resultLatched,
+                assistantEventCount,
+            },
         };
     },
 };

package/dist/parsers/claude-stream-json.js.map

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

package/dist/parsers/extract.d.ts

@@ -1,4 +1,5 @@
 import type { ParseInput, ParseResult } from "./types.js";
+import { type ResultContractStatus } from "../result-contract.js";
 export interface ExtractInput extends ParseInput {
     exitCode: number | null;
     /**
@@ -11,6 +12,7 @@ export interface ExtractOutput {
     result: ParseResult;
     isError: boolean;
     exitCode: number | null;
+    resultContractStatus?: ResultContractStatus;
 }
 /**
  * Deterministically extract the final user-facing content from captured buffers.

package/dist/parsers/extract.js

@@ -22,9 +22,9 @@ function parserByName(name) {
 }
 async function tryReadResultContract(workdir, contract) {
     if (!contract?.enabled)
-        return null;
+        return { content: null, status: "disabled" };
     if (contract.filename.trim().length === 0)
-        return null;
+        return { content: null, status: "missing" };
     return readResultFile(workdir, contract.filename);
 }
 function rawStdoutFallback(input) {
@@ -57,30 +57,42 @@ function hasValidPayload(result) {
  * 6) raw stderr fallback (when stdout is empty)
  */
 export async function extractResult(input) {
-    const contractText = await tryReadResultContract(input.workdir, input.adapter.result_contract);
+    const contractOutcome = await tryReadResultContract(input.workdir, input.adapter.result_contract);
+    const contractText = contractOutcome.content;
     let result = contractText != null
         ? {
             content: contractText,
             source: "result_contract",
-            metadata: { filename: input.adapter.result_contract?.filename },
+            metadata: {
+                filename: input.adapter.result_contract?.filename,
+                result_contract_status: contractOutcome.status,
+            },
         }
         : null;
-    // When stdout is intentionally suppressed and the native output file is missing, hard fail.
-    // Falling through to the parser chain would produce a silent false success because
-    // stdout buffers are empty ("ignore" stdio) and the text parser returns "".
-    if (result == null && input.adapter.suppress_stdout && input.adapter.result_contract?.enabled) {
-        return {
-            result: {
-                content: "",
-                source: "result_contract",
-                metadata: {
-                    parse_status: "invalid",
-                    rejection_reason: "missing_result_contract_file",
+    // When the result contract is enabled but missing, hard fail on exit-0
+    // unless stdout carries a viable fallback payload.
+    if (result == null &&
+        input.adapter.result_contract?.enabled &&
+        input.exitCode === 0) {
+        const stdoutCombined = (input.stdoutHead + input.stdoutTail).trim();
+        if (stdoutCombined.length === 0) {
+            return {
+                result: {
+                    content: "",
+                    source: "result_contract",
+                    metadata: {
+                        parse_status: "invalid",
+                        rejection_reason: contractOutcome.status === "missing"
+                            ? "missing_result_contract_file"
+                            : `result_contract_${contractOutcome.status}`,
+                        result_contract_status: contractOutcome.status,
+                    },
                 },
-            },
-            isError: true,
-            exitCode: input.exitCode,
-        };
+                isError: true,
+                exitCode: input.exitCode,
+                resultContractStatus: contractOutcome.status,
+            };
+        }
     }
     if (result == null) {
         const adapterParser = parserByName(input.adapter.parser);
@@ -115,6 +127,17 @@ export async function extractResult(input) {
             effectiveResult = stderrResult;
         }
     }
+    // Surface parser diagnostics (Fix 3: extraction diagnostics)
+    const parserMeta = effectiveResult.metadata ?? {};
+    const resultLatched = parserMeta["resultLatched"] === true;
+    if (resultLatched) {
+        logger.warn({
+            adapter: input.adapter.name,
+            parser: input.adapter.parser,
+            resultEventCount: parserMeta["resultEventCount"],
+            assistantEventCount: parserMeta["assistantEventCount"],
+        }, "multiple result events detected — first-result-wins latched, late results ignored (background task bug pattern)");
+    }
     logger.debug({
         adapter: input.adapter.name,
         parser: input.adapter.parser,
@@ -124,6 +147,9 @@ export async function extractResult(input) {
         stdoutTailLen: input.stdoutTail.length,
         stderrHeadLen: input.stderrHead.length,
         stderrTailLen: input.stderrTail.length,
+        resultEventCount: parserMeta["resultEventCount"],
+        resultLatched,
+        assistantEventCount: parserMeta["assistantEventCount"],
     }, "extraction complete");
     // Error recovery parity: always attempt extraction, even on non-zero exit.
     const exitCode = input.exitCode;
@@ -138,6 +164,6 @@ export async function extractResult(input) {
                 : tolerate && hasValidPayload(effectiveResult)
                     ? false
                     : true;
-    return { result: effectiveResult, isError, exitCode };
+    return { result: effectiveResult, isError, exitCode, resultContractStatus: contractOutcome.status };
 }
 //# sourceMappingURL=extract.js.map