hypergolic 0.1.2__tar.gz

hypergolic-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Townley
+
+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.

hypergolic-0.1.2/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: hypergolic
+Version: 0.1.2
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: requests>=2.32.5
+Dynamic: license-file

hypergolic-0.1.2/hypergolic/llm/api.py

@@ -0,0 +1,55 @@
+import os
+from pathlib import Path
+import requests
+
+from .schemas import APIResponse, Message
+from ..tools.tool_list import ALL_TOOLS_FORMATTED
+
+BASE_API_URL = os.environ.get("HYPERGOLIC_API_URL", "https://api.anthropic.com")
+HYPERGOLIC_API_KEY = os.environ.get("HYPERGOLIC_API_KEY")
+MAX_TOKENS = 8192
+
+
+def load_system_prompt() -> str:
+    """Load the system prompt from the prompts directory."""
+    prompt_path = Path(__file__).parent.parent / "prompts" / "system_prompt.txt"
+    try:
+        return prompt_path.read_text().strip()
+    except FileNotFoundError:
+        # Fallback to a minimal system prompt if file not found
+        return "You are a helpful AI coding assistant with access to command-line tools."
+
+
+def call_messages_api(messages: list[Message]) -> APIResponse:
+    if not HYPERGOLIC_API_KEY:
+        raise Exception("HYPERGOLIC_API_KEY not set")
+    elif not BASE_API_URL:
+        raise Exception("HYPERGOLIC_API_URL not set")
+
+    url = f"{BASE_API_URL}/v1/messages"
+
+    headers = {
+        "Content-Type": "application/json",
+        "x-api-key": HYPERGOLIC_API_KEY,
+        "anthropic-version": "2023-06-01",
+    }
+    
+    # Prepare tools with cache control on the last tool
+    tools = ALL_TOOLS_FORMATTED.copy()
+    if tools:
+        # Mark the last tool for caching
+        tools[-1] = {**tools[-1], "cache_control": {"type": "ephemeral"}}
+    
+    # Load system prompt
+    system_prompt = load_system_prompt()
+    
+    data = {
+        "model": "claude-sonnet-4-5",
+        "max_tokens": MAX_TOKENS,
+        "messages": [m.model_dump(exclude_none=True) for m in messages],
+        "tools": tools,
+        "system": system_prompt,
+    }
+    
+    response = requests.post(url, headers=headers, json=data)
+    return APIResponse(**response.json())

hypergolic-0.1.2/hypergolic/llm/enums.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+
+class StopReason(str, Enum):
+    END_TURN = "end_turn"
+    TOOL_USE = "tool_use"

hypergolic-0.1.2/hypergolic/llm/schemas.py

@@ -0,0 +1,69 @@
+from typing import Literal, Optional, Union
+
+from pydantic import BaseModel, Field
+
+from .enums import StopReason
+from ..tools.enums import ToolName
+
+
+class CacheControl(BaseModel):
+    type: Literal["ephemeral"] = "ephemeral"
+
+
+class UserToolResult(BaseModel):
+    type: Literal["tool_result"] = Field(default="tool_result")
+    tool_use_id: str
+    content: Union[str, list[str]]
+    cache_control: Optional[CacheControl] = None
+
+
+UserMessageContent = Union[str, list[UserToolResult]]
+
+
+class UserMessage(BaseModel):
+    role: Literal["user"] = Field(default="user")
+    content: UserMessageContent
+
+
+class AssistantMessageTextContent(BaseModel):
+    type: Literal["text"]
+    text: str
+    cache_control: Optional[CacheControl] = None
+
+
+class AssistantMessageToolUseContent(BaseModel):
+    type: Literal["tool_use"]
+    id: str
+    name: ToolName
+    input: dict
+
+
+AssistantMessageContent = Union[
+    AssistantMessageTextContent, AssistantMessageToolUseContent
+]
+
+
+class AssistantMessage(BaseModel):
+    role: Literal["assistant"] = Field(default="assistant")
+    content: list[AssistantMessageContent]
+
+
+Message = Union[UserMessage, AssistantMessage]
+
+
+class Usage(BaseModel):
+    input_tokens: int
+    output_tokens: int
+    cache_creation_input_tokens: Optional[int] = None
+    cache_read_input_tokens: Optional[int] = None
+    service_tier: Optional[str] = None
+
+
+class APIResponse(BaseModel):
+    id: str
+    content: list[AssistantMessageContent]
+    model: str
+    role: str
+    stop_reason: StopReason
+    type: str = Field(examples=["message"])
+    usage: Usage

hypergolic-0.1.2/hypergolic/prompts/README.md

@@ -0,0 +1,28 @@
+# System Prompts
+
+This directory contains system prompts used by the AI coding assistant.
+
+## Files
+
+- **system_prompt.txt**: The main system prompt that defines the AI assistant's behavior, capabilities, and guidelines.
+
+## Usage
+
+The system prompt is automatically loaded by `llm/api.py` when making API calls to the language model. It sets the context and behavior for how the assistant should respond to user requests.
+
+## Modifying the System Prompt
+
+To modify the assistant's behavior:
+
+1. Edit `system_prompt.txt` with your desired changes
+2. The changes will take effect immediately on the next API call
+3. No code changes are needed - the prompt is loaded dynamically
+
+## Structure
+
+The system prompt includes:
+- **Core Capabilities**: Description of available tools
+- **Guidelines**: Behavioral principles for the assistant
+- **Best Practices**: Specific recommendations for effective assistance
+
+Keep the prompt clear, focused, and actionable to ensure the best assistant behavior.

hypergolic-0.1.2/hypergolic/prompts/system_prompt.txt

