hyperpocket 0.0.2__tar.gz → 0.1.8__tar.gz

hyperpocket-0.1.8/.gitignore

@@ -0,0 +1,157 @@
+.vs/
+.vscode/
+.idea/
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Google GitHub Actions credentials files created by:
+# https://github.com/google-github-actions/auth
+#
+# That action recommends adding this gitignore to prevent accidentally committing keys.
+gha-creds-*.json
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+
+# Jupyter Notebook
+.ipynb_checkpoints
+notebooks/
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv*
+venv*
+env/
+ENV/
+env.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.mypy_cache_test/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# macOS display setting files
+.DS_Store
+
+# Wandb directory
+wandb/
+
+# asdf tool versions
+.tool-versions
+/.ruff_cache/
+
+*.pkl
+*.bin
+
+# integration test artifacts
+data_map*
+\[('_type', 'fake'), ('stop', None)]
+
+# Replit files
+*replit*
+
+
+prof
+virtualenv/
+
+# Ignore dynaconf secret files
+**/.secrets.toml
+*.xml
+*.iml
+pocket.lock
+.log/
+.pocket/
+_build/

{hyperpocket-0.0.2 → hyperpocket-0.1.8}/PKG-INFO

@@ -1,31 +1,26 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: hyperpocket
-Version: 0.0.2
+Version: 0.1.8
 Summary: Building AI agent with hyperpocket tool in a flash
