Federal Extension Contract

from imperal_sdk import Extension

ext = Extension(
    "my-app",                                          # internal name
    version="1.0.0",
    display_name="My App",                             # V15: ≥3 chars, ≠ app_id
    description=(                                      # V14: ≥40 chars
        "Sentence describing what the extension does, "
        "shown in Webbee's 'what I can do' capability list."
    ),
    icon="icon.svg",                                   # V21: required SVG
    actions_explicit=True,                             # V19: federal default
    capabilities=["my-app:read", "my-app:write"],
)

from imperal_sdk import ChatExtension, ActionResult
from .schemas import NoteIdParams

@chat.function(
    "delete_note",                                    # explicit name
    action_type="destructive",
    description="Delete a note (moves to trash, restorable for 30 days).",  # V16: ≥20 chars
    chain_callable=True,                              # V19: required for write/destructive
    effects=["delete:note"],                          # V20: required for write/destructive
)
async def fn_delete_note(ctx, params: NoteIdParams) -> ActionResult:  # V17 + V18
    ...

{
  "manifest_schema_version": 3,
  "name": "notes",
  "display_name": "Notes",
  "description": "Personal notes assistant — create, read, update, delete...",
  "icon": "icon.svg",
  "icon_size_bytes": 510,
  "actions_explicit": true,
  "capabilities": ["notes:read", "notes:write"],
  "tools": [
    {
      "name": "delete_note",
      "description": "Delete a note (moves to trash).",
      "action_type": "destructive",
      "chain_callable": true,
      "effects": ["delete:note"],
      "params_schema": { "type": "object", "properties": { "note_id": { "type": "string" } }, "required": ["note_id"] },
      "return_schema": { ... },
      "event": "deleted",
      "owner_chat_tool": "tool_notes_chat"
    }
  ],
  "lifecycle_hooks": {
    "on_install":  { "signature": "(ctx, message=None)" },
    "on_refresh":  { "signature": "(ctx, message=None)" }
  }
}

You run: imperal build .   →   imperal validate .
       ↓
SDK runs all 11 validators locally
       ↓
   Any ERROR? → publish refused, list shown
   All pass? → upload the packaged extension at
              panel.imperal.io/developer (drag-and-drop)
       ↓
Dev Portal re-runs validators server-side (defense in depth)
       ↓
Marketplace listing created / updated