hikigai-appsdk 0.0.9__tar.gz

hikigai_appsdk-0.0.9/.gitignore

@@ -0,0 +1,85 @@
+# Dependencies
+node_modules/
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+*.so
+.eggs/
+*.egg-info/
+.venv/
+venv/
+# ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Build outputs
+.next/
+out/
+dist/
+build/
+*.egg
+
+# Environment files
+**/.env*
+!**/.env.example
+SONA/sona_venv/
+
+# Credentials and secrets
+# *-key.json
+# gcp-key.json
+/backend/gcp-key.json
+
+*.pem
+!backend/global-bundle.pem
+*.key
+
+# Database files
+*.sqlite
+*.sqlite3
+*.db
+
+# Logs
+*.log
+logs/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.tox/
+.nox/
+coverage.xml
+*.cover
+
+# Docker
+.docker/
+docker-compose.yml
+
+# Terraform
+*.tfstate
+*.tfstate.*
+.terraform/
+*.tfvars
+
+# Misc
+*.bak
+*.tmp
+.cache/
+.claude/
+AWSCLIV2.pkg
+
+# Claude Flow AgentDB (MCP runtime artifacts)
+agentdb.rvf
+agentdb.rvf.lock
+
+# TypeScript build cache
+tsconfig.tsbuildinfo

