echostash 1.0.0__tar.gz

echostash-1.0.0/.gitignore

@@ -0,0 +1,51 @@
+# Dependencies
+node_modules/
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+
+# Build outputs
+packages/js/dist/
+packages/python/dist/
+packages/python/build/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+*.env
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Testing
+coverage/
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# OS
+Thumbs.db
+
+# Lock files (keep pnpm-lock for JS)
+package-lock.json
+yarn.lock
+poetry.lock

echostash-1.0.0/PKG-INFO

@@ -0,0 +1,310 @@
+Metadata-Version: 2.4
+Name: echostash
+Version: 1.0.0
+Summary: The universal prompt SDK. Fetch prompts from any PLP-compliant library and use them with any AI provider.
+Project-URL: Homepage, https://echostash.com
+Project-URL: Documentation, https://echostash.com/docs/sdk
+Project-URL: Repository, https://github.com/GoReal-AI/echostash-sdk
+Author-email: GoReal AI <support@echostash.com>
+License-Expression: MIT
+Keywords: ai,anthropic,echostash,langchain,llm,openai,plp,prompt,prompt-management
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.28.0
+Requires-Dist: typing-extensions>=4.0.0; python_version < '3.11'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: responses>=0.23.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Echostash SDK for Python
+
+The universal prompt SDK. Fetch prompts from any PLP-compliant library and use them with any AI provider.
+
+## Installation
+
+```bash
+pip install echostash
+```
+
+## Quick Start
+
+```python
+from echostash import Echostash
+from openai import OpenAI
+
+# Connect to any PLP-compliant server
+es = Echostash("https://api.echostash.com", api_key="sk_...")
+
+# Fetch a prompt and use with OpenAI
+prompt = es.prompt("welcome-email").get()
+message = prompt.with_vars(name="Alice").openai()
+
+client = OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[message]
+)
+```
+
+## The Fluent API
+
+The SDK is designed to be intuitive and chainable:
+
+```python
+# Fetch + substitute + convert in one line
+msg = es.prompt("welcome").vars(name="Alice").openai()
+
+# Or step by step
+prompt = es.prompt("welcome").get()
+rendered = prompt.with_vars(name="Alice")
+message = rendered.openai()
+
+# Fetch a specific version
+v1 = es.prompt("welcome").version("1.0.0").get()
+
+# Short version alias
+v2 = es.prompt("welcome").v("2.0.0").get()
+```
+
+## Provider Support
+
+### OpenAI
+
+```python
+from openai import OpenAI
+
+message = prompt.with_vars(name="Alice").openai(role="system")
+config = prompt.openai_config()
+
+client = OpenAI()
+response = client.chat.completions.create(
+    **config,
+    messages=[message]
+)
+```
+
+### Anthropic
+
+```python
+import anthropic
+
+# As user message
+message = prompt.with_vars(name="Bob").anthropic()
+
+# As system message (Anthropic handles system separately)
+system = prompt.anthropic_system()
+config = prompt.anthropic_config()
+
+client = anthropic.Anthropic()
+response = client.messages.create(
+    **config,
+    system=system,
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Google / Gemini
+
+```python
+message = prompt.google(role="user")
+# or
+message = prompt.gemini()
+
+config = prompt.google_config()
+```
+
+### Vercel AI SDK (for Node.js interop)
+
+```python
+message = prompt.vercel(role="system")
+```
+
+### LangChain
+
+```python
+from langchain.prompts import PromptTemplate
+
+# As message
+message = prompt.langchain(message_type="human")
+
+# As template (with input variables)
+template, input_variables = prompt.langchain_template()
+prompt_template = PromptTemplate.from_template(template)
+```
+
+## Connect to Any PLP Server
+
+The SDK works with any PLP-compliant prompt library:
+
+```python
+import os
+
+# Echostash Cloud
+es = Echostash("https://api.echostash.com", api_key="sk_...")
+
+# Local PLP server
+local = Echostash("http://localhost:3000")
+
+# Your company's prompt registry
+corp = Echostash(
+    "https://prompts.mycompany.com",
+    api_key=os.environ["PROMPT_API_KEY"]
+)
+
+# Any PLP-compliant service
+other = Echostash("https://plp.example.com")
+```
+
+## Working with Prompts
+
+### Fetch Prompts
+
+```python
+# Latest version
+prompt = es.prompt("marketing/welcome").get()
+
+# Specific version
+v1 = es.prompt("marketing/welcome").version("1.0.0").get()
+
+# With variables pre-set
+prompt = es.prompt("welcome").vars(name="Alice").get()
+```
+
+### Access Content
+
+```python
+prompt = es.prompt("welcome").get()
+
+# Raw content (string or list of ContentBlock)
+raw = prompt.raw()
+
+# As plain text
+text = prompt.text()
+
+# As string (same as text)
+print(str(prompt))
+```
+
+### Save Prompts
+
+```python
+es.save(
+    "my-new-prompt",
+    content="Hello {{name}}!",
+    meta={
+        "version": "1.0.0",
+        "author": "me"
+    }
+)
+```
+
+### Delete Prompts
+
+```python
+es.delete("my-old-prompt")
+```
+
+### Server Discovery
+
+```python
+info = es.discover()
+print(info["plp_version"])   # "1.0"
+print(info["capabilities"])  # {"versioning": True, ...}
+```
+
+## Context Manager Support
+
+```python
+with Echostash("https://api.echostash.com", api_key="sk_...") as es:
+    prompt = es.prompt("welcome").get()
+    # Connection is properly closed after the block
+```
+
+## Type Hints
+
+Full type hint support:
+
+```python
+from echostash import (
+    Prompt,
+    PromptContent,
+    PromptMeta,
+    ModelConfig,
+    LoadedPrompt,
+)
+from echostash.types import (
+    OpenAIMessage,
+    AnthropicMessage,
+    GoogleMessage,
+    VercelMessage,
+    LangChainMessage,
+)
+```
+
+## Advanced: Direct Provider Functions
+
+For advanced use cases, you can import provider functions directly:
+
+```python
+from echostash.providers import (
+    to_openai,
+    to_anthropic,
+    to_google,
+    to_vercel,
+    to_langchain,
+    extract_openai_config,
+)
+
+content = "Hello {{name}}!"
+message = to_openai(content, role="system")
+```
+
+## Configuration
+
+```python
+es = Echostash(
+    "https://api.echostash.com",
+
+    # API key for authentication
+    api_key="sk_...",
+
+    # Custom headers
+    headers={
+        "X-Custom-Header": "value"
+    },
+
+    # Request timeout (seconds)
+    timeout=10,
+
+    # Default parameter symbol for variable substitution
+    default_parameter_symbol="{{}}"
+)
+```
+
+## Error Handling
+
+```python
+from echostash import EchostashError
+
+try:
+    prompt = es.prompt("not-found").get()
+except EchostashError as e:
+    print(e.args[0])      # "HTTP 404"
+    print(e.status_code)  # 404
+```
+
+## License
+
+MIT

echostash-1.0.0/README.md

@@ -0,0 +1,280 @@
+# Echostash SDK for Python
+
+The universal prompt SDK. Fetch prompts from any PLP-compliant library and use them with any AI provider.
+
+## Installation
+
+```bash
+pip install echostash
+```
+
+## Quick Start
+
+```python
+from echostash import Echostash
+from openai import OpenAI
+
+# Connect to any PLP-compliant server
+es = Echostash("https://api.echostash.com", api_key="sk_...")
+
+# Fetch a prompt and use with OpenAI
+prompt = es.prompt("welcome-email").get()
+message = prompt.with_vars(name="Alice").openai()
+
+client = OpenAI()
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[message]
+)
+```
+
+## The Fluent API
+
+The SDK is designed to be intuitive and chainable:
+
+```python
+# Fetch + substitute + convert in one line
+msg = es.prompt("welcome").vars(name="Alice").openai()
+
+# Or step by step
+prompt = es.prompt("welcome").get()
+rendered = prompt.with_vars(name="Alice")
+message = rendered.openai()
+
+# Fetch a specific version
+v1 = es.prompt("welcome").version("1.0.0").get()
+
+# Short version alias
+v2 = es.prompt("welcome").v("2.0.0").get()
+```
+
+## Provider Support
+
+### OpenAI
+
+```python
+from openai import OpenAI
+
+message = prompt.with_vars(name="Alice").openai(role="system")
+config = prompt.openai_config()
+
+client = OpenAI()
+response = client.chat.completions.create(
+    **config,
+    messages=[message]
+)
+```
+
+### Anthropic
+
+```python
+import anthropic
+
+# As user message
+message = prompt.with_vars(name="Bob").anthropic()
+
+# As system message (Anthropic handles system separately)
+system = prompt.anthropic_system()
+config = prompt.anthropic_config()
+
+client = anthropic.Anthropic()
+response = client.messages.create(
+    **config,
+    system=system,
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+```
+
+### Google / Gemini
+
+```python
+message = prompt.google(role="user")
+# or
+message = prompt.gemini()
+
+config = prompt.google_config()
+```
+
+### Vercel AI SDK (for Node.js interop)
+
+```python
+message = prompt.vercel(role="system")
+```
+
+### LangChain
+
+```python
+from langchain.prompts import PromptTemplate
+
+# As message
+message = prompt.langchain(message_type="human")
+
+# As template (with input variables)
+template, input_variables = prompt.langchain_template()
+prompt_template = PromptTemplate.from_template(template)
+```
+
+## Connect to Any PLP Server
+
+The SDK works with any PLP-compliant prompt library:
+
+```python
+import os
+
+# Echostash Cloud
+es = Echostash("https://api.echostash.com", api_key="sk_...")
+
+# Local PLP server
+local = Echostash("http://localhost:3000")
+
+# Your company's prompt registry
+corp = Echostash(
+    "https://prompts.mycompany.com",
+    api_key=os.environ["PROMPT_API_KEY"]
+)
+
+# Any PLP-compliant service
+other = Echostash("https://plp.example.com")
+```
+
+## Working with Prompts
+
+### Fetch Prompts
+
+```python
+# Latest version
+prompt = es.prompt("marketing/welcome").get()
+
+# Specific version
+v1 = es.prompt("marketing/welcome").version("1.0.0").get()
+
+# With variables pre-set
+prompt = es.prompt("welcome").vars(name="Alice").get()
+```
+
+### Access Content
+
+```python
+prompt = es.prompt("welcome").get()
+
+# Raw content (string or list of ContentBlock)
+raw = prompt.raw()
+
+# As plain text
+text = prompt.text()
+
+# As string (same as text)
+print(str(prompt))
+```
+
+### Save Prompts
+
+```python
+es.save(
+    "my-new-prompt",
+    content="Hello {{name}}!",
+    meta={
+        "version": "1.0.0",
+        "author": "me"
+    }
+)
+```
+
+### Delete Prompts
+
+```python
+es.delete("my-old-prompt")
+```
+
+### Server Discovery
+
+```python
+info = es.discover()
+print(info["plp_version"])   # "1.0"
+print(info["capabilities"])  # {"versioning": True, ...}
+```
+
+## Context Manager Support
+
+```python
+with Echostash("https://api.echostash.com", api_key="sk_...") as es:
+    prompt = es.prompt("welcome").get()
+    # Connection is properly closed after the block
+```
+
+## Type Hints
+
+Full type hint support:
+
+```python
+from echostash import (
+    Prompt,
+    PromptContent,
+    PromptMeta,
+    ModelConfig,
+    LoadedPrompt,
+)
+from echostash.types import (
+    OpenAIMessage,
+    AnthropicMessage,
+    GoogleMessage,
+    VercelMessage,
+    LangChainMessage,
+)
+```
+
+## Advanced: Direct Provider Functions
+
+For advanced use cases, you can import provider functions directly:
+
+```python
+from echostash.providers import (
+    to_openai,
+    to_anthropic,
+    to_google,
+    to_vercel,
+    to_langchain,
+    extract_openai_config,
+)
+
+content = "Hello {{name}}!"
+message = to_openai(content, role="system")
+```
+
+## Configuration
+
+```python
+es = Echostash(
+    "https://api.echostash.com",
+
+    # API key for authentication
+    api_key="sk_...",
+
+    # Custom headers
+    headers={
+        "X-Custom-Header": "value"
+    },
+
+    # Request timeout (seconds)
+    timeout=10,
+
+    # Default parameter symbol for variable substitution
+    default_parameter_symbol="{{}}"
+)
+```
+
+## Error Handling
+
+```python
+from echostash import EchostashError
+
+try:
+    prompt = es.prompt("not-found").get()
+except EchostashError as e:
+    print(e.args[0])      # "HTTP 404"
+    print(e.status_code)  # 404
+```
+
+## License
+
+MIT

echostash-1.0.0/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "echostash"
+version = "1.0.0"
+description = "The universal prompt SDK. Fetch prompts from any PLP-compliant library and use them with any AI provider."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "GoReal AI", email = "support@echostash.com" }
+]
+keywords = [
+    "prompt",
+    "llm",
+    "ai",
+    "openai",
+    "anthropic",
+    "langchain",
+    "plp",
+    "echostash",
+    "prompt-management"
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "typing-extensions>=4.0.0;python_version<'3.11'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "responses>=0.23.0",
+    "mypy>=1.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.urls]
+Homepage = "https://echostash.com"
+Documentation = "https://echostash.com/docs/sdk"
+Repository = "https://github.com/GoReal-AI/echostash-sdk"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/echostash"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.mypy]
+python_version = "3.9"
+strict = true