clinkx 0.3.0 → 1.1.0

package/dist/safety.js

@@ -1,11 +1,12 @@
-import { ExecutionError } from "./errors.js";
+import { ExecutionError, InvalidParamsError } from "./errors.js";
 import { logger } from "./logger.js";
+import { INVOCATION_AUDIT_V2_SCHEMA_VERSION, InvocationAuditV2Schema, representInvocationEffortValueV2, representInvocationModelValueV2, } from "../clinkx-workflows/dist/dashboard/invocation-contract.js";
 /**
- * Resolve the final CLI args array, always merging unsafe_args.
+ * Resolve the final CLI args array, merging unsafe_args.
  *
- * unsafe_args are unconditionally included when the adapter declares them.
- * Non-interactive subprocesses (the only mode clink supports) cannot approve
- * permission prompts, so permission-bypass flags must always be present.
+ * unsafe_args are included when the adapter declares them: non-interactive
+ * subprocesses (the only mode clink supports) cannot approve permission
+ * prompts, so permission-bypass flags must be present.
  */
 export function resolveArgs(args, unsafeArgs) {
     if (unsafeArgs.length > 0) {
@@ -14,6 +15,186 @@ export function resolveArgs(args, unsafeArgs) {
     }
     return [...args];
 }
+const INVOCATION_VALUE_TOKEN = "{value}";
+function ownsInvocationPair(flagToken, valueToken, owner) {
+    return flagToken === owner.flag &&
+        valueToken.startsWith(owner.staticPrefix) &&
+        valueToken.endsWith(owner.staticSuffix) &&
+        valueToken.length >= owner.staticPrefix.length + owner.staticSuffix.length &&
+        (owner.staticPrefix !== "" || !valueToken.startsWith("-"));
+}
+function removeInvocationPins(baseArgs, pins) {
+    const result = [];
+    for (let index = 0; index < baseArgs.length; index += 1) {
+        const token = baseArgs[index];
+        if (token == null)
+            continue;
+        const nextToken = baseArgs[index + 1];
+        const owner = nextToken == null
+            ? undefined
+            : pins.find((pin) => ownsInvocationPair(token, nextToken, pin));
+        if (owner != null && nextToken != null) {
+            // Declared pairs stay atomic, including nonrequested dash-leading values
+            // that could otherwise be mistaken for another override's flag.
+            if (!owner.requested)
+                result.push(token, nextToken);
+            index += 1;
+            continue;
+        }
+        if (pins.some((pin) => pin.flag === token &&
+            pin.requested &&
+            (nextToken == null ||
+                (pin.staticPrefix === "" && nextToken.startsWith("-"))))) {
+            // Empty-prefix pins treat a following dash-token as a sibling flag.
+            // Nonempty prefixes (for example `-c` + `model_reasoning_effort=`) must
+            // not drop the flag and orphan that follower.
+            continue;
+        }
+        // Preserve unrelated pairs (for example, `-c sandbox_mode=...`) and aliases.
+        result.push(token);
+    }
+    return result;
+}
+function parseInvocationTemplate(template) {
+    const flag = template.args[0];
+    const valueToken = template.args[1];
+    const valueIndex = valueToken?.indexOf(INVOCATION_VALUE_TOKEN) ?? -1;
+    if (flag == null || valueToken == null || valueIndex < 0) {
+        throw new InvalidParamsError("Invalid invocation override template");
+    }
+    return {
+        flag,
+        valueToken,
+        staticPrefix: valueToken.slice(0, valueIndex),
+        staticSuffix: valueToken.slice(valueIndex + INVOCATION_VALUE_TOKEN.length),
+    };
+}
+function validateRequestedInvocationValue(adapter, knob, value) {
+    if (value === undefined)
+        return;
+    if (knob === "model") {
+        const template = adapter.invocation_overrides?.model;
+        if (template == null) {
+            throw new InvalidParamsError(`adapter "${adapter.name}" does not declare invocation_overrides.model; ` +
+                "add it to the adapter config to allow per-call model");
+        }
+        if (value.startsWith("-")) {
+            throw new InvalidParamsError("model override must not start with '-'");
+        }
+        return;
+    }
+    const template = adapter.invocation_overrides?.effort;
+    if (template == null) {
+        throw new InvalidParamsError(`adapter "${adapter.name}" does not declare invocation_overrides.effort; ` +
+            "add it to the adapter config to allow per-call effort");
+    }
+    if (value.startsWith("-")) {
+        throw new InvalidParamsError("effort override must not start with '-'");
+    }
+    if (!template.allowed_values.includes(value)) {
+        throw new InvalidParamsError(`adapter "${adapter.name}" does not allow effort "${value}"; ` +
+            `allowed values: ${template.allowed_values.join(", ")}`);
+    }
+}
+function representInvocationValueV2(knob, value) {
+    return knob === "model"
+        ? representInvocationModelValueV2(value)
+        : representInvocationEffortValueV2(value);
+}
+function extractOwnedPinValue(effectiveArgs, template) {
+    let applied;
+    for (let index = 0; index < effectiveArgs.length; index += 1) {
+        const token = effectiveArgs[index];
+        const nextToken = effectiveArgs[index + 1];
+        if (token == null ||
+            nextToken == null ||
+            !ownsInvocationPair(token, nextToken, template)) {
+            continue;
+        }
+        applied = nextToken.slice(template.staticPrefix.length, nextToken.length - template.staticSuffix.length);
+        index += 1;
+    }
+    return applied;
+}
+function auditKnob(effectiveArgs, knob, requested, template) {
+    if (requested !== undefined) {
+        const value = representInvocationValueV2(knob, requested);
+        return {
+            provenance: "caller_override",
+            requested: value,
+            applied: value,
+        };
+    }
+    if (template === undefined) {
+        return { provenance: "cli_default_unknown" };
+    }
+    const applied = extractOwnedPinValue(effectiveArgs, template);
+    if (applied === undefined) {
+        return { provenance: "cli_default_unknown" };
+    }
+    return {
+        provenance: "adapter_pin",
+        applied: representInvocationValueV2(knob, applied),
+    };
+}
+/**
+ * Apply caller overrides and derive their V2 audit from one parsed template set.
+ *
+ * Dispatch values remain exact. Values outside the dashboard grammar are never
+ * normalized or partially retained; the shared V2 representation records only
+ * `accepted_unrepresentable` with the truthful provenance arm.
+ */
+export function resolveInvocationApplication(adapter, baseArgs, overrides) {
+    validateRequestedInvocationValue(adapter, "model", overrides.model);
+    validateRequestedInvocationValue(adapter, "effort", overrides.effort);
+    const pins = [];
+    const rendered = [];
+    const templates = {};
+    for (const knob of ["model", "effort"]) {
+        const template = adapter.invocation_overrides?.[knob];
+        if (template == null)
+            continue;
+        const parsed = parseInvocationTemplate(template);
+        templates[knob] = parsed;
+        const value = overrides[knob];
+        pins.push({
+            flag: parsed.flag,
+            staticPrefix: parsed.staticPrefix,
+            staticSuffix: parsed.staticSuffix,
+            requested: value !== undefined,
+        });
+        if (value !== undefined) {
+            rendered.push(parsed.flag, parsed.valueToken.replace(INVOCATION_VALUE_TOKEN, () => value));
+        }
+    }
+    // Sweep only the original argv: rendered values may themselves equal flags.
+    const args = overrides.model === undefined && overrides.effort === undefined
+        ? [...baseArgs]
+        : [...removeInvocationPins(baseArgs, pins), ...rendered];
+    const audit = InvocationAuditV2Schema.parse({
+        schemaVersion: INVOCATION_AUDIT_V2_SCHEMA_VERSION,
+        model: auditKnob(args, "model", overrides.model, templates.model),
+        effort: auditKnob(args, "effort", overrides.effort, templates.effort),
+    });
+    return { args, audit };
+}
+/**
+ * Compatibility wrapper for callers that need only the effective argv.
+ * New subprocess producers should consume `resolveInvocationApplication` so
+ * argv and audit cannot diverge through duplicate resolution.
+ */
+export function resolveInvocationOverrides(adapter, baseArgs, overrides) {
+    return resolveInvocationApplication(adapter, baseArgs, overrides).args;
+}
+/**
+ * Compatibility wrapper for callers that need only the V2 invocation audit.
+ *
+ * Pure with respect to its inputs and validating; the canonical application
+ * remains the only implementation of template parsing, dispatch, and audit.
+ */
+export function deriveInvocationAudit(adapter, mergedArgs, overrides) {
+    return resolveInvocationApplication(adapter, mergedArgs, overrides).audit;
+}
 /**
  * Build debug metadata object. Returns metadata only when debug=true.
  * Never appends to model output — caller must place in a separate content block.

package/dist/safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"safety.js","sourceRoot":"","sources":["../src/safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAAuB,EACvB,UAA6B;IAE7B,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,IAA6B;IAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,WAAoB;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,cAAc,CACtB,YAAY,WAAW,wCAAwC;YAC7D,uCAAuC;YACvC,uDAAuD;YACvD,8CAA8C,CACjD,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../src/safety.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -12,6 +12,10 @@ export declare const ClinkInputSchema: z.ZodObject<{
     cli_name: z.ZodOptional<z.ZodString>;
     /** Role selector — maps to adapter roles config. */
     role: z.ZodDefault<z.ZodString>;
+    /** Optional model override; support is declared by the selected adapter. */
+    model: z.ZodOptional<z.ZodString>;
+    /** Optional effort override; support and vocabulary are adapter-declared. */
+    effort: z.ZodOptional<z.ZodString>;
     /** Absolute file paths to reference (PAL-canonical name). */
     absolute_file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** Absolute image paths. */
@@ -49,30 +53,34 @@ export declare const ClinkInputSchema: z.ZodObject<{
     /** Keep run artifacts after completion (requires debug=true). */
     debug_keep_artifacts: z.ZodDefault<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
-    prompt: string;
-    role: string;
     debug: boolean;
+    role: string;
+    prompt: string;
     debug_keep_artifacts: boolean;
+    context?: string | undefined;
     timeout_seconds?: number | undefined;
+    max_response_chars?: number | undefined;
     cli_name?: string | undefined;
+    model?: string | undefined;
+    effort?: string | undefined;
     absolute_file_paths?: string[] | undefined;
     images?: string[] | undefined;
-    context?: string | undefined;
     continuation_id?: string | undefined;
-    max_response_chars?: number | undefined;
     expect_json?: boolean | undefined;
 }, {
     prompt: string;
+    debug?: boolean | undefined;
+    context?: string | undefined;
     timeout_seconds?: number | undefined;
+    max_response_chars?: number | undefined;
     cli_name?: string | undefined;
     role?: string | undefined;
+    model?: string | undefined;
+    effort?: string | undefined;
     absolute_file_paths?: string[] | undefined;
     images?: string[] | undefined;
-    context?: string | undefined;
     continuation_id?: string | undefined;
-    max_response_chars?: number | undefined;
     expect_json?: boolean | undefined;
-    debug?: boolean | undefined;
     debug_keep_artifacts?: boolean | undefined;
 }>;
 export type ClinkInput = z.infer<typeof ClinkInputSchema>;

package/dist/schema.js

@@ -20,6 +20,26 @@ export const ClinkInputSchema = z
         .string()
         .default("default")
         .describe('Role for the subagent. Use "default" for standard role instructions, or select a specific role.'),
+    /** Optional model override; support is declared by the selected adapter. */
+    model: z
+        .string()
+        .trim()
+        .min(1)
+        .max(128)
+        // Keep in sync with MODEL_OVERRIDE_PATTERN (workflow-tools.ts) and ModelSchema (delegate-validate.ts).
+        .regex(/^[^\s\u0000-][^\s\u0000]*$/)
+        .optional()
+        .describe("Optional model override. Omit to use the CLI's configured default; support is adapter-declared."),
+    /** Optional effort override; support and vocabulary are adapter-declared. */
+    effort: z
+        .string()
+        .trim()
+        .min(1)
+        .max(32)
+        // Keep in sync with EFFORT_OVERRIDE_PATTERN (workflow-tools.ts) and EffortSchema (delegate-validate.ts).
+        .regex(/^[a-z0-9][a-z0-9_-]*$/)
+        .optional()
+        .describe("Optional effort override. Omit to use the CLI's configured default; support is adapter-declared."),
     /** Absolute file paths to reference (PAL-canonical name). */
     absolute_file_paths: z
         .array(z.string())

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,6CAA6C;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAEpE,4DAA4D;IAC5D,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kBAAkB,CAAC;IAE/B,oDAAoD;IACpD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,iGAAiG,CAAC;IAE9G,6DAA6D;IAC7D,mBAAmB,EAAE,CAAC;SACnB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;IAE/C,4BAA4B;IAC5B,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,sBAAsB,CAAC;IAEnC,kFAAkF;IAClF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8EAA8E,CAC/E;IAEH,0DAA0D;IAC1D,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IAEpD;;;;;;OAMG;IACH,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IAEjD;;;;;;OAMG;IACH,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,qCAAqC,CAAC;IAElD;;;;;;OAMG;IACH,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAE7C,yCAAyC;IACzC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAEpE,iEAAiE;IACjE,oBAAoB,EAAE,CAAC;SACpB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qCAAqC,CAAC;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,gBAAgB,EAAE;QAC/C,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,MAAM;KACrB,CAA4B,CAAC;IAE9B,yDAAyD;IACzD,uFAAuF;IACvF,gFAAgF;IAChF,oFAAoF;IACpF,qBAAqB;IACrB,gFAAgF;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAwC,CAAC;IAC1E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACnC,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,4 +1,9 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { StdioActivity } from "./stdio-activity.js";
+export interface CreateServerOptions {
+    /** Internal STDIO lifecycle activity; omitted for embedded/dashboard callers. */
+    readonly activity?: StdioActivity | undefined;
+}
 /**
  * Create and configure the ClinkX MCP server.
  *
@@ -9,4 +14,5 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
  *
  * Does NOT connect transport — caller is responsible for that.
  */
-export declare function createServer(): Server;
+export declare function createServer(options?: CreateServerOptions): Server;
+export declare function workflowsContextPreflightEnabledFromEnv(): boolean;