@@ -0,0 +1,45 @@
+You are an AI coding assistant with access to command-line tools. Your purpose is to help users with programming tasks, code analysis, file operations, and system interactions.
+
+## Core Capabilities
+
+You have access to a command_line tool that allows you to:
+- Execute shell commands on the user's macOS system
+- Read and write files
+- Navigate directories
+- Run programs and scripts
+- Inspect system state
+
+## Guidelines
+
+1. **Be proactive and helpful**: When a user asks for help, take initiative to gather information and solve problems completely.
+
+2. **Use tools effectively**: Don't hesitate to use the command_line tool to:
+   - Explore project structure and understand context
+   - Read relevant files before making suggestions
+   - Make changes directly when appropriate
+   - Test your changes to ensure they work
+
+3. **Explain your actions**: When using tools, briefly explain what you're doing and why. Show command outputs when relevant to help the user understand.
+
+4. **Be safe and thoughtful**: 
+   - Ask for confirmation before destructive operations
+   - Be careful with file modifications
+   - Validate inputs and check results
+   - Handle errors gracefully
+
+5. **Provide complete solutions**: 
+   - Don't just suggest changes—implement them when possible
+   - Test your implementations
+   - Consider edge cases and potential issues
+
+6. **Maintain context**: Remember the conversation history and build on previous interactions to provide coherent, contextual assistance.
+
+## Best Practices
+
+- Read before writing: Examine existing code/files before making changes
+- Test your changes: Run commands to verify functionality
+- Be efficient: Combine operations when sensible, but keep them clear
+- Stay focused: Address the user's request directly while being thorough
+- Communicate clearly: Use formatting to make responses readable
+
+Your goal is to be a capable, trustworthy assistant that can effectively help with real-world coding and system tasks.

hypergolic-0.1.2/hypergolic/tools/command_line.py

@@ -0,0 +1,44 @@
+import shlex
+import subprocess
+
+from pydantic import BaseModel, Field
+
+from .enums import ToolName
+from .schemas import Tool, ToolOutput
+
+
+class CommandLineToolInput(BaseModel):
+    cmd: str = Field(description="The command to run")
+
+
+class CommandLineToolOutput(BaseModel):
+    returncode: int
+    stderr: str
+    stdout: str
+
+
+def issue_cmd(input: CommandLineToolInput) -> ToolOutput:
+    output = subprocess.run(input.cmd, shell=True, capture_output=True, text=True)
+    result = CommandLineToolOutput(
+        returncode=output.returncode,
+        stderr=output.stderr,
+        stdout=output.stdout,
+    )
+    return result.model_dump_json()
+
+
+CommandLineTool = Tool(
+    name=ToolName.COMMAND_LINE,
+    description="Issue a subprocess to a user's MacOS local machine",
+    input_schema={
+        "type": "object",
+        "properties": {
+            "cmd": {
+                "type": "string",
+                "description": "The command to run",
+            }
+        },
+    },
+    callable=issue_cmd,
+    input_model=CommandLineToolInput,
+)

hypergolic-0.1.2/hypergolic/tools/enums.py

@@ -0,0 +1,5 @@
+from enum import Enum
+
+
+class ToolName(str, Enum):
+    COMMAND_LINE = "command_line"

hypergolic-0.1.2/hypergolic/tools/schemas.py

@@ -0,0 +1,13 @@
+from typing import Callable, Union
+from pydantic import BaseModel, Field
+
+
+class Tool(BaseModel):
+    name: str = Field(examples=["get_weather"])
+    description: str = Field(examples=["Get the current weather in a given location"])
+    input_schema: dict
+    callable: Callable = Field(exclude=True)
+    input_model: type[BaseModel] = Field(exclude=True)
+
+
+ToolOutput = Union[str, list[str]]

hypergolic-0.1.2/hypergolic/tools/tool_list.py

@@ -0,0 +1,7 @@
+from .schemas import Tool
+
+from .command_line import CommandLineTool
+
+ALL_TOOLS: list[Tool] = [CommandLineTool]
+ALL_TOOLS_FORMATTED = [t.model_dump() for t in ALL_TOOLS]
+TOOL_MAP = {t.name: t for t in ALL_TOOLS}

hypergolic-0.1.2/hypergolic.egg-info/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: hypergolic
+Version: 0.1.2
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: requests>=2.32.5
+Dynamic: license-file

hypergolic-0.1.2/hypergolic.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+hypergolic/__init__.py
+hypergolic.egg-info/PKG-INFO
+hypergolic.egg-info/SOURCES.txt
+hypergolic.egg-info/dependency_links.txt
+hypergolic.egg-info/requires.txt
+hypergolic.egg-info/top_level.txt
+hypergolic/llm/__init__.py
+hypergolic/llm/api.py
+hypergolic/llm/enums.py
+hypergolic/llm/schemas.py
+hypergolic/prompts/README.md
+hypergolic/prompts/system_prompt.txt
+hypergolic/tools/__init__.py
+hypergolic/tools/command_line.py
+hypergolic/tools/enums.py
+hypergolic/tools/schemas.py
+hypergolic/tools/tool_list.py

hypergolic-0.1.2/hypergolic.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

hypergolic-0.1.2/hypergolic.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pydantic>=2.12.5
+requests>=2.32.5

hypergolic-0.1.2/hypergolic.egg-info/top_level.txt

@@ -0,0 +1 @@
+hypergolic

hypergolic-0.1.2/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "hypergolic"
+version = "0.1.2"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "pydantic>=2.12.5",
+    "requests>=2.32.5",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.package-data]
+hypergolic = ["prompts/*"]

hypergolic-0.1.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+