@r3b1s/pi-repair-layer 0.2.0 → 0.3.0

package/dist/src/preprocess.js

@@ -0,0 +1,216 @@
+import { unwrapMarkdownAutoLinks } from "./repair-engine.js";
+function decodePointerSegment(segment) {
+    return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+function locationsAt(root, selector) {
+    if (selector === "" || selector === "/") {
+        return [{ parent: undefined, key: undefined, value: root }];
+    }
+    const segments = selector.split("/").slice(1).map(decodePointerSegment);
+    let locations = [
+        { parent: undefined, key: undefined, value: root },
+    ];
+    for (const segment of segments) {
+        const next = [];
+        for (const location of locations) {
+            if (segment === "*") {
+                if (Array.isArray(location.value)) {
+                    location.value.forEach((value, key) => {
+                        next.push({ parent: location.value, key, value });
+                    });
+                }
+                continue;
+            }
+            if (location.value !== null &&
+                typeof location.value === "object" &&
+                !Array.isArray(location.value)) {
+                const parent = location.value;
+                next.push({ parent, key: segment, value: parent[segment] });
+            }
+        }
+        locations = next;
+    }
+    return locations;
+}
+function accepts(value, expected) {
+    if (expected === undefined)
+        return value !== null && value !== undefined;
+    if (expected === "array")
+        return Array.isArray(value);
+    if (expected === "object") {
+        return value !== null && typeof value === "object" && !Array.isArray(value);
+    }
+    return typeof value === expected;
+}
+function setLocation(location, value) {
+    if (location.parent === undefined || location.key === undefined)
+        return false;
+    if (Array.isArray(location.parent) && typeof location.key === "number") {
+        location.parent[location.key] = value;
+    }
+    else if (!Array.isArray(location.parent) &&
+        typeof location.key === "string") {
+        location.parent[location.key] = value;
+    }
+    else {
+        return false;
+    }
+    location.value = value;
+    return true;
+}
+function stripAnchors(value) {
+    return value.replace(/^\^+/, "").replace(/\$+$/, "");
+}
+const GRAMMAR_TOKENS = /^(?:<arg_key>|<arg_value>)|(?:<\/arg_key>|<\/arg_value>)$/g;
+function stripGrammarTokens(value) {
+    return value.replace(GRAMMAR_TOKENS, "").trim();
+}
+function modelMatches(modelId, families) {
+    return Boolean(modelId && families?.some((family) => family.test(modelId)));
+}
+function note(ruleId, text) {
+    return { ruleId, stage: "preprocess", note: text };
+}
+export function preprocessInput(options) {
+    const { toolName, preprocessors, modelId, allowValidValueTransforms } = options;
+    let value = structuredClone(options.input);
+    const changes = [];
+    const observations = [];
+    for (const preprocessor of preprocessors) {
+        if (preprocessor.kind === "alias") {
+            const parts = preprocessor.selector.split("/");
+            const canonical = decodePointerSegment(parts.pop() ?? "");
+            const parentSelector = (parts.join("/") || "/");
+            for (const parentLocation of locationsAt(value, parentSelector)) {
+                const parent = parentLocation.value;
+                if (parent === null ||
+                    typeof parent !== "object" ||
+                    Array.isArray(parent)) {
+                    continue;
+                }
+                const record = parent;
+                const canonicalValue = record[canonical];
+                const replaceEmpty = preprocessor.emptyEquivalentToMissing === true &&
+                    canonicalValue === "";
+                if (canonical in record &&
+                    canonicalValue !== undefined &&
+                    canonicalValue !== null &&
+                    !replaceEmpty) {
+                    continue;
+                }
+                for (const alias of preprocessor.aliases) {
+                    if (!(alias in record) ||
+                        !accepts(record[alias], preprocessor.accepts)) {
+                        continue;
+                    }
+                    if (record[alias] === "")
+                        continue;
+                    record[canonical] = record[alias];
+                    delete record[alias];
+                    changes.push(note("preprocess.exact-alias", `Renamed \`${alias}\` to \`${canonical}\` for tool "${toolName}". Use \`${canonical}\` next time.`));
+                    break;
+                }
+            }
+            continue;
+        }
+        if (preprocessor.kind === "structural") {
+            for (const location of locationsAt(value, preprocessor.selector)) {
+                const result = preprocessor.apply(location.value);
+                if (!result)
+                    continue;
+                if (location.parent === undefined)
+                    value = result.value;
+                else
+                    setLocation(location, result.value);
+                changes.push(note(preprocessor.ruleId, result.note));
+            }
+            continue;
+        }
+        const heuristic = preprocessor.kind === "anchor-bleed" ||
+            preprocessor.kind === "grammar-tokens";
+        if (heuristic && !modelMatches(modelId, preprocessor.modelFamilies))
+            continue;
+        for (const location of locationsAt(value, preprocessor.selector)) {
+            const current = location.value;
+            let next = current;
+            if (preprocessor.kind === "filesystem-path" &&
+                typeof current === "string") {
+                next = unwrapMarkdownAutoLinks(current);
+            }
+            else if (preprocessor.kind === "filesystem-path-array" &&
+                Array.isArray(current)) {
+                next = current.map((item) => typeof item === "string" ? unwrapMarkdownAutoLinks(item) : item);
+            }
+            else if (preprocessor.kind === "string-or-array" &&
+                typeof current === "string") {
+                next = [current];
+            }
+            else if (preprocessor.kind === "scalar") {
+                if (preprocessor.scalarType === "string" &&
+                    ["number", "boolean"].includes(typeof current)) {
+                    next = String(current);
+                }
+                else if (preprocessor.scalarType === "number" &&
+                    typeof current === "string" &&
+                    current.trim() !== "") {
+                    const parsed = Number(current);
+                    if (Number.isFinite(parsed))
+                        next = parsed;
+                }
+                else if (preprocessor.scalarType === "boolean" &&
+                    typeof current === "string" &&
+                    /^(?:true|false)$/i.test(current)) {
+                    next = current.toLowerCase() === "true";
+                }
+            }
+            else if (preprocessor.kind === "anchor-bleed" &&
+                typeof current === "string") {
+                next = stripAnchors(current);
+            }
+            else if (preprocessor.kind === "grammar-tokens") {
+                if (typeof current === "string") {
+                    next = stripGrammarTokens(current);
+                }
+                else if (current !== null &&
+                    typeof current === "object" &&
+                    !Array.isArray(current)) {
+                    const record = Object.create(null);
+                    for (const [key, item] of Object.entries(current)) {
+                        const cleanKey = stripGrammarTokens(key);
+                        record[cleanKey] =
+                            typeof item === "string" ? stripGrammarTokens(item) : item;
+                    }
+                    next = record;
+                }
+            }
+            if (Object.is(next, current) ||
+                JSON.stringify(next) === JSON.stringify(current)) {
+                continue;
+            }
+            const ruleId = preprocessor.kind === "anchor-bleed"
+                ? "stripAnchorBleed"
+                : preprocessor.kind === "grammar-tokens"
+                    ? "stripGrammarTokenLeak"
+                    : `preprocess.${preprocessor.kind}`;
+            if (heuristic && !allowValidValueTransforms) {
+                if (!observations.includes(ruleId))
+                    observations.push(ruleId);
+                continue;
+            }
+            if (location.parent === undefined)
+                value = next;
+            else
+                setLocation(location, next);
+            changes.push(note(ruleId, preprocessor.kind === "anchor-bleed"
+                ? `Stripped leaked regex anchors (\`^\` / \`$\`) from a configured value for tool "${toolName}".`
+                : preprocessor.kind === "grammar-tokens"
+                    ? `Removed leaked grammar tokens (\`<arg_key>\`/\`<arg_value>\`) from configured keys or values for tool "${toolName}".`
+                    : preprocessor.kind === "filesystem-path" ||
+                        preprocessor.kind === "filesystem-path-array"
+                        ? `Unwrapped a markdown auto-link at ${preprocessor.selector || "/"} for tool "${toolName}". Send plain filesystem paths, not markdown links.`
+                        : `Applied configured ${preprocessor.kind} preprocessing at ${preprocessor.selector || "/"} for tool "${toolName}".`));
+        }
+    }
+    return { value, changes, observations };
+}
+//# sourceMappingURL=preprocess.js.map

package/dist/src/preprocess.js.map

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

package/dist/src/repair-engine.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Validate-then-repair engine for LLM tool-call inputs.
+ *
+ * Design (matching the publicly described behavior of commandcode's repair layer):
+ *
+ * - Strictly valid inputs are never touched: the fast path is a plain
+ *   `Value.Check` and returns the original input by reference.
+ * - On failure, the validator's own issue list localizes the damage. Repairs are
+ *   attempted only at the exact paths the schema disagreed with, in a fixed
+ *   order (JSON-array parsing must run before bare-string wrapping, or
+ *   `'["a","b"]'` becomes `['["a","b"]']`).
+ * - Every mutation produces a model-facing note so the model can learn the real
+ *   contract on the next turn. Transparency over silent magic.
+ *
+ * The strict check deliberately runs BEFORE TypeBox's `Value.Convert` (which pi
+ * applies during validation), because Convert silently corrupts exactly the
+ * inputs this layer exists to fix: `'["a","b"]'` for an array field becomes
+ * `['["a","b"]']`, `null` for an optional string becomes the string `"null"`,
+ * and `null` for an optional number becomes `0` — all of which then pass
+ * validation and execute with garbage. Repairing at the strict-error sites
+ * first means those inputs are fixed properly (with a note) instead. Benign
+ * coercions ("5" -> 5) are left to Convert: if no repair rule fires and Convert
+ * alone makes the input valid, the input is reported as valid and returned
+ * untouched, so pi's native behavior is preserved.
+ *
+ * The one deliberate exception to validate-then-repair is markdown auto-link
+ * unwrapping on path fields: `[notes.md](http://notes.md)` is a perfectly valid
+ * string, so validation can never flag it. It is unwrapped unconditionally, but
+ * only in the degenerate case where the link text equals the url without its
+ * protocol — real markdown links pass through untouched.
+ */
+import type { TSchema } from "typebox";
+export interface StructuralRepair {
+    /** Rule name recorded in telemetry when the repair fires. */
+    name: string;
+    /** Mutate `args` in place. Return a model-facing note when a repair was applied, false otherwise. */
+    apply(args: Record<string, unknown>, toolName: string): string | false;
+}
+export interface ToolRepairConfig {
+    /** canonical field name -> wrong names models emit for it, matched at any depth by key. */
+    fieldAliases?: Record<string, readonly string[]>;
+    /** When the whole input is a bare string, wrap it as `{ [field]: value }`. */
+    rootString?: {
+        field: string;
+        wrapInArray?: boolean;
+    };
+    /** Top-level string fields holding filesystem paths (markdown auto-link unwrapping). */
+    pathFields?: readonly string[];
+    /** Tool-specific shape folds that single-field rules cannot express. */
+    structural?: readonly StructuralRepair[];
+}
+export interface RepairResult {
+    outcome: "valid" | "repaired" | "unrepairable";
+    /** What prepareArguments should return: the untouched input, the repaired input, or (unrepairable) the untouched input. */
+    args: unknown;
+    rulesFired: string[];
+    notes: string[];
+    /** One entry per mutation, including repeated use of the same stable rule. */
+    changes: Array<{
+        ruleId: string;
+        note: string;
+    }>;
+    /** Compact description of the original validation failure, for telemetry. */
+    issueSummary: string | undefined;
+    /** Stable hash of (tool, failure shape), for spotting per-model regressions. */
+    fingerprint: string | undefined;
+    /**
+     * Model-readable error for unrepairable input. Throwing this from
+     * prepareArguments matters: handing the raw input back to pi instead would
+     * let Value.Convert corrupt it (null -> "null") and execute the call anyway.
+     */
+    retryMessage: string | undefined;
+}
+export declare function unwrapMarkdownAutoLinks(value: string): string;
+export declare function repairSchemaInput(options: {
+    toolName: string;
+    schema: TSchema;
+    input: unknown;
+    config?: ToolRepairConfig;
+}): RepairResult;
+/**
+ * Current-major compatibility facade. New consumers should prefer
+ * `runRepairPipeline`, but this shape and its legacy rule names remain stable.
+ */
+export declare function repairToolInput(options: {
+    toolName: string;
+    schema: TSchema;
+    input: unknown;
+    config?: ToolRepairConfig;
+}): RepairResult;
+//# sourceMappingURL=repair-engine.d.ts.map

package/dist/src/repair-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-engine.d.ts","sourceRoot":"","sources":["../../src/repair-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIvC,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;CACxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACjD,8EAA8E;IAC9E,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtD,wFAAwF;IACxF,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/C,2HAA2H;IAC3H,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gFAAgF;IAChF,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAWD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D;AAoRD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,YAAY,CA+Jf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,YAAY,CA6Bf"}