giga-sdk 0.7.1__tar.gz

giga_sdk-0.7.1/.github/workflows/pypi-release.yml

@@ -0,0 +1,40 @@
+name: Publish giga-sdk to PyPI
+
+# Runs in the Giga-customers/giga-sdk mirror repo (this file is synced there by
+# trillions' publish-giga-sdk.yml). A version bump in giga/__about__.py pushes a
+# matching `v*` tag to the mirror, which triggers this workflow.
+#
+# Publishing is tokenless via PyPI Trusted Publishing (OIDC). The registered
+# publisher on pypi.org must match: owner Giga-customers, repo giga-sdk,
+# workflow pypi-release.yml, environment pypi.
+#
+# Targets real PyPI (pypi.org). To dry-run against TestPyPI instead, set
+# `environment: testpypi` and add `repository-url: https://test.pypi.org/legacy/`
+# to the publish step, and register the matching publisher on test.pypi.org.
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # required for Trusted Publishing (OIDC); no secrets used
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

giga_sdk-0.7.1/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+.venv/
+venv/
+*.egg-info/
+.pytest_cache/
+dist/
+build/
+.claude/settings.local.json
+.entire/

giga_sdk-0.7.1/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: giga-sdk
+Version: 0.7.1
+Summary: Giga SDK and CLI — agent building framework with command-line tools
+Project-URL: Homepage, https://giga.ai
+Project-URL: Documentation, https://docs.giga.ai
+Project-URL: Repository, https://github.com/Giga-customers/giga-sdk
+Author-email: Giga Team <support@gigaml.com>
+License: MIT
+Keywords: agents,ai,cli,framework,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: click<9,>=8.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: packaging>=21.0
+Requires-Dist: phonenumbers<9,>=8.13
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer<0.26,>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Giga SDK
+
+Agent building framework and CLI for the Giga platform.
+
+## Installation
+
+```bash
+pip install giga-sdk
+```
+
+## Requirements
+
+- Python >= 3.12
+
+## CLI
+
+After installation, the `giga` CLI is available:
+
+```bash
+giga --help
+giga login
+giga validate
+giga whoami
+```
+
+## SDK
+
+Create an agent, give it a typed variable store, and register hooks and code blocks
+with decorators:
+
+```python
+from pydantic import BaseModel
+from giga import Agent, CodeBlockResult
+
+class Variables(BaseModel):
+    guest_name: str | None = None
+
+agent = Agent(name="my-agent", store=Variables)
+
+@agent.initialization
+def init(initialization_values, store):
+    return {"guest_name": "Unknown"}
+
+@agent.code_block(description="Greet the user")
+def greet(name: str, store) -> CodeBlockResult:
+    return CodeBlockResult(
+        message=f"Hello {name}!",
+        store_updates={"guest_name": name},
+    )
+```
+
+You can also define API actions and post-conversation hooks:
+
+```python
+from giga import api
+from giga.types import ResolutionResult, Analysis
+
+get_user = api(
+    name="get_user",
+    description="Get user info",
+    method="GET",
+    url="https://api.example.com/users/{id}",
+)
+
+@agent.post_conversation
+def post_conversation(resolution_result: ResolutionResult, analysis: Analysis):
+    if resolution_result.resolution_status == "resolved":
+        print(f"Resolved: {analysis.summary}")
+```

giga_sdk-0.7.1/README.md

@@ -0,0 +1,69 @@
+# Giga SDK
+
+Agent building framework and CLI for the Giga platform.
+
+## Installation
+
+```bash
+pip install giga-sdk
+```
+
+## Requirements
+
+- Python >= 3.12
+
+## CLI
+
+After installation, the `giga` CLI is available:
+
+```bash
+giga --help
+giga login
+giga validate
+giga whoami
+```
+
+## SDK
+
+Create an agent, give it a typed variable store, and register hooks and code blocks
+with decorators:
+
+```python
+from pydantic import BaseModel
+from giga import Agent, CodeBlockResult
+
+class Variables(BaseModel):
+    guest_name: str | None = None
+
+agent = Agent(name="my-agent", store=Variables)
+
+@agent.initialization
+def init(initialization_values, store):
+    return {"guest_name": "Unknown"}
+
+@agent.code_block(description="Greet the user")
+def greet(name: str, store) -> CodeBlockResult:
+    return CodeBlockResult(
+        message=f"Hello {name}!",
+        store_updates={"guest_name": name},
+    )
+```
+
+You can also define API actions and post-conversation hooks:
+
+```python
+from giga import api
+from giga.types import ResolutionResult, Analysis
+
+get_user = api(
+    name="get_user",
+    description="Get user info",
+    method="GET",
+    url="https://api.example.com/users/{id}",
+)
+
+@agent.post_conversation
+def post_conversation(resolution_result: ResolutionResult, analysis: Analysis):
+    if resolution_result.resolution_status == "resolved":
+        print(f"Resolved: {analysis.summary}")
+```

