agentmark-prompt-core 0.1.0__tar.gz

agentmark_prompt_core-0.1.0/.gitignore

@@ -0,0 +1,70 @@
+# 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/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo

agentmark_prompt_core-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: agentmark-prompt-core
+Version: 0.1.0
+Summary: Python prompt-core package for AgentMark - high-level runtime for working with AgentMark prompts
+Project-URL: Homepage, https://github.com/agentmark/agentmark
+Project-URL: Documentation, https://github.com/agentmark/agentmark#readme
+Project-URL: Repository, https://github.com/agentmark/agentmark
+Author: AgentMark Team
+License-Expression: MIT
+Keywords: agentmark,ai,llm,mdx,prompt
+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.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# AgentMark Prompt Core (Python)
+
+Python implementation of the AgentMark prompt-core package. This package provides the high-level runtime for working with AgentMark prompts.
+
+## Installation
+
+```bash
+pip install agentmark-prompt-core
+```
+
+## Usage
+
+This package transforms pre-parsed MDX AST trees. The AST is typically obtained by:
+- Parsing MDX with the TypeScript `@agentmark-ai/templatedx` package
+- Loading a pre-parsed AST from a JSON file
+- Receiving an AST from the AgentMark runtime
+
+```python
+import asyncio
+import json
+from agentmark.prompt_core import create_agentmark, DefaultAdapter
+
+async def main():
+    # Create an AgentMark instance with the default adapter
+    agentmark = create_agentmark(adapter=DefaultAdapter())
+
+    # Load a pre-parsed MDX AST (from TypeScript parser or JSON file)
+    with open("math.prompt.mdx.json") as f:
+        ast = json.load(f)
+
+    # Load and format a text prompt
+    prompt = await agentmark.load_text_prompt(ast)
+    result = await prompt.format(props={"userMessage": "What is 2+2?"})
+
+    print(result)
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Prompt Types**: Text, Object, Image, and Speech prompts
+- **Message Extraction**: System, User, and Assistant message roles
+- **Attachments**: Image and file attachments in User messages
+- **Schema Validation**: Pydantic-based validation matching TypeScript Zod schemas
+- **Adapters**: Extensible adapter interface for different LLM providers
+- **Eval Registry**: Registry for evaluation functions
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linting
+ruff check src tests
+
+# Run type checking
+mypy src/agentmark --strict
+```
+
+## License
+
+MIT

agentmark_prompt_core-0.1.0/README.md

