feat: --hint flag — use kbagent as a Python SDK

[padak]

Summary

• Adds --hint client|service global flag that generates equivalent Python code instead of executing commands
• 47 commands covered across all command groups (config, storage, job, branch, workspace, sharing, component, encrypt, lineage, org, tool)
• Two modes: --hint client (KeboolaClient with explicit URL+token) and --hint service (service layer with CLI config)
• Commands without hints show clear "no hint available" message
• Bypasses permission checks and auto-update in hint mode (no API calls made)
• 26 new tests (renderer, registry, CLI integration, security)

What it looks like

$ kbagent --hint client config list --project myproj
#!/usr/bin/env python3
"""Equivalent of: kbagent config list --project myproj"""

import os
from keboola_agent_cli.client import KeboolaClient

client = KeboolaClient(
    base_url="https://connection.eu-central-1.keboola.com",
    token=os.environ["KBC_STORAGE_TOKEN"],
)
try:
    components = client.list_components()
    print(components)
finally:
    client.close()

New files

• src/keboola_agent_cli/hints/ — models, registry, renderers, 11 definition files
• tests/test_hints.py — 26 tests
• docs/hint-mode.md — user documentation
• plugins/.../references/programming-with-cli.md — SDK programming guide

Test plan

• make check passes (1543 tests, 0 failures)
• --hint client generates valid Python (compile() check)
• --hint service generates ConfigStore code with explicit config_dir
• Invalid --hint value shows usage help
• Commands without hints show "no hint available"
• No real tokens in generated code
• Permission-blocked commands still generate hints
• Auto-update skipped in hint mode