afm-cli 0.2.0__tar.gz → 0.2.1.dev1__tar.gz

afm_cli-0.2.1.dev1/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: afm-cli
+Version: 0.2.1.dev1
+Summary: AFM CLI metapackage: installs afm-core and afm-langchain
+License-Expression: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.11
+Requires-Dist: afm-core
+Requires-Dist: afm-langchain
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/wso2/reference-implementations-afm
+Description-Content-Type: text/markdown
+

afm_cli-0.2.1.dev1/pyproject.toml

@@ -0,0 +1,30 @@
+[project]
+name = "afm-cli"
+version = "0.2.1.dev1"
+description = "AFM CLI metapackage: installs afm-core and afm-langchain"
+readme = "README.md"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3.11",
+]
+license = "Apache-2.0"
+requires-python = ">=3.11"
+urls = { Repository = "https://github.com/wso2/reference-implementations-afm" }
+dependencies = [
+    "afm-core",
+    "afm-langchain",
+]
+
+[project.scripts]
+afm = "afm.cli:cli"
+
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "afm_cli"
+
+[tool.uv.sources]
+afm-core = { workspace = true }
+afm-langchain = { workspace = true }

afm_cli-0.2.1.dev1/src/afm_cli/__init__.py

@@ -0,0 +1,4 @@
+# Copyright (c) 2025
+# Licensed under the Apache License, Version 2.0
+
+"""AFM CLI metapackage — installs afm-core and afm-langchain."""

afm_cli-0.2.0/PKG-INFO