@@ -0,0 +1,67 @@
+# AgentMark Prompt Core (Python)
+
+Python implementation of the AgentMark prompt-core package. This package provides the high-level runtime for working with AgentMark prompts.
+
+## Installation
+
+```bash
+pip install agentmark-prompt-core
+```
+
+## Usage
+
+This package transforms pre-parsed MDX AST trees. The AST is typically obtained by:
+- Parsing MDX with the TypeScript `@agentmark-ai/templatedx` package
+- Loading a pre-parsed AST from a JSON file
+- Receiving an AST from the AgentMark runtime
+
+```python
+import asyncio
+import json
+from agentmark.prompt_core import create_agentmark, DefaultAdapter
+
+async def main():
+    # Create an AgentMark instance with the default adapter
+    agentmark = create_agentmark(adapter=DefaultAdapter())
+
+    # Load a pre-parsed MDX AST (from TypeScript parser or JSON file)
+    with open("math.prompt.mdx.json") as f:
+        ast = json.load(f)
+
+    # Load and format a text prompt
+    prompt = await agentmark.load_text_prompt(ast)
+    result = await prompt.format(props={"userMessage": "What is 2+2?"})
+
+    print(result)
+
+asyncio.run(main())
+```
+
+## Features
+
+- **Prompt Types**: Text, Object, Image, and Speech prompts
+- **Message Extraction**: System, User, and Assistant message roles
+- **Attachments**: Image and file attachments in User messages
+- **Schema Validation**: Pydantic-based validation matching TypeScript Zod schemas
+- **Adapters**: Extensible adapter interface for different LLM providers
+- **Eval Registry**: Registry for evaluation functions
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run linting
+ruff check src tests
+
+# Run type checking
+mypy src/agentmark --strict
+```
+
+## License
+
+MIT

agentmark_prompt_core-0.1.0/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@agentmark-ai/prompt-core-python",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "postinstall": "node ../../scripts/setup-python-venv.js -e ../templatedx-python -e \".[dev]\"",
+    "test": "node ../../scripts/run-venv.js pytest tests/",
+    "lint": "node ../../scripts/run-venv.js ruff check src/ tests/ && node ../../scripts/run-venv.js mypy src --strict",
+    "lint:fix": "node ../../scripts/run-venv.js ruff check --fix src/ tests/"
+  }
+}

agentmark_prompt_core-0.1.0/pyproject.toml

@@ -0,0 +1,103 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentmark-prompt-core"
+version = "0.1.0"
+description = "Python prompt-core package for AgentMark - high-level runtime for working with AgentMark prompts"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "AgentMark Team" }
+]
+keywords = ["agentmark", "prompt", "llm", "ai", "mdx"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "ruff>=0.8.0",
+    "mypy>=1.0",
+    "types-PyYAML>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/agentmark/agentmark"
+Documentation = "https://github.com/agentmark/agentmark#readme"
+Repository = "https://github.com/agentmark/agentmark"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentmark"]
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # Pyflakes
+    "I",      # isort
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "UP",     # pyupgrade
+    "ARG",    # flake8-unused-arguments
+    "SIM",    # flake8-simplify
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "B008",   # do not perform function calls in argument defaults
+    "B905",   # zip without explicit strict parameter
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["agentmark", "templatedx"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["ARG001", "ARG002", "ARG005"]  # Allow unused args in test mocks/fixtures
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+follow_imports = "normal"
+ignore_missing_imports = false
+
+[[tool.mypy.overrides]]
+module = "yaml"
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

agentmark_prompt_core-0.1.0/src/agentmark/prompt_core/__init__.py

@@ -0,0 +1,144 @@
+"""AgentMark Prompt Core - Python implementation."""
+
+from .adapters import Adapter, DefaultAdapter
+from .agentmark import AgentMark, create_agentmark
+from .eval_registry import EvalRegistry
+from .api_loader import ApiDatasetReader, ApiDatasetStream, ApiLoader
+from .loaders import FileDatasetReader, FileDatasetStream, FileLoader
+from .mcp import (
+    McpServerConfig,
+    McpServers,
+    McpStdioServerConfig,
+    McpUrlServerConfig,
+    NormalizedTool,
+    interpolate_env_in_object,
+    normalize_tools_list,
+    parse_mcp_uri,
+)
+from .prompts import (
+    BasePrompt,
+    ImagePrompt,
+    ObjectPrompt,
+    SimpleDatasetReader,
+    SimpleDatasetStream,
+    SpeechPrompt,
+    TextPrompt,
+)
+from .schemas import (
+    AgentmarkConfigSchema,
+    ImageConfigSchema,
+    ImageSettingsSchema,
+    ObjectConfigSchema,
+    ObjectSettingsSchema,
+    SpeechConfigSchema,
+    SpeechSettingsSchema,
+    TestSettingsSchema,
+    TextConfigSchema,
+    TextSettingsSchema,
+)
+from .template_engines import TemplateDXTemplateEngine, get_front_matter
+from .types import (
+    AdaptOptions,
+    ChatMessage,
+    ContentPart,
+    DatasetErrorChunk,
+    DatasetItem,
+    DatasetReader,
+    DatasetStream,
+    DatasetStreamChunk,
+    EvalFunction,
+    EvalParams,
+    EvalResult,
+    FilePart,
+    FormatWithDatasetOptions,
+    ImagePart,
+    JSONObject,
+    JSONPrimitive,
+    JSONValue,
+    Loader,
+    PromptKind,
+    PromptMetadata,
+    RichChatMessage,
+    TelemetryOptions,
+    TemplateEngine,
+    TestSettings,
+    TextPart,
+)
+
+__all__ = [
+    # Main classes
+    "AgentMark",
+    "create_agentmark",
+    # Adapters
+    "Adapter",
+    "DefaultAdapter",
+    # Prompts
+    "BasePrompt",
+    "TextPrompt",
+    "ObjectPrompt",
+    "ImagePrompt",
+    "SpeechPrompt",
+    "SimpleDatasetStream",
+    "SimpleDatasetReader",
+    # Registries
+    "EvalRegistry",
+    # Loaders
+    "ApiLoader",
+    "ApiDatasetStream",
+    "ApiDatasetReader",
+    "FileLoader",
+    "FileDatasetStream",
+    "FileDatasetReader",
+    # Template engines
+    "TemplateDXTemplateEngine",
+    "get_front_matter",
+    # Schemas
+    "TextConfigSchema",
+    "ObjectConfigSchema",
+    "ImageConfigSchema",
+    "SpeechConfigSchema",
+    "AgentmarkConfigSchema",
+    "TextSettingsSchema",
+    "ObjectSettingsSchema",
+    "ImageSettingsSchema",
+    "SpeechSettingsSchema",
+    "TestSettingsSchema",
+    # Types
+    "JSONPrimitive",
+    "JSONValue",
+    "JSONObject",
+    "PromptKind",
+    "TextPart",
+    "ImagePart",
+    "FilePart",
+    "ContentPart",
+    "ChatMessage",
+    "RichChatMessage",
+    "TelemetryOptions",
+    "AdaptOptions",
+    "PromptMetadata",
+    "EvalParams",
+    "EvalResult",
+    "EvalFunction",
+    "TestSettings",
+    "Loader",
+    "TemplateEngine",
+    # Dataset types
+    "DatasetItem",
+    "DatasetStreamChunk",
+    "DatasetErrorChunk",
+    "FormatWithDatasetOptions",
+    "DatasetReader",
+    "DatasetStream",
+    # MCP utilities
+    "parse_mcp_uri",
+    "interpolate_env_in_object",
+    "normalize_tools_list",
+    "McpUrlServerConfig",
+    "McpStdioServerConfig",
+    "McpServerConfig",
+    "McpServers",
+    "NormalizedTool",
+]
+
+__version__ = "0.1.0"

agentmark_prompt_core-0.1.0/src/agentmark/prompt_core/adapters/__init__.py

@@ -0,0 +1,9 @@
+"""Adapters for prompt-core."""
+
+from .base import Adapter
+from .default import DefaultAdapter
+
+__all__ = [
+    "Adapter",
+    "DefaultAdapter",
+]

agentmark_prompt_core-0.1.0/src/agentmark/prompt_core/adapters/base.py

@@ -0,0 +1,98 @@
+"""Adapter protocol definition.
+
+prompt-core passes compiled Pydantic config schemas directly to adapters,
+matching the TypeScript pattern where compiled objects are passed as-is.
+Each adapter handles its own serialization if needed.
+"""
+
+from typing import Any, Protocol
+
+from ..schemas import (
+    ImageConfigSchema,
+    ObjectConfigSchema,
+    SpeechConfigSchema,
+    TextConfigSchema,
+)
+from ..types import AdaptOptions, PromptMetadata
+
+
+class Adapter(Protocol):
+    """Protocol defining the adapter interface for LLM providers.
+
+    Config parameters are Pydantic schema objects compiled by the template
+    engine. Adapters that need dict access should call config.model_dump()
+    internally.
+    """
+
+    @property
+    def name(self) -> str:
+        """Adapter name identifier."""
+        ...
+
+    def adapt_text(
+        self,
+        config: TextConfigSchema,
+        options: AdaptOptions,
+        metadata: PromptMetadata,
+    ) -> Any:
+        """Adapt a text prompt config for the provider.
+
+        Args:
+            config: Text prompt configuration (Pydantic model).
+            options: Adapter options
+            metadata: Prompt metadata
+
+        Returns:
+            Provider-specific format
+        """
+        ...
+
+    def adapt_object(
+        self,
+        config: ObjectConfigSchema,
+        options: AdaptOptions,
+        metadata: PromptMetadata,
+    ) -> Any:
+        """Adapt an object prompt config for the provider.
+
+        Args:
+            config: Object prompt configuration (Pydantic model).
+            options: Adapter options
+            metadata: Prompt metadata
+
+        Returns:
+            Provider-specific format
+        """
+        ...
+
+    def adapt_image(
+        self,
+        config: ImageConfigSchema,
+        options: AdaptOptions,
+    ) -> Any:
+        """Adapt an image prompt config for the provider.
+
+        Args:
+            config: Image prompt configuration (Pydantic model).
+            options: Adapter options
+
+        Returns:
+            Provider-specific format
+        """
+        ...
+
+    def adapt_speech(
+        self,
+        config: SpeechConfigSchema,
+        options: AdaptOptions,
+    ) -> Any:
+        """Adapt a speech prompt config for the provider.
+
+        Args:
+            config: Speech prompt configuration (Pydantic model).
+            options: Adapter options
+
+        Returns:
+            Provider-specific format
+        """
+        ...

agentmark_prompt_core-0.1.0/src/agentmark/prompt_core/adapters/default.py

@@ -0,0 +1,52 @@
+"""Default passthrough adapter."""
+
+from ..schemas import (
+    ImageConfigSchema,
+    ObjectConfigSchema,
+    SpeechConfigSchema,
+    TextConfigSchema,
+)
+from ..types import AdaptOptions, PromptMetadata
+
+
+class DefaultAdapter:
+    """Default passthrough adapter that returns configs unchanged."""
+
+    @property
+    def name(self) -> str:
+        """Adapter name identifier."""
+        return "default"
+
+    def adapt_text(
+        self,
+        config: TextConfigSchema,
+        _options: AdaptOptions,
+        _metadata: PromptMetadata,
+    ) -> TextConfigSchema:
+        """Return text config unchanged."""
+        return config
+
+    def adapt_object(
+        self,
+        config: ObjectConfigSchema,
+        _options: AdaptOptions,
+        _metadata: PromptMetadata,
+    ) -> ObjectConfigSchema:
+        """Return object config unchanged."""
+        return config
+
+    def adapt_image(
+        self,
+        config: ImageConfigSchema,
+        _options: AdaptOptions,
+    ) -> ImageConfigSchema:
+        """Return image config unchanged."""
+        return config
+
+    def adapt_speech(
+        self,
+        config: SpeechConfigSchema,
+        _options: AdaptOptions,
+    ) -> SpeechConfigSchema:
+        """Return speech config unchanged."""
+        return config