@caupulican/pi-adaptative 0.81.13 → 0.81.15

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [0.81.15] - 2026-07-07
+
+## [0.81.14] - 2026-07-07
+
+### Fixed
+- Fixed text protocol model gating so persisted probe verdicts opt in only text-protocol models after env/settings/model gates, while unflagged native models do not receive the primer.
+- Documented the `propertyCaseNormalize` and `jsonObjectPropertySalvage` repair modes in the operator docs and bundled tool-repair skill.
+
 ## [0.81.13] - 2026-07-07
 
 ### Fixed

package/dist/bundled-resources/skills/tool-call-repair/SKILL.md

@@ -103,17 +103,19 @@ as code (not prose):
 |---|---|---|---|
 | 1 | nullOptionalDrop | `null` for an optional field | delete key |
 | 2 | nullRequiredBounce | `null` for a required field | no repair; bounce with required-value feedback |
-| 3 | jsonStringParse | `"[...]"`/`"{...}"` string where container expected | JSON.parse; keep if it matches + checks |
-| 4 | singleObjectWrap | single object where array-of-objects expected | wrap `[obj]` if it passes `items` |
-| 5 | bareScalarWrap | bare scalar where array expected | wrap `[v]` if it passes `items` |
-| 6 | emptyObjectPlaceholder | `{}` placeholder where scalar expected | delete if optional (default applies); else bounce |
-| 7 | numberFromString | `"42"` where number expected | `Number(s)` if finite |
-| 8 | boolFromString | `"true"`/`"false"` where bool expected | exact map (never truthiness) |
-| 9 | enumCaseNormalize | case/space enum variant | match to the one member, else bounce |
-| 10 | singleElementUnwrap | `[v]` where scalar expected | unwrap if 1 elem and checks |
-| 11 | stringifiedNumberInArray | `["1","2"]` where number[] expected | map Number if all finite |
-| 12 | bashCommandArgvJoin | bash `command` sent as an argv list | join string values with spaces |
-| 13 | bashCommandUnwrap | bash `command` sent as a single-key object wrapper | unwrap the string-valued wrapper |
+| 3 | jsonStringParse | `"[...]"`/`"{...}"` string where container expected | JSON.parse; guarded smart-quote delimiter fallback; keep if it matches + checks |
+| 4 | jsonObjectPropertySalvage | malformed object string with recoverable declared properties | keep declared property values if the whole object checks |
+| 5 | singleObjectWrap | single object where array-of-objects expected | wrap `[obj]` if it passes `items` |
+| 6 | bareScalarWrap | bare scalar where array expected | wrap `[v]` if it passes `items` |
+| 7 | emptyObjectPlaceholder | `{}` placeholder where scalar expected | delete if optional (default applies); else bounce |
+| 8 | numberFromString | `"42"` where number expected | `Number(s)` if finite |
+| 9 | boolFromString | `"true"`/`"false"` where bool expected | exact map (never truthiness) |
+| 10 | enumCaseNormalize | case/space enum variant | match to the one member, else bounce |
+| 11 | propertyCaseNormalize | root argument key casing differs from schema casing | rename to the schema key when unique |
+| 12 | singleElementUnwrap | `[v]` where scalar expected | unwrap if 1 elem and checks |
+| 13 | stringifiedNumberInArray | `["1","2"]` where number[] expected | map Number if all finite |
+| 14 | bashCommandArgvJoin | bash `command` sent as an argv list | join string values with spaces |
+| 15 | bashCommandUnwrap | bash `command` sent as a single-key object wrapper | unwrap the string-valued wrapper |
 
 Every entry is a NAMED registry entry
 `{name, errorSignature, transform, guard, noteTemplate}` — one table powers

package/dist/bundled-resources/skills/tool-call-repair/references/failure-grammar.md

@@ -18,15 +18,17 @@ is in its parent's `required`; `def(P)` = P has a schema `default`.
 |---|---|---|---|---|---|---|
 | 1 | nullOptionalDrop | type mismatch at P | `null`, `!req(P)` | delete key P | always (absence is valid for optional) | "sent null for optional `P` → omit the field instead" |
 | 1b | nullRequiredBounce | type mismatch at P | `null`, `req(P)`, `!def(P)` | none | never (bounce) | "`P` is required and cannot be null → send a real value" |
-| 2 | jsonStringParse | expect array\|object at P, got string | `"[...]"`/`"{...}"` | `JSON.parse(s)` | parsed matches expect(P) AND sub-checks | "sent `P` as a quoted JSON string → send a raw JSON array/object" |
+| 2 | jsonStringParse | expect array\|object at P, got string | `"[...]"`/`"{...}"`, including text-protocol smart-quote delimiter drift | `JSON.parse(s)`; if strict parse fails, normalize `“`/`”` delimiters and the observed missing object-key quote pattern, then parse | parsed matches expect(P) AND sub-checks | "sent `P` as a quoted JSON string → send a raw JSON array/object" |
+| 2b | jsonObjectPropertySalvage | expect object at P, got malformed object string | e.g. `{"path":"x" extra:1000}` | extract schema-declared JSON literal property values into a new object | each declared property appears at most once, no undeclared value is kept, and whole-object Check passes | "sent `P` as malformed JSON with recoverable declared properties → keep the schema-declared properties" |
 | 3 | singleObjectWrap | expect array at P, got object | `{...}` | `[obj]` | `[obj]` passes `items(P)` | "sent one object where `P` takes a list → wrap it in `[ ]`" |
 | 4 | bareScalarWrap | expect array at P, got scalar | string/number/bool | `[v]` | `[v]` passes `items(P)` | "sent a single value where `P` takes a list → wrap it in `[ ]`" |
 | 5 | emptyObjectPlaceholder | expect scalar at P (or array whose `items` reject `{}`), got object | `{}` | delete key P | `!req(P)` (schema default applies) else bounce | "sent `{}` as a placeholder → omit `P`; its default applies" |
 | 6 | numberFromString | expect number/integer at P, got string | `"42"`, numeric | `Number(s)` | finite (and integer if integer(P)) | "sent `P` as a quoted number → send a bare number" |
 | 7 | boolFromString | expect boolean at P, got string | `"true"`/`"false"` | `s === "true"` | exact match only (never truthiness) | "sent `P` as a quoted boolean → send bare true/false" |
 | 8 | enumCaseNormalize | expect enum at P, got string not in set | case/space variant | match case-insensitively/trimmed to one enum member | exactly one member matches | "`P` must be one of `a|b|c` → matched `<value>`" |