-Home-page: https://vessl-ai.github.io/hyperpocket
-Author: VESSL AI Devs
-Author-email: dev@vessl.ai
-Requires-Python: >=3.11,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: click (>=8.1.7,<9.0.0)
-Requires-Dist: dynaconf (>=3.2.6,<4.0.0)
-Requires-Dist: fastapi (>=0.115.5,<0.116.0)
-Requires-Dist: gitpython (>=3.1.43,<4.0.0)
-Requires-Dist: httpx (==0.27)
-Requires-Dist: jinja2 (>=3.1.4,<4.0.0)
-Requires-Dist: multiprocess (>=0.70.17,<0.71.0)
-Requires-Dist: playwright (>=1.49.0,<2.0.0)
-Requires-Dist: pydantic (>=2.10.2,<3.0.0)
-Requires-Dist: pygithub (>=2.5.0,<3.0.0)
-Requires-Dist: python-multipart (>=0.0.19,<0.0.20)
-Requires-Dist: redis (>=5.2.1,<6.0.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: toml (>=0.10.2,<0.11.0)
-Requires-Dist: uvicorn (>=0.32.1,<0.33.0)
+Project-URL: Homepage, https://vessl-ai.github.io/hyperpocket
 Project-URL: Repository, https://github.com/vessl-ai/hyperpocket
+Author-email: VESSL AI Devs <dev@vessl.ai>
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.7
+Requires-Dist: dynaconf>=3.2.6
+Requires-Dist: fastapi>=0.115.5
+Requires-Dist: gitpython>=3.1.43
+Requires-Dist: httpx==0.27
+Requires-Dist: jinja2>=3.1.4
+Requires-Dist: multiprocess>=0.70.17
+Requires-Dist: playwright>=1.49.0
+Requires-Dist: pydantic>=2.10.2
+Requires-Dist: pygithub>=2.5.0
+Requires-Dist: python-multipart>=0.0.19
+Requires-Dist: redis>=5.2.1
+Requires-Dist: requests>=2.32.3
+Requires-Dist: toml>=0.10.2
+Requires-Dist: uvicorn>=0.32.1
 Description-Content-Type: text/markdown
 
 # Pocket 👛
@@ -59,10 +54,10 @@ with the dependency spaghetti.
 
 ## Installation
 
-1. install pocket
+1. install hyperpocket
 
 ```bash
-pip install pocket
+pip install hyperpocket
 ```
 
 2. install playwright
@@ -87,17 +82,15 @@ Or just use LLM API Clients out of the box.
 ### Using out-of-the-box tools
 
 ```python
+from hyperpocket.tool import from_git
 from langchain_openai import ChatOpenAI
 
-import hyperpocket as pk
-import hyperpocket.curated_tools
-from pocket_langchain import PocketLangchain
+from hyperpocket_langchain import PocketLangchain
 
 pklc = PocketLangchain(
     tools=[
-        *pk.curated_tools.SLACK,  # SLACK = [slack_get_message, slack_post_message, ..]
-        *pk.curated_tools.LINEAR,
-        "https://github.com/my-org/some-awesome-tool",
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/get-message"),
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/post-message"),
     ]
 )
 tools = pklc.get_tools()
@@ -116,40 +109,38 @@ Pocket provides way to use end user auth easily.
 
 - Supported methods
 
-    - [x] OAuth
-    - [x] Token
-    - [ ] Basic Auth (Username, Password)
+  - [x] OAuth
+  - [x] Token
+  - [ ] Basic Auth (Username, Password)
 
 - Supported OAuth Providers
-    - [x] Google
-    - [x] GitHub
-    - [x] Slack
-    - [x] Linear
-    - [ ] Facebook
-    - [ ] X (Previously Twitter)
-    - [ ] LinkedIn
-    - [ ] Discord
-    - [ ] Zoom
-    - [ ] Microsoft
-    - [ ] Spotify
-    - [ ] Twitch
+  - [x] Google
+  - [x] GitHub
+  - [x] Slack
+  - [x] Linear
+  - [ ] Facebook
+  - [ ] X (Previously Twitter)
+  - [ ] LinkedIn
+  - [ ] Discord
+  - [ ] Zoom
+  - [ ] Microsoft
+  - [ ] Spotify
+  - [ ] Twitch
 
 You can manage your auths in request-wise level. (e.g. you can use different auths for different requests)
 
 ```python
+from hyperpocket.tool import from_git
 from langchain_openai import ChatOpenAI
 from langgraph.graph import StateGraph, START, MessagesState
 from langgraph.prebuilt import tools_condition
 
-import hyperpocket as pk
-import hyperpocket.curated_tools
-from pocket_langgraph import PocketLanggraph
+from hyperpocket_langgraph import PocketLanggraph
 
 pklg = PocketLanggraph(
     tools=[
-        *pk.curated_tools.SLACK,  # SLACK = [slack_get_message, slack_post_message, ..]
-        *pk.curated_tools.LINEAR,
-        "https://github.com/my-org/some-awesome-tool",
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/get-message"),
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/post-message"),
     ],
 )
 llm = ChatOpenAI()
@@ -175,12 +166,12 @@ graph_builder.compile()
 ```
 
 ```python
+from hyperpocket.config import secret
+from hyperpocket.tool import from_git
 from llama_index.core.agent import FunctionCallingAgent
 from llama_index.llms.openai import OpenAI
-from pocket_llamaindex import PocketLlamaindex
 
-from hyperpocket.config import secret
-from hyperpocket.tool import from_git
+from hyperpocket_llamaindex import PocketLlamaindex
 
 llm = OpenAI(api_key=secret["OPENAI_API_KEY"])
 pocket = PocketLlamaindex(
@@ -273,11 +264,11 @@ client_secret = ""  # your github client secret
 
 - While creating your github OAuth app, configuring your app's `Authorization callback URL` is different for your
   development environment and production environment.
-    - For development environment, you can use `http://localhost:8000/auth/github/callback`
-        - **Note**: Default port for pocket dev server is `8000`. If you are using a different port, make sure to
-          replace `8000` with your actual port number.
-    - For production environment, you can use `https://yourdomain.com/auth/github/callback`
-        - **Note**: Make sure to replace `yourdomain.com` with your actual domain name that this app will be hosted on.
+  - For development environment, you can use `http://localhost:8000/auth/github/callback`
+    - **Note**: Default port for pocket dev server is `8000`. If you are using a different port, make sure to
+      replace `8000` with your actual port number.
+  - For production environment, you can use `https://yourdomain.com/auth/github/callback`
+    - **Note**: Make sure to replace `yourdomain.com` with your actual domain name that this app will be hosted on.
 
 #### How to integrate SLACK OAuth app
 
@@ -288,15 +279,53 @@ client_secret = ""  # your github client secret
 - Redirect URLs :
   `{public_server_protocol}://{public_hostname}:[{public_server_port}]/{callback_url_rewrite_prefix}/auth/slack/oauth2/callback`
 - Scopes : What you want to request to user.
-    - Recommended scopes :
-        - channels:history,
-        - channels:read,
-        - chat:write,
-        - groups:history,
-        - groups:read,
-        - im:history,
-        - mpim:history,
-        - reactions:read,
-        - reactions:write,
+  - Recommended scopes :
+    - channels:history,
+    - channels:read,
+    - chat:write,
+    - groups:history,
+    - groups:read,
+    - im:history,
+    - mpim:history,
+    - reactions:read,
+    - reactions:write,
 
 3. Set your Slack APP Client ID / Client Secret in `$HOME/.pocket/settings.toml`
+
+#### How to start adding a new token auth
+
+1. Generate boilerplate codes for token-based auth services ?
+
+```
+# service_name should be lowercase including underscore
+poetry run hyperpocket devtool create-token-auth-template {service_name}
+```
+
+It will generate boilerplate code lines for a new token-based auth service
+
+2. Extend AuthProvider enum to add your new auth provider.
+
+```python
+class AuthProvider(Enum):
+SERVICE = 'service'
+```
+
+3. Specify auth provider for tools
+
+1) github repo or local
+
+```toml
+[auth]
+auth_provider = "{service_name}"
+auth_handler = "{service_name}-token"
+scopes = []
+```
+
+2. function_tool
+
+```python
+@function_tool(
+    auth_provider=AuthProvider.SERVICE
+)
+def my_function(**kwargs):
+```

{hyperpocket-0.0.2 → hyperpocket-0.1.8}/README.md

@@ -29,10 +29,10 @@ with the dependency spaghetti.
 
 ## Installation
 
-1. install pocket
+1. install hyperpocket
 
 ```bash
-pip install pocket
+pip install hyperpocket
 ```
 
 2. install playwright
@@ -57,17 +57,15 @@ Or just use LLM API Clients out of the box.
 ### Using out-of-the-box tools
 
 ```python
+from hyperpocket.tool import from_git
 from langchain_openai import ChatOpenAI
 
-import hyperpocket as pk
-import hyperpocket.curated_tools
-from pocket_langchain import PocketLangchain
+from hyperpocket_langchain import PocketLangchain
 
 pklc = PocketLangchain(
     tools=[
-        *pk.curated_tools.SLACK,  # SLACK = [slack_get_message, slack_post_message, ..]
-        *pk.curated_tools.LINEAR,
-        "https://github.com/my-org/some-awesome-tool",
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/get-message"),
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/post-message"),
     ]
 )
 tools = pklc.get_tools()
@@ -86,40 +84,38 @@ Pocket provides way to use end user auth easily.
 
 - Supported methods
 
-    - [x] OAuth
-    - [x] Token
-    - [ ] Basic Auth (Username, Password)
+  - [x] OAuth
+  - [x] Token
+  - [ ] Basic Auth (Username, Password)
 
 - Supported OAuth Providers
-    - [x] Google
-    - [x] GitHub
-    - [x] Slack
-    - [x] Linear
-    - [ ] Facebook
-    - [ ] X (Previously Twitter)
-    - [ ] LinkedIn
-    - [ ] Discord
-    - [ ] Zoom
-    - [ ] Microsoft
-    - [ ] Spotify
-    - [ ] Twitch
+  - [x] Google
+  - [x] GitHub
+  - [x] Slack
+  - [x] Linear
+  - [ ] Facebook
+  - [ ] X (Previously Twitter)
+  - [ ] LinkedIn
+  - [ ] Discord
+  - [ ] Zoom
+  - [ ] Microsoft
+  - [ ] Spotify
+  - [ ] Twitch
 
 You can manage your auths in request-wise level. (e.g. you can use different auths for different requests)
 
 ```python
+from hyperpocket.tool import from_git
 from langchain_openai import ChatOpenAI
 from langgraph.graph import StateGraph, START, MessagesState
 from langgraph.prebuilt import tools_condition
 
-import hyperpocket as pk
-import hyperpocket.curated_tools
-from pocket_langgraph import PocketLanggraph
+from hyperpocket_langgraph import PocketLanggraph
 
 pklg = PocketLanggraph(
     tools=[
-        *pk.curated_tools.SLACK,  # SLACK = [slack_get_message, slack_post_message, ..]
-        *pk.curated_tools.LINEAR,
-        "https://github.com/my-org/some-awesome-tool",
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/get-message"),
+        from_git("https://github.com/vessl-ai/hyperawesometools", "main", "managed-tools/slack/post-message"),
     ],
 )
 llm = ChatOpenAI()
@@ -145,12 +141,12 @@ graph_builder.compile()
 ```
 
 ```python
+from hyperpocket.config import secret
+from hyperpocket.tool import from_git
 from llama_index.core.agent import FunctionCallingAgent
 from llama_index.llms.openai import OpenAI
-from pocket_llamaindex import PocketLlamaindex
 
-from hyperpocket.config import secret
-from hyperpocket.tool import from_git
+from hyperpocket_llamaindex import PocketLlamaindex
 
 llm = OpenAI(api_key=secret["OPENAI_API_KEY"])
 pocket = PocketLlamaindex(
@@ -243,11 +239,11 @@ client_secret = ""  # your github client secret
 
 - While creating your github OAuth app, configuring your app's `Authorization callback URL` is different for your
   development environment and production environment.
-    - For development environment, you can use `http://localhost:8000/auth/github/callback`
-        - **Note**: Default port for pocket dev server is `8000`. If you are using a different port, make sure to
-          replace `8000` with your actual port number.
-    - For production environment, you can use `https://yourdomain.com/auth/github/callback`
-        - **Note**: Make sure to replace `yourdomain.com` with your actual domain name that this app will be hosted on.
+  - For development environment, you can use `http://localhost:8000/auth/github/callback`
+    - **Note**: Default port for pocket dev server is `8000`. If you are using a different port, make sure to
+      replace `8000` with your actual port number.
+  - For production environment, you can use `https://yourdomain.com/auth/github/callback`
+    - **Note**: Make sure to replace `yourdomain.com` with your actual domain name that this app will be hosted on.
 
 #### How to integrate SLACK OAuth app
 
@@ -258,15 +254,53 @@ client_secret = ""  # your github client secret
 - Redirect URLs :
   `{public_server_protocol}://{public_hostname}:[{public_server_port}]/{callback_url_rewrite_prefix}/auth/slack/oauth2/callback`
 - Scopes : What you want to request to user.
-    - Recommended scopes :
-        - channels:history,
-        - channels:read,
-        - chat:write,
-        - groups:history,
-        - groups:read,
-        - im:history,
-        - mpim:history,
-        - reactions:read,
-        - reactions:write,
-
-3. Set your Slack APP Client ID / Client Secret in `$HOME/.pocket/settings.toml`
+  - Recommended scopes :
+    - channels:history,
+    - channels:read,
+    - chat:write,
+    - groups:history,
+    - groups:read,
+    - im:history,
+    - mpim:history,
+    - reactions:read,
+    - reactions:write,
+
+3. Set your Slack APP Client ID / Client Secret in `$HOME/.pocket/settings.toml`
+
+#### How to start adding a new token auth
+
+1. Generate boilerplate codes for token-based auth services ?
+
+```
+# service_name should be lowercase including underscore
+poetry run hyperpocket devtool create-token-auth-template {service_name}
+```
+
+It will generate boilerplate code lines for a new token-based auth service
+
+2. Extend AuthProvider enum to add your new auth provider.
+
+```python
+class AuthProvider(Enum):
+SERVICE = 'service'
+```
+
+3. Specify auth provider for tools
+
+1) github repo or local
+
+```toml
+[auth]
+auth_provider = "{service_name}"
+auth_handler = "{service_name}-token"
+scopes = []
+```
+
+2. function_tool
+
+```python
+@function_tool(
+    auth_provider=AuthProvider.SERVICE
+)
+def my_function(**kwargs):
+```

{hyperpocket-0.0.2 → hyperpocket-0.1.8}/hyperpocket/auth/README.md

@@ -236,15 +236,15 @@ class AuthHandlerInterface(ABC):
     - This class perform the actual prepare, authenticate, and refresh steps.
 
 5. Add a new enum value to the `AuthProvider` Enum(only implement new auth provider)
-    - If a new `AuthProvider` is added, update the `AuthProvider` enum in `pocket/auth/provider.py`
+    - If a new `AuthProvider` is added, update the `AuthProvider` enum in `hyperpocket/auth/provider.py`
 
 6. Add new auth callback server endpoint
-    - Add the endpoint under `pocket/server/auth/` packages.
+    - Add the endpoint under `hyperpocket/server/auth/` packages.
     - Declare an appropriate `APIRouter` in the package. Pocket will automatically register the endpoint during
       initialization.
 
 7. Add test code(optional)
-    - Add the test code under `pocket/auth/tests/` packages.
+    - Add the test code under `hyperpocket/auth/tests/` packages.
 
 ---
 

{hyperpocket-0.0.2 → hyperpocket-0.1.8}/hyperpocket/auth/__init__.py

@@ -1,14 +1,6 @@
 from hyperpocket.auth.context import AuthContext
-from hyperpocket.auth.github.context import GitHubAuthContext
-from hyperpocket.auth.github.oauth2_context import GitHubOAuth2AuthContext
-from hyperpocket.auth.github.token_context import GitHubTokenAuthContext
-from hyperpocket.auth.google.context import GoogleAuthContext
-from hyperpocket.auth.google.oauth2_context import GoogleOAuth2AuthContext
 from hyperpocket.auth.handler import AuthHandlerInterface
-from hyperpocket.auth.linear.token_context import LinearTokenAuthContext
 from hyperpocket.auth.provider import AuthProvider
-from hyperpocket.auth.slack.oauth2_context import SlackOAuth2AuthContext
-from hyperpocket.auth.slack.token_context import SlackTokenAuthContext
 from hyperpocket.util.find_all_leaf_class_in_package import find_all_leaf_class_in_package
 
 PREBUILT_AUTH_HANDLERS = find_all_leaf_class_in_package("hyperpocket.auth", AuthHandlerInterface)

hyperpocket-0.1.8/hyperpocket/auth/gumloop/context.py

@@ -0,0 +1,13 @@
+from hyperpocket.auth.context import AuthContext
+
+
+class GumLoopContext(AuthContext):
+    _ACCESS_TOKEN_KEY: str = "GUMLOOP_TOKEN"
+
+    def to_dict(self) -> dict[str, str]:
+        return {self._ACCESS_TOKEN_KEY: self.access_token}
+
+    def to_profiled_dict(self, profile: str) -> dict[str, str]:
+        return {
+            f"{profile.upper()}_{self._ACCESS_TOKEN_KEY}": self.access_token,
+        }

hyperpocket-0.1.8/hyperpocket/auth/gumloop/token_context.py

@@ -0,0 +1,15 @@
+from hyperpocket.auth.gumloop.context import GumLoopContext
+from hyperpocket.auth.gumloop.token_schema import GumloopTokenResponse
+
+
+class GumLoopTokenContext(GumLoopContext):
+
+    @classmethod
+    def from_gumloop_token_response(cls, response: GumloopTokenResponse):
+        description = "Gumloop Token Context logged in"
+
+        return cls(
+            access_token=response.access_token,
+            description=description,
+            expires_at=None
+        )