giga_sdk-0.7.1/giga/__about__.py

@@ -0,0 +1,3 @@
+"""Version information for giga-sdk."""
+
+VERSION = "0.7.1"

giga_sdk-0.7.1/giga/__init__.py

@@ -0,0 +1,117 @@
+"""
+Giga SDK - Agent building framework for git-based configuration.
+
+This SDK is bundled with exported agent repositories and provides:
+- Agent class with decorators for hooks and code blocks
+- Context for accessing variable store during execution
+- CodeBlockResult for returning results from code blocks
+- api() function for defining API actions
+- Type definitions for hook parameters (ResolutionResult, Analysis, Event, etc.)
+
+Usage:
+    from giga import Agent, Context, CodeBlockResult, api
+    from giga.types import ResolutionResult, Analysis, Event, CallData
+
+    class Variables(BaseModel):
+        guest_name: str = None
+
+    agent = Agent(name="my-agent", store=Variables)
+
+    @agent.initialization
+    def init(initialization_values, store):
+        return {"guest_name": "Unknown"}
+
+    @agent.post_conversation
+    def post_conversation(
+        resolution_result: ResolutionResult,
+        analysis: Analysis,
+        tags: list[str],
+        custom_fields: list,
+        call_data: CallData,
+        events: list[Event],
+    ):
+        # The final variable store snapshot lives on the most recent message
+        # that carries one — scan from the end (the last message can be a
+        # tool response or system event without a snapshot). Use
+        # ``is not None`` so an empty-dict snapshot still counts as the
+        # latest state instead of being skipped for a stale earlier one.
+        final_store = next(
+            (
+                m["variable_store"]
+                for m in reversed(call_data.get("messages") or [])
+                if m.get("variable_store") is not None
+            ),
+            {},
+        )
+        guest_name = final_store.get("guest_name")
+        # Access typed parameters with intellisense
+        if resolution_result.resolution_status == "resolved":
+            print(f"Resolved: {analysis.summary}")
+
+    @agent.code_block(description="Greet the user")
+    def greet(name: str, store) -> CodeBlockResult:
+        return CodeBlockResult(
+            message=f"Hello {name}!",
+            store_updates={"guest_name": name}
+        )
+
+    # Define API actions
+    get_user = api(
+        name="get_user",
+        description="Get user info",
+        method="GET",
+        url="https://api.example.com/users/{id}"
+    )
+"""
+
+from .agent import Agent
+from .api import ApiAction, api
+from .code_block import CodeBlockResult, code_block
+from .context import Context
+from .types import (
+    Analysis,
+    CallData,
+    CustomFields,
+    CustomFieldType,
+    CustomFieldValue,
+    Event,
+    Events,
+    EventType,
+    # Logger
+    Logger,
+    Message,
+    # Models
+    ResolutionResult,
+    ResolutionStatus,
+    # Enums
+    Sentiment,
+    # Type aliases
+    Tags,
+    logger,
+)
+
+__all__ = [
+    "Agent",
+    "Analysis",
+    "ApiAction",
+    "CallData",
+    "CodeBlockResult",
+    "Context",
+    "CustomFieldType",
+    "CustomFieldValue",
+    "CustomFields",
+    "Event",
+    "EventType",
+    "Events",
+    "Logger",
+    "Message",
+    "ResolutionResult",
+    "ResolutionStatus",
+    "Sentiment",
+    "Tags",
+    "api",
+    "code_block",
+    "logger",
+]
+
+from giga.__about__ import VERSION as __version__