stkai 0.3.0__tar.gz → 0.3.2__tar.gz

{stkai-0.3.0/src/stkai.egg-info → stkai-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stkai
-Version: 0.3.0
+Version: 0.3.2
 Summary: Python SDK for StackSpot AI - Remote Quick Commands and more
 Author-email: Rafael Ponte <rponte@gmail.com>
 License: Apache-2.0

{stkai-0.3.0 → stkai-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stkai"
-version = "0.3.0"
+version = "0.3.2"
 description = "Python SDK for StackSpot AI - Remote Quick Commands and more"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{stkai-0.3.0 → stkai-0.3.2}/src/stkai/__init__.py

@@ -84,6 +84,7 @@ from stkai._config import (
     RateLimitConfig,
     RateLimitStrategy,
     RqcConfig,
+    SdkConfig,
     STKAIConfig,
 )
 from stkai._http import (
@@ -114,6 +115,7 @@ __all__ = [
     # Configuration
     "STKAI",
     "STKAIConfig",
+    "SdkConfig",
     "ConfigEntry",
     "AuthConfig",
     "RqcConfig",

{stkai-0.3.0 → stkai-0.3.2}/src/stkai/_config.py

@@ -103,6 +103,46 @@ class OverridableConfig:
 # =============================================================================
 
 
+@dataclass(frozen=True)
+class SdkConfig:
+    """
+    SDK metadata (read-only, not configurable).
+
+    Provides information about the SDK version and runtime environment.
+    These values are automatically detected and cannot be overridden.
+
+    Attributes:
+        version: The installed SDK version.
+        cli_mode: Whether StackSpot CLI (oscli) is available.
+
+    Example:
+        >>> from stkai import STKAI
+        >>> STKAI.config.sdk.version
+        '0.2.8'
+        >>> STKAI.config.sdk.cli_mode
+        True
+    """
+
+    version: str
+    cli_mode: bool
+
+    @classmethod
+    def detect(cls) -> SdkConfig:
+        """
+        Detect SDK metadata from the runtime environment.
+
+        Returns:
+            SdkConfig with version and cli_mode auto-detected.
+        """
+        from stkai import __version__
+        from stkai._cli import StkCLI
+
+        return cls(
+            version=__version__,
+            cli_mode=StkCLI.is_available(),
+        )
+
+
 @dataclass(frozen=True)
 class AuthConfig(OverridableConfig):
     """
@@ -566,10 +606,11 @@ class STKAIConfig:
     """
     Global configuration for the stkai SDK.
 
-    Aggregates all configuration sections: auth, rqc, agent, and rate_limit.
+    Aggregates all configuration sections: sdk, auth, rqc, agent, and rate_limit.
     Access via the global `STKAI.config` property.
 
     Attributes:
+        sdk: SDK metadata (version, cli_mode). Read-only.
         auth: Authentication configuration.
         rqc: RemoteQuickCommand configuration.
         agent: Agent configuration.
@@ -577,6 +618,10 @@ class STKAIConfig:
 
     Example:
         >>> from stkai import STKAI
+        >>> STKAI.config.sdk.version
+        '0.2.8'
+        >>> STKAI.config.sdk.cli_mode
+        True
         >>> STKAI.config.rqc.request_timeout
         30
         >>> STKAI.config.auth.has_credentials()
@@ -585,6 +630,7 @@ class STKAIConfig:
         False
     """
 
+    sdk: SdkConfig = field(default_factory=SdkConfig.detect)
     auth: AuthConfig = field(default_factory=AuthConfig)
     rqc: RqcConfig = field(default_factory=RqcConfig)
     agent: AgentConfig = field(default_factory=AgentConfig)
@@ -609,6 +655,7 @@ class STKAIConfig:
             >>> final = custom.with_env_vars()
         """
         return STKAIConfig(
+            sdk=self.sdk,
             auth=self.auth.with_overrides(_get_auth_from_env()),
             rqc=self.rqc.with_overrides(_get_rqc_from_env()),
             agent=self.agent.with_overrides(_get_agent_from_env()),
@@ -637,6 +684,7 @@ class STKAIConfig:
             cli_rqc_overrides["base_url"] = cli_base_url
 
         return STKAIConfig(
+            sdk=self.sdk,
             auth=self.auth,
             rqc=self.rqc.with_overrides(cli_rqc_overrides),
             agent=self.agent,
@@ -675,6 +723,7 @@ class STKAIConfig:
             ... )
         """
         return STKAIConfig(
+            sdk=self.sdk,
             auth=self.auth.with_overrides(auth or {}),
             rqc=self.rqc.with_overrides(rqc or {}),
             agent=self.agent.with_overrides(agent or {}),
@@ -701,6 +750,12 @@ class STKAIConfig:
         """
         result: dict[str, list[ConfigEntry]] = {}
 
+        # SDK section (read-only, not tracked)
+        result["sdk"] = [
+            ConfigEntry(name=f.name, value=getattr(self.sdk, f.name), source="-")
+            for f in fields(self.sdk)
+        ]
+
         for section_name in ("auth", "rqc", "agent", "rate_limit"):
             section_config = getattr(self, section_name)
             section_sources = self._tracker.sources.get(section_name, {})
@@ -970,7 +1025,7 @@ class _STKAI:
             for entry in entries:
                 dots = "." * (name_width - len(entry.name))
                 value_padded = entry.formatted_value.ljust(value_width)
-                marker = "✎" if entry.source != "default" else " "
+                marker = "✎" if entry.source not in ("default", "-") else " "
                 output(f"  {entry.name} {dots} {value_padded} {marker} {entry.source}")
 
         output("=" * total_width)

{stkai-0.3.0 → stkai-0.3.2/src/stkai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stkai
-Version: 0.3.0
+Version: 0.3.2
 Summary: Python SDK for StackSpot AI - Remote Quick Commands and more
 Author-email: Rafael Ponte <rponte@gmail.com>
 License: Apache-2.0