afm-cli 0.1.0__tar.gz

afm_cli-0.1.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.3
+Name: afm-cli
+Version: 0.1.0
+Summary: AFM (Agent-Flavored Markdown) interpreter using LangChain
+Author: Radith Samarakoon
+Author-email: Radith Samarakoon <jjeli1234@gmail.com>
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+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_cli-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "afm-cli"
+version = "0.1.0"
+description = "AFM (Agent-Flavored Markdown) interpreter using LangChain"
+readme = "README.md"
+authors = [{ name = "Radith Samarakoon", email = "jjeli1234@gmail.com" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3.11",
+]
+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.1.0/src/afm_cli/__init__.py

@@ -0,0 +1,221 @@
+# 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,
+    Interface,
+    InterfaceType,
+    JSONSchema,
+    LiteralSegment,
+    MCPServer,
+    Model,
+    PayloadVariable,
+    Provider,
+    Signature,
+    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,
+    build_auth_headers,
+    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",
+    "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",
+    "build_auth_headers",
+    "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",
+]