@@ -1,119 +0,0 @@
-Metadata-Version: 2.4
-Name: afm-cli
-Version: 0.2.0
-Summary: AFM (Agent-Flavored Markdown) interpreter using LangChain
-License-Expression: Apache-2.0
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3.11
-Requires-Dist: langchain>=1.2.8
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: pydantic>=2.0
-Requires-Dist: langchain-openai>=1.1.7
-Requires-Dist: langchain-anthropic>=1.3.1
-Requires-Dist: jsonschema>=4.26.0
-Requires-Dist: fastapi>=0.128.1
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: uvicorn>=0.40.0
-Requires-Dist: mcp>=1.26.0
-Requires-Dist: langchain-mcp-adapters>=0.2.1
-Requires-Dist: click>=8.0.0
-Requires-Dist: textual>=2.1.0
-Requires-Python: >=3.11
-Project-URL: Repository, https://github.com/RadCod3/reference-implementations-afm
-Description-Content-Type: text/markdown
-
-# AFM LangChain Interpreter
-
-A LangChain-based reference implementation of an interpreter for [Agent-Flavored Markdown (AFM)](https://github.com/wso2/agent-flavored-markdown) files.
-
-## Features
-
-- **Support for all interface types:**
-  - Console chat (interactive CLI)
-  - Web chat (HTTP API + optional UI)
-  - Webhook (WebSub-based event handling)
-- **Multi-interface agents** - run multiple interfaces simultaneously
-- **MCP support** for tools (Model Context Protocol)
-- **Validation** - dry-run mode to validate AFM definitions
-
-## Prerequisites
-
-- [Python](https://www.python.org/) 3.12 or later.
-- [uv](https://docs.astral.sh/uv/) for dependency management.
-
-## Installation
-
-### Using pipx (Recommended)
-
-To run `afm` as a standalone command-line tool:
-
-```bash
-pipx install afm-cli
-```
-
-### Using pip
-
-```bash
-pip install afm-cli
-```
-
-## Quick Start
-
-```bash
-# Set your API Key
-export OPENAI_API_KEY="your-api-key-here"
-
-# Run with an AFM file
-afm path/to/agent.afm.md
-```
-
-## Configuration
-
-Configuration via environment variables or CLI options:
-
-- `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, etc. (Required based on provider)
-- HTTP port can be set via `-p` or `--port` (default: 8000)
-
-## Running with Docker
-
-```bash
-# Build the image
-docker build -t afm-langchain-interpreter .
-
-# Run with an AFM file mounted and API key
-docker run -v $(pwd)/path/to/agent.afm.md:/app/agent.afm.md \
-  -e OPENAI_API_KEY=$OPENAI_API_KEY \
-  -p 8000:8000 \
-  afm-langchain-interpreter afm /app/agent.afm.md
-```
-
-## Testing
-
-```bash
-uv run pytest
-```
-
-## Project Structure
-
-```
-langchain-interpreter/
-├── src/afm_cli/
-│   ├── interfaces/        # Interface implementations (console, web, webhook)
-│   ├── tools/             # Tool support (MCP server)
-│   ├── resources/         # Static assets (web UI)
-│   ├── agent.py           # Core agent logic
-│   ├── cli.py             # CLI entry point
-│   ├── parser.py          # AFM file parsing
-│   ├── models.py          # Model configuration
-│   ├── providers.py       # LLM provider handling
-│   └── templates.py       # Prompt templates
-├── tests/                 # Unit and integration tests
-├── afm-samples/           # Example AFM definitions
-├── Dockerfile             # Container build
-├── pyproject.toml         # Python project configuration
-└── uv.lock                # Dependency lock file
-```
-
-## License
-
-Apache-2.0

afm_cli-0.2.0/README.md

@@ -1,95 +0,0 @@
-# AFM LangChain Interpreter
-
-A LangChain-based reference implementation of an interpreter for [Agent-Flavored Markdown (AFM)](https://github.com/wso2/agent-flavored-markdown) files.
-
-## Features
-
-- **Support for all interface types:**
-  - Console chat (interactive CLI)
-  - Web chat (HTTP API + optional UI)
-  - Webhook (WebSub-based event handling)
-- **Multi-interface agents** - run multiple interfaces simultaneously
-- **MCP support** for tools (Model Context Protocol)
-- **Validation** - dry-run mode to validate AFM definitions
-
-## Prerequisites
-
-- [Python](https://www.python.org/) 3.12 or later.
-- [uv](https://docs.astral.sh/uv/) for dependency management.
-
-## Installation
-
-### Using pipx (Recommended)
-
-To run `afm` as a standalone command-line tool:
-
-```bash
-pipx install afm-cli
-```
-
-### Using pip
-
-```bash
-pip install afm-cli
-```
-
-## Quick Start
-
-```bash
-# Set your API Key
-export OPENAI_API_KEY="your-api-key-here"
-
-# Run with an AFM file
-afm path/to/agent.afm.md
-```
-
-## Configuration
-
-Configuration via environment variables or CLI options:
-
-- `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, etc. (Required based on provider)
-- HTTP port can be set via `-p` or `--port` (default: 8000)
-
-## Running with Docker
-
-```bash
-# Build the image
-docker build -t afm-langchain-interpreter .
-
-# Run with an AFM file mounted and API key
-docker run -v $(pwd)/path/to/agent.afm.md:/app/agent.afm.md \
-  -e OPENAI_API_KEY=$OPENAI_API_KEY \
-  -p 8000:8000 \
-  afm-langchain-interpreter afm /app/agent.afm.md
-```
-
-## Testing
-
-```bash
-uv run pytest
-```
-
-## Project Structure
-
-```
-langchain-interpreter/
-├── src/afm_cli/
-│   ├── interfaces/        # Interface implementations (console, web, webhook)
-│   ├── tools/             # Tool support (MCP server)
-│   ├── resources/         # Static assets (web UI)
-│   ├── agent.py           # Core agent logic
-│   ├── cli.py             # CLI entry point
-│   ├── parser.py          # AFM file parsing
-│   ├── models.py          # Model configuration
-│   ├── providers.py       # LLM provider handling
-│   └── templates.py       # Prompt templates
-├── tests/                 # Unit and integration tests
-├── afm-samples/           # Example AFM definitions
-├── Dockerfile             # Container build
-├── pyproject.toml         # Python project configuration
-└── uv.lock                # Dependency lock file
-```
-
-## License
-
-Apache-2.0

afm_cli-0.2.0/pyproject.toml

@@ -1,49 +0,0 @@
-[project]
-name = "afm-cli"
-version = "0.2.0"
-description = "AFM (Agent-Flavored Markdown) interpreter using LangChain"
-readme = "README.md"
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Programming Language :: Python :: 3.11",
-]
-license = "Apache-2.0"
-requires-python = ">=3.11"
-urls = { Repository = "https://github.com/RadCod3/reference-implementations-afm" }
-dependencies = [
-    "langchain>=1.2.8",
-    "pyyaml>=6.0",
-    "pydantic>=2.0",
-    "langchain-openai>=1.1.7",
-    "langchain-anthropic>=1.3.1",
-    "jsonschema>=4.26.0",
-    "fastapi>=0.128.1",
-    "httpx>=0.28.1",
-    "uvicorn>=0.40.0",
-    "mcp>=1.26.0",
-    "langchain-mcp-adapters>=0.2.1",
-    "click>=8.0.0",
-    "textual>=2.1.0",
-]
-
-[project.scripts]
-afm = "afm_cli.cli:main"
-
-[build-system]
-requires = ["uv_build>=0.9.28,<0.10.0"]
-build-backend = "uv_build"
-
-[tool.pytest.ini_options]
-testpaths = ["tests"]
-pythonpath = ["src"]
-asyncio_mode = "auto"
-asyncio_default_fixture_loop_scope = "function"
-
-[dependency-groups]
-dev = [
-    "ruff>=0.15.0",
-    "pytest>=8.0",
-    "pytest-cov>=7.0.0",
-    "pytest-asyncio>=1.3.0",
-    "textual-dev>=1.7.0",
-]

afm_cli-0.2.0/src/afm_cli/__init__.py

@@ -1,223 +0,0 @@
-# Copyright (c) 2025
-# Licensed under the Apache License, Version 2.0
-
-"""LangChain AFM Interpreter.
-
-A Python implementation of the AFM (Agent-Flavored Markdown) specification v0.3.0.
-
-This package provides:
-
-- **Parser**: Parse AFM files into structured Python objects
-- **Agent**: Execute agents using LangChain
-- **Interfaces**: Console chat, web chat, and webhook handlers
-
-Example usage::
-
-    from afm_cli import parse_afm_file, Agent
-    from afm_cli.interfaces import run_console_chat
-
-    afm = parse_afm_file("my_agent.afm.md")
-    agent = Agent(afm)
-    run_console_chat(agent)
-"""
-
-from .agent import Agent
-from .exceptions import (
-    AFMError,
-    AFMParseError,
-    AFMValidationError,
-    AgentConfigError,
-    AgentError,
-    InputValidationError,
-    InterfaceNotFoundError,
-    JSONAccessError,
-    MCPAuthenticationError,
-    MCPConnectionError,
-    MCPError,
-    MCPToolError,
-    OutputValidationError,
-    ProviderError,
-    TemplateCompilationError,
-    TemplateError,
-    TemplateEvaluationError,
-    VariableResolutionError,
-)
-from .interfaces import (
-    WebSubSubscriber,
-    ChatApp,
-    async_run_console_chat,
-    create_webchat_app,
-    create_webhook_app,
-    get_console_interface,
-    get_http_path,
-    get_interface_by_type,
-    get_interfaces,
-    get_primary_interface,
-    get_webchat_interface,
-    get_webhook_interface,
-    has_interface_type,
-    run_console_chat,
-    run_webchat_server,
-    run_webhook_server,
-    verify_webhook_signature,
-)
-from .models import (
-    AFMRecord,
-    AgentMetadata,
-    ClientAuthentication,
-    CompiledTemplate,
-    ConsoleChatInterface,
-    Exposure,
-    HeaderVariable,
-    HTTPExposure,
-    HttpTransport,
-    Interface,
-    InterfaceType,
-    JSONSchema,
-    LiteralSegment,
-    MCPServer,
-    Model,
-    PayloadVariable,
-    Provider,
-    Signature,
-    StdioTransport,
-    Subscription,
-    TemplateSegment,
-    ToolFilter,
-    Tools,
-    Transport,
-    TransportType,
-    WebChatInterface,
-    WebhookInterface,
-    get_filtered_tools,
-)
-from .parser import parse_afm, parse_afm_file, validate_and_extract_interfaces
-from .providers import (
-    create_model_provider,
-    get_supported_providers,
-)
-from .schema_validator import (
-    build_output_schema_instruction,
-    coerce_output_to_schema,
-    extract_json_from_response,
-    json_schema_to_dict,
-    validate_input,
-    validate_output,
-)
-from .templates import access_json_field, compile_template, evaluate_template
-from .tools import (
-    MCPClient,
-    MCPManager,
-    filter_tools,
-)
-from .variables import (
-    contains_http_variable,
-    resolve_variables,
-    validate_http_variables,
-)
-from .cli import create_unified_app, main
-
-__version__ = "0.1.0"
-
-__all__ = [
-    # Version
-    "__version__",
-    # Parser Functions
-    "parse_afm",
-    "parse_afm_file",
-    "validate_and_extract_interfaces",
-    # Variables
-    "resolve_variables",
-    "contains_http_variable",
-    "validate_http_variables",
-    # Templates
-    "compile_template",
-    "evaluate_template",
-    "access_json_field",
-    # Models
-    "AFMRecord",
-    "AgentMetadata",
-    "Provider",
-    "Model",
-    "ClientAuthentication",
-    "HttpTransport",
-    "StdioTransport",
-    "Transport",
-    "TransportType",
-    "ToolFilter",
-    "MCPServer",
-    "Tools",
-    "JSONSchema",
-    "Signature",
-    "HTTPExposure",
-    "Exposure",
-    "Subscription",
-    "InterfaceType",
-    "ConsoleChatInterface",
-    "WebChatInterface",
-    "WebhookInterface",
-    "Interface",
-    "CompiledTemplate",
-    "LiteralSegment",
-    "PayloadVariable",
-    "HeaderVariable",
-    "TemplateSegment",
-    "get_filtered_tools",
-    # Exceptions
-    "AFMError",
-    "AFMParseError",
-    "AFMValidationError",
-    "VariableResolutionError",
-    "TemplateError",
-    "TemplateCompilationError",
-    "TemplateEvaluationError",
-    "JSONAccessError",
-    # Agent Class
-    "Agent",
-    # Provider Factory
-    "create_model_provider",
-    "get_supported_providers",
-    # Schema Validation
-    "validate_input",
-    "validate_output",
-    "coerce_output_to_schema",
-    "extract_json_from_response",
-    "json_schema_to_dict",
-    "build_output_schema_instruction",
-    "AgentError",
-    "AgentConfigError",
-    "ProviderError",
-    "InputValidationError",
-    "OutputValidationError",
-    "InterfaceNotFoundError",
-    # MCP Exceptions
-    "MCPError",
-    "MCPConnectionError",
-    "MCPToolError",
-    "MCPAuthenticationError",
-    # MCP Classes
-    "MCPClient",
-    "MCPManager",
-    "filter_tools",
-    # Interface Functions
-    "get_interfaces",
-    "get_interface_by_type",
-    "get_console_interface",
-    "get_webchat_interface",
-    "get_webhook_interface",
-    "get_primary_interface",
-    "has_interface_type",
-    "get_http_path",
-    "ChatApp",
-    "run_console_chat",
-    "async_run_console_chat",
-    "create_webchat_app",
-    "run_webchat_server",
-    "create_webhook_app",
-    "run_webhook_server",
-    "WebSubSubscriber",
-    "verify_webhook_signature",
-    # CLI
-    "main",
-    "create_unified_app",
-]