-| 9 | singleElementUnwrap | expect scalar at P, got 1-elem array | `[v]` | `v` | `v` passes expect(P) AND `length===1` | "sent `P` as a 1-item list where a single value was expected → send the value" |
-| 10 | stringifiedNumberInArray | expect number[] at P, got string[] | `["1","2"]` | map `Number` | all finite | "list `P` holds quoted numbers → send bare numbers" |
+| 9 | propertyCaseNormalize | root object has key K whose casing differs from a declared schema property | e.g. `Path` for `path` | rename K to the schema key | exactly one declared root property matches case-insensitively and the canonical key is absent | "sent `P` with different property-key casing → use the schema key casing" |
+| 10 | singleElementUnwrap | expect scalar at P, got 1-elem array | `[v]` | `v` | `v` passes expect(P) AND `length===1` | "sent `P` as a 1-item list where a single value was expected → send the value" |
+| 11 | stringifiedNumberInArray | expect number[] at P, got string[] | `["1","2"]` | map `Number` | all finite | "list `P` holds quoted numbers → send bare numbers" |
 
 Rules that keep this deterministic and safe:
 - **Repairs never invent a value.** 5 relies on the schema `default`; nothing
@@ -34,13 +36,14 @@ Rules that keep this deterministic and safe:
 - **Guard is mandatory.** Every transform runs on a clone and is kept ONLY if
   it Checks against the sub-schema at P. A transform whose guard fails leaves
   args untouched and falls through to the next applicable mode, then bounce.
-- **Order within one path:** 2 (parse) → 8/6/7 (coerce scalar) → 3/4/10 (wrap)
-  → 9 (unwrap) → 5 (placeholder-drop) → 1 (null-drop). Parse before wrap so a
+- **Order within one path:** 2 (strict/quote-normalized parse) → 2b (declared-property salvage) → 8/6/7 (coerce scalar) → 3/4/11 (wrap)
+  → 10 (unwrap) → 5 (placeholder-drop) → 1 (null-drop). Parse before wrap so a
   stringified array becomes an array, not a wrapped string. Across paths:
-  instance-path order.
+  instance-path order. Root property-key casing repair runs before these per-path
+  transforms because required-property validator errors do not carry the misspelled key path.
 - **One re-Check.** After all per-path transforms, Check the whole args once.
   Pass → return repaired; fail → bounce. Never loop transforms.
-- Modes 6–10 are the increment past the original four; each is guard-gated so
+- Modes 2b and 6–11 are the increment past the original four; each is guard-gated so
   it can only ever turn an invalid call into a valid one, never change a
   valid call (the hot path never reaches them — see Performance).
 
@@ -104,10 +107,13 @@ The failure grammar only ever runs on ALREADY-FAILED calls. The hot path
    `validator.Check(args)` (cached compiled validator) and returns the SAME
    object — no clone, no walk, no grammar lookup. This is the ~99% path for
    strong models and it is unchanged from today's cost.
-2. **Repairs are O(errors), not O(schema).** The analyzer walks the
+2. **Repairs are bounded on the failed path.** The analyzer walks the
    validator's error list (already produced by the failed Check), not the
-   schema tree. Each error maps to at most a few candidate modes by a static
-   dispatch table keyed on `(expect, got)` — a Map lookup, not a scan.
+   schema tree; the exceptions are `propertyCaseNormalize` and
+   `jsonObjectPropertySalvage`, which scan only root object keys or declared
+   object properties after a failed Check. Each
+   path error maps to at most a few candidate modes by a static dispatch table
+   keyed on `(expect, got)` — a Map lookup, not a scan.
 3. **No per-call compilation.** errorSignature matchers are precompiled
    constants; note templates are format strings; the registry is built once
    at module load. Nothing in the repair path constructs a RegExp, compiles a

package/dist/core/agent-session.d.ts

@@ -374,6 +374,7 @@ export declare class AgentSession {
     private readonly _repairModeSessionCounts;
     private readonly _textProtocolParseFailures;
     private _textProtocolParseObservedThisTurn;
+    private _textProtocolValidationOutcomeThisTurn;
     /** Assembles the session's base system prompt from live session state (see
      * system-prompt-builder.ts); owns the paired _baseSystemPromptOptions. */
     private readonly _systemPromptBuilder;
@@ -519,6 +520,7 @@ export declare class AgentSession {
     private _resolveToolProbeModels;
     probeToolCalling(target?: string): Promise<ToolProbeReport>;
     private _handleTextToolProtocolParse;
+    private _handleTextToolProtocolValidationOutcome;
     private _recordTextToolProtocolParseOutcomeFromLastAssistant;
     private _looksLikeTextToolProtocolAttempt;
     private _recordToolValidationBounce;