hikigai_appsdk-0.0.9/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hikigai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hikigai_appsdk-0.0.9/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: hikigai-appsdk
+Version: 0.0.9
+Summary: Official Python SDK for integrating and invoking HIPAA-compliant AI agents from any application on the Hikigai healthcare platform. Provides session management, streaming invocation, BYOK model keys, MCP connector credentials, and real-time agent response handling for App Developers.
+Project-URL: Homepage, https://hikigai.ai
+Author-email: Sai Daya Shankar <sshankar@hikigai.ai>
+License: MIT License
+        
+        Copyright (c) 2026 Hikigai
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agents,ai,hikigai,invocation,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: hikigai-core<0.2.0,>=0.1.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# hikigai-appsdk
+
+Python SDK for invoking AI agents in your applications.
+
+## Installation
+
+> **Note:** The Hikigai SDKs are currently published to [Test PyPI](https://test.pypi.org) while in early access.
+> Do **not** run the SDK from the repository source directly — the `hikigai.core` namespace package
+> must be installed to resolve correctly. Always install via the commands below.
+
+```bash
+# Using pip
+pip install \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ \
+  hikigai-appsdk==0.0.1
+```
+
+This will automatically install `hikigai-core` (the shared namespace dependency) alongside
+`hikigai-appsdk`.
+
+Once released on the main PyPI index, installation will simplify to:
+
+```bash
+# Future release (main PyPI)
+pip install hikigai-appsdk
+```
+
+## Quick Start
+
+### Using the SDK (Recommended)
+
+```python
+from hikigai.appsdk import AppClient
+
+# Initialize client
+client = AppClient(
+    api_key="your-api-key",
+    project_id="your-project-id"
+)
+
+# Get an agent
+agent = client.agent("medical-coder")
+
+# Invoke the agent
+response = agent.invoke("Patient presents with fever and cough...")
+print(response.content)
+
+# Stream responses
+for chunk in agent.stream("Tell me a story"):
+    print(chunk, end="")
+
+# Session-based conversations
+session_agent = agent.with_session("user-123")
+session_agent.invoke("What is diabetes?")
+session_agent.invoke("How is it treated?")  # Remembers context
+```
+
+### Using Direct API (Advanced)
+
+For custom integrations or when you need direct HTTP control:
+
+**Step 1: Exchange API Key for Session Token**
+
+```bash
+curl --location --request POST 'http://localhost:8000/api/v1/auth/exchange' \
+--header 'X-API-Key: your_api_key_here' \
+--header 'Content-Type: application/json'
+```
+
+**Step 2: Invoke Agent via API**
+
+```python
+import requests
+import os
+from datetime import datetime, timedelta
+
+class HikigaiAPIClient:
+    def __init__(self, api_key: str, base_url: str = "http://localhost:8000"):
+        self.api_key = api_key
+        self.base_url = base_url
+        self.access_token = None
+        self.token_expiry = None
+    
+    def exchange_api_key(self):
+        """Exchange API Key for session token."""
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+        response = requests.post(
+            f"{self.base_url}/api/v1/auth/exchange",
+            headers=headers
+        )
+        response.raise_for_status()
+        data = response.json()
+        
+        self.access_token = data["access_token"]
+        self.token_expiry = datetime.utcnow() + timedelta(seconds=data["expires_in"] - 300)
+        return data
+    
+    def ensure_token_valid(self):
+        """Refresh token if needed."""
+        if not self.access_token or datetime.utcnow() >= self.token_expiry:
+            self.exchange_api_key()
+    
+    def invoke_agent(self, agent_id: str, message: str, session_id: str = None) -> dict:
+        """Invoke an agent via API."""
+        self.ensure_token_valid()
+        headers = {
+            "Authorization": f"Bearer {self.access_token}",
+            "Content-Type": "application/json"
+        }
+        payload = {
+            "message": message,
+            "stream": False,
+        }
+        if session_id:
+            payload["session_id"] = session_id
+        
+        response = requests.post(
+            f"{self.base_url}/api/v1/agents/{agent_id}/invoke",
+            headers=headers,
+            json=payload
+        )
+        response.raise_for_status()
+        return response.json()
+
+# Usage with context manager
+class HikigaiAPIClientContext:
+    def __init__(self, api_key: str):
+        self.client = HikigaiAPIClient(api_key)
+    
+    def __enter__(self):
+        self.client.exchange_api_key()
+        return self.client
+    
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass
+
+# Invoke agent
+with HikigaiAPIClientContext(api_key=os.environ["HIKIGAI_API_KEY"]) as client:
+    result = client.invoke_agent(
+        agent_id="medical-coder",
+        message="Patient presents with fever and cough...",
+        session_id="user-123"
+    )
+    print(result["content"])
+```
+
+For complete API documentation, see the [Python AppSDK Docs](../docs/sdk/appsdk.md#direct-api-methods).
+
+## Features
+
+- 🚀 **Simple Invocation**: Call agents with a single method
+- 📡 **Streaming**: Real-time streaming responses
+- 💬 **Sessions**: Multi-turn conversations with context
+- ⚡ **Async Support**: Built-in async/await support (coming soon)
+- 🔍 **Agent Discovery**: List and search available agents
+- 📊 **Metadata**: Access performance metrics and status
+
+## Documentation
+
+Full documentation: https://docs.hikigai.com/appsdk
+
+## License
+
+MIT
+

hikigai_appsdk-0.0.9/README.md

@@ -0,0 +1,166 @@
+# hikigai-appsdk
+
+Python SDK for invoking AI agents in your applications.
+
+## Installation
+
+> **Note:** The Hikigai SDKs are currently published to [Test PyPI](https://test.pypi.org) while in early access.
+> Do **not** run the SDK from the repository source directly — the `hikigai.core` namespace package
+> must be installed to resolve correctly. Always install via the commands below.
+
+```bash
+# Using pip
+pip install \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ \
+  hikigai-appsdk==0.0.1
+```
+
+This will automatically install `hikigai-core` (the shared namespace dependency) alongside
+`hikigai-appsdk`.
+
+Once released on the main PyPI index, installation will simplify to:
+
+```bash
+# Future release (main PyPI)
+pip install hikigai-appsdk
+```
+
+## Quick Start
+
+### Using the SDK (Recommended)
+
+```python
+from hikigai.appsdk import AppClient
+
+# Initialize client
+client = AppClient(
+    api_key="your-api-key",
+    project_id="your-project-id"
+)
+
+# Get an agent
+agent = client.agent("medical-coder")
+
+# Invoke the agent
+response = agent.invoke("Patient presents with fever and cough...")
+print(response.content)
+
+# Stream responses
+for chunk in agent.stream("Tell me a story"):
+    print(chunk, end="")
+
+# Session-based conversations
+session_agent = agent.with_session("user-123")
+session_agent.invoke("What is diabetes?")
+session_agent.invoke("How is it treated?")  # Remembers context
+```
+
+### Using Direct API (Advanced)
+
+For custom integrations or when you need direct HTTP control:
+
+**Step 1: Exchange API Key for Session Token**
+
+```bash
+curl --location --request POST 'http://localhost:8000/api/v1/auth/exchange' \
+--header 'X-API-Key: your_api_key_here' \
+--header 'Content-Type: application/json'
+```
+
+**Step 2: Invoke Agent via API**
+
+```python
+import requests
+import os
+from datetime import datetime, timedelta
+
+class HikigaiAPIClient:
+    def __init__(self, api_key: str, base_url: str = "http://localhost:8000"):
+        self.api_key = api_key
+        self.base_url = base_url
+        self.access_token = None
+        self.token_expiry = None
+    
+    def exchange_api_key(self):
+        """Exchange API Key for session token."""
+        headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
+        response = requests.post(
+            f"{self.base_url}/api/v1/auth/exchange",
+            headers=headers
+        )
+        response.raise_for_status()
+        data = response.json()
+        
+        self.access_token = data["access_token"]
+        self.token_expiry = datetime.utcnow() + timedelta(seconds=data["expires_in"] - 300)
+        return data
+    
+    def ensure_token_valid(self):
+        """Refresh token if needed."""
+        if not self.access_token or datetime.utcnow() >= self.token_expiry:
+            self.exchange_api_key()
+    
+    def invoke_agent(self, agent_id: str, message: str, session_id: str = None) -> dict:
+        """Invoke an agent via API."""
+        self.ensure_token_valid()
+        headers = {
+            "Authorization": f"Bearer {self.access_token}",
+            "Content-Type": "application/json"
+        }
+        payload = {
+            "message": message,
+            "stream": False,
+        }
+        if session_id:
+            payload["session_id"] = session_id
+        
+        response = requests.post(
+            f"{self.base_url}/api/v1/agents/{agent_id}/invoke",
+            headers=headers,
+            json=payload
+        )
+        response.raise_for_status()
+        return response.json()
+
+# Usage with context manager
+class HikigaiAPIClientContext:
+    def __init__(self, api_key: str):
+        self.client = HikigaiAPIClient(api_key)
+    
+    def __enter__(self):
+        self.client.exchange_api_key()
+        return self.client
+    
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass
+
+# Invoke agent
+with HikigaiAPIClientContext(api_key=os.environ["HIKIGAI_API_KEY"]) as client:
+    result = client.invoke_agent(
+        agent_id="medical-coder",
+        message="Patient presents with fever and cough...",
+        session_id="user-123"
+    )
+    print(result["content"])
+```
+
+For complete API documentation, see the [Python AppSDK Docs](../docs/sdk/appsdk.md#direct-api-methods).
+
+## Features
+
+- 🚀 **Simple Invocation**: Call agents with a single method
+- 📡 **Streaming**: Real-time streaming responses
+- 💬 **Sessions**: Multi-turn conversations with context
+- ⚡ **Async Support**: Built-in async/await support (coming soon)
+- 🔍 **Agent Discovery**: List and search available agents
+- 📊 **Metadata**: Access performance metrics and status
+
+## Documentation
+
+Full documentation: https://docs.hikigai.com/appsdk
+
+## License
+
+MIT
+

hikigai_appsdk-0.0.9/examples/invoke_agent.py

@@ -0,0 +1,49 @@
+"""
+Example: Invoke agents with AppSDK
+"""
+
+import os
+from hikigai.appsdk import AppClient
+
+# Initialize client
+client = AppClient(
+    api_key=os.environ["HIKIGAI_API_KEY"],
+    project_id=os.environ["HIKIGAI_PROJECT_ID"],
+)
+
+# Get an agent
+agent = client.agent("medical-coder")
+
+print(f"📡 Invoking agent: {agent.name}")
+
+# Simple invocation
+clinical_note = """
+Patient: John Doe, Age 45
+Chief Complaint: Persistent cough and fever for 3 days
+Vital Signs: Temp 101.2°F, BP 130/80, HR 88
+Diagnosis: Acute bronchitis
+Plan: Prescribed antibiotics, rest, fluids
+"""
+
+response = agent.invoke(clinical_note)
+
+print("\n✅ Response received:")
+print(f"  Content: {response.content}")
+print(f"  Latency: {response.latency_ms}ms")
+print(f"  Tokens: {response.tokens_used}")
+
+# Streaming example
+print("\n📡 Streaming response:")
+for chunk in agent.stream("Explain the difference between ICD-10 and CPT codes"):
+    print(chunk, end="", flush=True)
+print()
+
+# Session-based conversation
+print("\n💬 Session-based conversation:")
+session_agent = agent.with_session("user-123")
+
+response1 = session_agent.invoke("What is diabetes?")
+print(f"Q1: {response1.content[:100]}...")
+
+response2 = session_agent.invoke("How is it treated?")  # Remembers context
+print(f"Q2: {response2.content[:100]}...")

hikigai_appsdk-0.0.9/generate_llms_files.py

@@ -0,0 +1,40 @@
+import os
+
+def main():
+    base_dir = r"c:\Users\riyan\Desktop\hikigai-platform\AppSDK"
+    appsdk_dir = os.path.join(base_dir, "hikigai", "appsdk")
+    
+    files_to_concat = [
+        os.path.join(appsdk_dir, "__init__.py"),
+        os.path.join(appsdk_dir, "client.py"),
+        os.path.join(appsdk_dir, "models", "agent.py"),
+        os.path.join(appsdk_dir, "models", "response.py"),
+        os.path.join(appsdk_dir, "sona.py")
+    ]
+    
+    output_lines = []
+    
+    for fpath in files_to_concat:
+        try:
+            with open(fpath, "r", encoding="utf-8") as f:
+                content = f.read()
+                # Get relative path for cleaner headers
+                rel_path = os.path.relpath(fpath, base_dir)
+                # Ensure backslashes are converted to forward slashes for cross-platform readability
+                rel_path = rel_path.replace("\\", "/")
+                
+                header = f"\n\n{'='*80}\nFile: {rel_path}\n{'='*80}\n\n"
+                output_lines.append(header + content)
+        except Exception as e:
+            print(f"Error reading {fpath}: {e}")
+            
+    out_path = os.path.join(base_dir, "llms-full.txt")
+    with open(out_path, "w", encoding="utf-8") as f:
+        # Avoid leading newlines on the first file
+        full_content = "".join(output_lines).strip()
+        f.write(full_content + "\n")
+        
+    print(f"Successfully generated {out_path} with {len(full_content)} characters")
+
+if __name__ == "__main__":
+    main()

hikigai_appsdk-0.0.9/hikigai/__init__.py

@@ -0,0 +1,2 @@
+# Hikigai namespace package
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

hikigai_appsdk-0.0.9/hikigai/appsdk/__init__.py

@@ -0,0 +1,43 @@
+"""
+hikigai-appsdk: Python SDK for invoking AI agents.
+
+Invoke deployed agents in your applications.
+"""
+
+__version__ = "0.0.6"
+
+from hikigai.appsdk.client import AppClient
+from hikigai.appsdk.models import (
+    RuntimeAgent,
+    InvokeResponse,
+    StreamChunk,
+)
+from hikigai.appsdk.streaming.session import StreamSession
+
+# Re-export common exceptions from core
+from hikigai.core.exceptions import (
+    HikigaiError,
+    AuthenticationError,
+    RateLimitError,
+    AgentNotFoundError,
+    InvocationError,
+    ConfigurationError,
+)
+
+__all__ = [
+    "__version__",
+    # Client
+    "AppClient",
+    # Models
+    "RuntimeAgent",
+    "InvokeResponse",
+    "StreamChunk",
+    "StreamSession",
+    # Exceptions
+    "HikigaiError",
+    "AuthenticationError",
+    "RateLimitError",
+    "AgentNotFoundError",
+    "InvocationError",
+    "ConfigurationError",
+]