imperal-sdk 4.2.8__tar.gz → 4.2.10__tar.gz

{imperal_sdk-4.2.8 → imperal_sdk-4.2.10}/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 All notable changes to `imperal-sdk` are documented here.
 
+## 4.2.10 — 2026-05-13
+
+**Feat: `@chat.function` default `chain_callable=True` for ALL action_types (was write/destructive only)**
+
+V19 federal default: `chain_callable` now defaults to `True` for read
+action_types too, not just `write` / `destructive`. This closes the
+wrapper-LLM paraphrase risk for typed read handlers (`list_*`,
+`search_*`, `get_*`) — when the classifier picks a read with concrete
+args, the kernel `chain_executor._resolve_typed_dispatch` dispatches
+the typed call directly instead of routing through the ChatExtension
+BYOLLM tool-use loop.
+
+Authors who need the wrapper-LLM tool-use loop for their handler
+(conversational catch-all like `case_chat`) must explicitly set
+`chain_callable=False`. The change is backward-compatible — existing
+manifests with explicit `True` / `False` are unaffected; only the
+implicit default for reads flips.
+
+Migration: run `imperal build` to regenerate manifests; read functions
+without explicit `chain_callable` will now emit `chain_callable: true`.
+
+Federal invariant: closes the wrapper-LLM paraphrase risk class for
+read intents, completing the `I-CHAT-FUNCTION-VERBATIM-PARAMS`
+structural enforcement.
+
+## 4.2.9 — 2026-05-13
+
+**Fix: regenerate `src/imperal_sdk/schemas/imperal.schema.json` after SecretDecl addition**
+
+v4.2.8 added the `SecretDecl` Pydantic model + `Manifest.secrets` field but
+forgot to regenerate the committed static JSON Schema mirror. CI gate
+`test_spec_validation.py::test_static_schema_matches_runtime_export[imperal]`
+caught the drift — runtime Pydantic schema (with `SecretDecl` + `secrets[]`)
+no longer matched the committed file.
+
+This release ships the regenerated `imperal.schema.json` so the static
+artifact equals the runtime model again. No public API change.
+
 ## 4.2.8 — 2026-05-13
 
 **Fix: `secrets[]` finally in `Manifest` Pydantic schema**

{imperal_sdk-4.2.8 → imperal_sdk-4.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: imperal-sdk
-Version: 4.2.8
+Version: 4.2.10
 Summary: SDK for building Imperal Cloud extensions
 Author: Valentin Scerbacov, Imperal, Inc.
 License-Expression: AGPL-3.0-or-later

{imperal_sdk-4.2.8 → imperal_sdk-4.2.10}/src/imperal_sdk/__init__.py

@@ -39,7 +39,7 @@ from imperal_sdk.secrets import (
     SecretValueTooLarge, SecretDeclarationConflict,
 )
 
-__version__ = "4.2.8"
+__version__ = "4.2.10"
 
 __all__ = [
     # Core

{imperal_sdk-4.2.8 → imperal_sdk-4.2.10}/src/imperal_sdk/chat/extension.py

@@ -147,7 +147,16 @@ class ChatExtension:
                 ``archive_drafts_in_project``.
         """
         if chain_callable is None:
-            chain_callable = action_type in ("write", "destructive")
+            # V19 (federal v4.2.10, 2026-05-13): default True for ALL
+            # action_types — reads also typed-dispatch when the classifier
+            # picked them, closing the wrapper-LLM paraphrase risk on
+            # `list_*`, `search_*`, `get_*` style handlers. Authors who
+            # need the wrapper-LLM tool-use loop (catch-all conversational
+            # handlers like `case_chat`) must set `chain_callable=False`
+            # explicitly. Pre-v4.2.10 default kept `False` for reads;
+            # backward-compatible because action_type in ("write",
+            # "destructive") already returned True and continues to.
+            chain_callable = True
 
         def decorator(func: Callable) -> Callable:
             # Auto-detect Pydantic BaseModel params + return type

{imperal_sdk-4.2.8 → imperal_sdk-4.2.10}/src/imperal_sdk/schemas/imperal.schema.json

@@ -224,6 +224,63 @@
       "title": "Schedule",
       "type": "object"
     },
+    "SecretDecl": {
+      "additionalProperties": false,
+      "description": "One entry in `manifest['secrets']` — EXT-SECRETS-V1 (v4.2.2+).\n\nMirrors :class:`imperal_sdk.secrets.spec.SecretSpec` after\n``to_manifest_dict()``. The Pydantic model exists so\n:func:`validate_manifest_dict` round-trips the emitted shape — closes\nthe `I-MANIFEST-EMITTER-SCHEMA-SYMMETRIC` drift gap that lived\nsilently from v4.2.2 → v4.2.7.",
+      "properties": {
+        "name": {
+          "pattern": "^[a-z][a-z0-9_]{0,62}$",
+          "title": "Name",
+          "type": "string"
+        },
+        "description": {
+          "minLength": 1,
+          "title": "Description",
+          "type": "string"
+        },
+        "required": {
+          "default": false,
+          "title": "Required",
+          "type": "boolean"
+        },
+        "write_mode": {
+          "default": "user",
+          "enum": [
+            "user",
+            "extension",
+            "both"
+          ],
+          "title": "Write Mode",
+          "type": "string"
+        },
+        "max_bytes": {
+          "default": 4096,
+          "maximum": 65536,
+          "minimum": 1,
+          "title": "Max Bytes",
+          "type": "integer"
+        },
+        "rotation_hint_days": {
+          "anyOf": [
+            {
+              "minimum": 1,
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Rotation Hint Days"
+        }
+      },
+      "required": [
+        "name",
+        "description"
+      ],
+      "title": "SecretDecl",
+      "type": "object"
+    },
     "Signal": {
       "additionalProperties": false,
       "description": "One entry in `manifest['signals']`.",
@@ -254,7 +311,7 @@
     },
     "Tool": {
       "additionalProperties": false,
-      "description": "One entry in `manifest['tools']`.\n\nFederal v4.0.0 \u2014 typed dispatch fields (action_type, chain_callable,\neffects, params_schema, return_schema, event) declared at top level so\nthe kernel chain planner can route deterministically without\nre-deriving from extension code.",
+      "description": "One entry in `manifest['tools']`.\n\nFederal v4.0.0 — typed dispatch fields (action_type, chain_callable,\neffects, params_schema, return_schema, event) declared at top level so\nthe kernel chain planner can route deterministically without\nre-deriving from extension code.",
       "properties": {
         "name": {
           "minLength": 1,
@@ -704,6 +761,21 @@
       "default": null,
       "title": "System"
     },
+    "secrets": {
+      "anyOf": [
+        {
+          "items": {
+            "$ref": "#/$defs/SecretDecl"
+          },
+          "type": "array"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Secrets"
+    },
     "name": {
       "anyOf": [
         {