matimo 0.1.3__tar.gz → 0.2.0__tar.gz

{matimo-0.1.3 → matimo-0.2.0}/.gitignore

@@ -58,7 +58,6 @@ temp/
 
 # Personal scratch notes / working docs — not part of the shipped repo
 .local-notes/
-typescript/examples/mcp/matimo-tools/.matimo-approvals.json
 typescript/examples/mcp/matimo-tools/fetch-weather/definition.yaml
 typescript/examples/mcp/matimo-tools/npm_downloads/definition.yaml
 typescript/examples/mcp/matimo-tools/skills/ecosystem-health/SKILL.md
@@ -68,3 +67,6 @@ typescript/packages/cli/.matimo/certs/server.crt
 typescript/packages/cli/.matimo/certs/server.key
 typescript/examples/mcp/.matimo/certs/server.crt
 typescript/examples/mcp/.matimo/certs/server.key
+
+# HITL approval manifests are per-machine state (HMAC-signed approvals); never commit one
+**/.matimo-approvals.json

matimo-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ROAIQ TECHNOLOGIES PRIVATE LIMITED
+
+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.

{matimo-0.1.3 → matimo-0.2.0}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.5
 Name: matimo
-Version: 0.1.3
+Version: 0.2.0
 Summary: Matimo — framework-agnostic SDK: pre-built providers, skills layer, MCP out of the box, and autonomous agents governed by a policy engine you control
 Project-URL: Homepage, https://matimo.dev
-Project-URL: Documentation, https://matimo.dev/docs
+Project-URL: Documentation, https://docs.matimo.dev/
 Project-URL: Repository, https://github.com/tallclub/matimo
 Project-URL: Issues, https://github.com/tallclub/matimo/issues
 License: MIT
-Keywords: agentic-ai,agents,ai,ai-governance,crewai,langchain,matimo,mcp,mcp-server,policy-engine,tools
+License-File: LICENSE
+Keywords: agentic-ai,agents,agno,ai,ai-governance,crewai,langchain,matimo,mcp,mcp-server,policy-engine,tools
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -17,8 +18,10 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries
 Requires-Python: >=3.11
-Requires-Dist: matimo-cli<0.2.0,>=0.1.0a14.post1
-Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Requires-Dist: matimo-cli<0.3.0,>=0.2.0
+Requires-Dist: matimo-core<0.3.0,>=0.2.0
+Provides-Extra: agno
+Requires-Dist: matimo-core[agno]; extra == 'agno'
 Provides-Extra: all
 Requires-Dist: matimo-core[all]; extra == 'all'
 Provides-Extra: aws
@@ -41,7 +44,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI](https://img.shields.io/pypi/v/matimo)](https://pypi.org/project/matimo/)
 [![Python](https://img.shields.io/pypi/pyversions/matimo)](https://pypi.org/project/matimo/)
-[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+[![Docs](https://img.shields.io/badge/docs-docs.matimo.dev-blue)](https://docs.matimo.dev)
 
 `matimo` is the convenience meta-package that installs [`matimo-core`](https://pypi.org/project/matimo-core/) and [`matimo-cli`](https://pypi.org/project/matimo-cli/). Provider packages (Slack, GitHub, Gmail, etc.) are installed separately.
 
@@ -56,6 +59,7 @@ pip install matimo
 # With optional framework integrations
 pip install "matimo[langchain]"   # LangChain support
 pip install "matimo[crewai]"      # CrewAI support
+pip install "matimo[agno]"        # Agno support
 pip install "matimo[mcp]"         # MCP server support
 
 # With secrets backends
@@ -114,24 +118,16 @@ result = await matimo.execute('slack_send_channel_message', {
 ### LangChain agent
 
 ```python
-from matimo import Matimo
-from matimo.integrations.langchain import convert_tools_to_langchain
+from matimo import Matimo, convert_tools_to_langchain
 from langchain_openai import ChatOpenAI
-from langchain.agents import AgentExecutor, create_tool_calling_agent
-from langchain_core.prompts import ChatPromptTemplate
+from langchain.agents import create_agent   # LangChain 1.x
 
 matimo = await Matimo.init(auto_discover=True)
-lc_tools = convert_tools_to_langchain(matimo.list_tools(), matimo)
-
-llm = ChatOpenAI(model='gpt-4o-mini')
-prompt = ChatPromptTemplate.from_messages([
-    ('system', 'You are a helpful assistant.'),
-    ('human', '{input}'),
-    ('placeholder', '{agent_scratchpad}'),
-])
-agent = create_tool_calling_agent(llm, lc_tools, prompt)
-executor = AgentExecutor(agent=agent, tools=lc_tools)
-result = await executor.ainvoke({'input': 'List all Slack channels'})
+slack = [t for t in matimo.list_tools() if t.name.startswith('slack')]
+lc_tools = convert_tools_to_langchain(slack, matimo)   # pass a short list: OpenAI accepts at most 128 tools
+
+agent = create_agent(ChatOpenAI(model='gpt-4o-mini'), tools=lc_tools)
+result = await agent.ainvoke({'messages': [('user', 'List all Slack channels')]})
 ```
 
 ### CrewAI agent
@@ -147,13 +143,28 @@ crewai_tools = convert_tools_to_crewai(matimo.list_tools(), matimo)
 ### MCP server (Claude Desktop / Cursor)
 
 ```python
-from matimo import Matimo, create_mcp_server, MCPServerOptions
+from matimo import Matimo, MCPServer, MCPServerOptions
 
 matimo = await Matimo.init(auto_discover=True)
-server = await create_mcp_server(matimo, MCPServerOptions(name='my-agent', version='1.0.0'))
+server = MCPServer(matimo, MCPServerOptions(transport='stdio'))
 await server.start()
 ```
 
+Or from the shell: `matimo mcp`.
+
+### Approval
+
+Calls that need approval (HTTP DELETE, shell commands, tools marked `requires_approval`) ask your callback:
+
+```python
+from matimo import ApprovalRequest, Matimo
+
+async def confirm(request: ApprovalRequest) -> bool:
+    return input(f"Allow {request.tool_name}? [y/N] ").strip().lower() == "y"
+
+matimo = await Matimo.init(auto_discover=True, on_approval=confirm)
+```
+
 ---
 
 ## Provider Packages
@@ -179,8 +190,8 @@ Install the tools you need:
 
 - **YAML-defined tools** - define once, use from any framework
 - **10 provider packages** - 100+ pre-built tools ready to use
-- **LangChain / CrewAI / MCP** - first-class integrations
-- **Policy engine** - risk classification, HITL approvals, content validation
+- **LangChain / CrewAI / Agno / MCP** - first-class integrations
+- **Policy engine** - risk classification, per-call approval, HITL quarantine, content validation, hash-chained audit log
 - **Skills system** - inject reusable domain knowledge into agents
 - **Meta-tools** - agents can create, approve, and reload tools at runtime
 - **Secrets management** - env, `.env`, Vault, AWS Secrets Manager resolver chain
@@ -190,19 +201,19 @@ Install the tools you need:
 
 ## Documentation
 
-- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
-- [API Reference](https://matimo.dev/docs/api-reference/SDK)
-- [LangChain Integration](https://matimo.dev/docs/framework-integrations/LANGCHAIN)
-- [CrewAI Integration](https://matimo.dev/docs/framework-integrations/CREWAI)
-- [MCP Guide](https://matimo.dev/docs/MCP)
-- [Policy & Lifecycle](https://matimo.dev/docs/api-reference/POLICY_AND_LIFECYCLE)
+- [Getting Started](https://docs.matimo.dev/getting-started/QUICK_START)
+- [API Reference](https://docs.matimo.dev/api-reference/SDK)
+- [LangChain Integration](https://docs.matimo.dev/framework-integrations/LANGCHAIN)
+- [CrewAI Integration](https://docs.matimo.dev/framework-integrations/CREWAI)
+- [MCP Guide](https://docs.matimo.dev/MCP)
+- [Policy & Lifecycle](https://docs.matimo.dev/api-reference/POLICY_AND_LIFECYCLE)
 
 ---
 
 ## Links
 
 - **PyPI:** https://pypi.org/project/matimo/
-- **Docs:** https://matimo.dev/docs
+- **Docs:** https://docs.matimo.dev
 - **GitHub:** https://github.com/tallclub/matimo
 - **Changelog:** https://github.com/tallclub/matimo/blob/main/docs/RELEASES.md
 

{matimo-0.1.3 → matimo-0.2.0}/README.md

@@ -4,7 +4,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/matimo)](https://pypi.org/project/matimo/)
 [![Python](https://img.shields.io/pypi/pyversions/matimo)](https://pypi.org/project/matimo/)
-[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+[![Docs](https://img.shields.io/badge/docs-docs.matimo.dev-blue)](https://docs.matimo.dev)
 
 `matimo` is the convenience meta-package that installs [`matimo-core`](https://pypi.org/project/matimo-core/) and [`matimo-cli`](https://pypi.org/project/matimo-cli/). Provider packages (Slack, GitHub, Gmail, etc.) are installed separately.
 
@@ -19,6 +19,7 @@ pip install matimo
 # With optional framework integrations
 pip install "matimo[langchain]"   # LangChain support
 pip install "matimo[crewai]"      # CrewAI support
+pip install "matimo[agno]"        # Agno support
 pip install "matimo[mcp]"         # MCP server support
 
 # With secrets backends
@@ -77,24 +78,16 @@ result = await matimo.execute('slack_send_channel_message', {
 ### LangChain agent
 
 ```python
-from matimo import Matimo
-from matimo.integrations.langchain import convert_tools_to_langchain
+from matimo import Matimo, convert_tools_to_langchain
 from langchain_openai import ChatOpenAI
-from langchain.agents import AgentExecutor, create_tool_calling_agent
-from langchain_core.prompts import ChatPromptTemplate
+from langchain.agents import create_agent   # LangChain 1.x
 
 matimo = await Matimo.init(auto_discover=True)
-lc_tools = convert_tools_to_langchain(matimo.list_tools(), matimo)
-
-llm = ChatOpenAI(model='gpt-4o-mini')
-prompt = ChatPromptTemplate.from_messages([
-    ('system', 'You are a helpful assistant.'),
-    ('human', '{input}'),
-    ('placeholder', '{agent_scratchpad}'),
-])
-agent = create_tool_calling_agent(llm, lc_tools, prompt)
-executor = AgentExecutor(agent=agent, tools=lc_tools)
-result = await executor.ainvoke({'input': 'List all Slack channels'})
+slack = [t for t in matimo.list_tools() if t.name.startswith('slack')]
+lc_tools = convert_tools_to_langchain(slack, matimo)   # pass a short list: OpenAI accepts at most 128 tools
+
+agent = create_agent(ChatOpenAI(model='gpt-4o-mini'), tools=lc_tools)
+result = await agent.ainvoke({'messages': [('user', 'List all Slack channels')]})
 ```
 
 ### CrewAI agent
@@ -110,13 +103,28 @@ crewai_tools = convert_tools_to_crewai(matimo.list_tools(), matimo)
 ### MCP server (Claude Desktop / Cursor)
 
 ```python
-from matimo import Matimo, create_mcp_server, MCPServerOptions
+from matimo import Matimo, MCPServer, MCPServerOptions
 
 matimo = await Matimo.init(auto_discover=True)
-server = await create_mcp_server(matimo, MCPServerOptions(name='my-agent', version='1.0.0'))
+server = MCPServer(matimo, MCPServerOptions(transport='stdio'))
 await server.start()
 ```
 
+Or from the shell: `matimo mcp`.
+
+### Approval
+
+Calls that need approval (HTTP DELETE, shell commands, tools marked `requires_approval`) ask your callback:
+
+```python
+from matimo import ApprovalRequest, Matimo
+
+async def confirm(request: ApprovalRequest) -> bool:
+    return input(f"Allow {request.tool_name}? [y/N] ").strip().lower() == "y"
+
+matimo = await Matimo.init(auto_discover=True, on_approval=confirm)
+```
+
 ---
 
 ## Provider Packages
@@ -142,8 +150,8 @@ Install the tools you need:
 
 - **YAML-defined tools** - define once, use from any framework
 - **10 provider packages** - 100+ pre-built tools ready to use
-- **LangChain / CrewAI / MCP** - first-class integrations
-- **Policy engine** - risk classification, HITL approvals, content validation
+- **LangChain / CrewAI / Agno / MCP** - first-class integrations
+- **Policy engine** - risk classification, per-call approval, HITL quarantine, content validation, hash-chained audit log
 - **Skills system** - inject reusable domain knowledge into agents
 - **Meta-tools** - agents can create, approve, and reload tools at runtime
 - **Secrets management** - env, `.env`, Vault, AWS Secrets Manager resolver chain
@@ -153,19 +161,19 @@ Install the tools you need:
 
 ## Documentation
 
-- [Getting Started](https://matimo.dev/docs/getting-started/QUICK_START)
-- [API Reference](https://matimo.dev/docs/api-reference/SDK)
-- [LangChain Integration](https://matimo.dev/docs/framework-integrations/LANGCHAIN)
-- [CrewAI Integration](https://matimo.dev/docs/framework-integrations/CREWAI)
-- [MCP Guide](https://matimo.dev/docs/MCP)
-- [Policy & Lifecycle](https://matimo.dev/docs/api-reference/POLICY_AND_LIFECYCLE)
+- [Getting Started](https://docs.matimo.dev/getting-started/QUICK_START)
+- [API Reference](https://docs.matimo.dev/api-reference/SDK)
+- [LangChain Integration](https://docs.matimo.dev/framework-integrations/LANGCHAIN)
+- [CrewAI Integration](https://docs.matimo.dev/framework-integrations/CREWAI)
+- [MCP Guide](https://docs.matimo.dev/MCP)
+- [Policy & Lifecycle](https://docs.matimo.dev/api-reference/POLICY_AND_LIFECYCLE)
 
 ---
 
 ## Links
 
 - **PyPI:** https://pypi.org/project/matimo/
-- **Docs:** https://matimo.dev/docs
+- **Docs:** https://docs.matimo.dev
 - **GitHub:** https://github.com/tallclub/matimo
 - **Changelog:** https://github.com/tallclub/matimo/blob/main/docs/RELEASES.md
 

{matimo-0.1.3 → matimo-0.2.0}/pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "hatchling.build"
 
 [project]
 name = "matimo"
-version = "0.1.3"
+version = "0.2.0"
 description = "Matimo — framework-agnostic SDK: pre-built providers, skills layer, MCP out of the box, and autonomous agents governed by a policy engine you control"
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.11"
-keywords = ["ai", "tools", "agents", "langchain", "crewai", "mcp", "matimo", "mcp-server", "agentic-ai", "ai-governance", "policy-engine"]
+keywords = ["ai", "tools", "agents", "langchain", "crewai", "agno", "mcp", "matimo", "mcp-server", "agentic-ai", "ai-governance", "policy-engine"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
@@ -23,13 +23,14 @@ classifiers = [
 # This is a meta-package: pip install matimo pulls in matimo-core and matimo-cli
 # which provides the actual `matimo` Python namespace and CLI tools.
 dependencies = [
-    "matimo-core>=0.1.0,<0.2.0",
-    "matimo-cli>=0.1.0a14.post1,<0.2.0",
+    "matimo-core>=0.2.0,<0.3.0",
+    "matimo-cli>=0.2.0,<0.3.0",
 ]
 
 [project.optional-dependencies]
 langchain = ["matimo-core[langchain]"]
 crewai = ["matimo-core[crewai]"]
+agno = ["matimo-core[agno]"]
 mcp = ["matimo-core[mcp]"]
 dotenv = ["matimo-core[dotenv]"]
 vault = ["matimo-core[vault]"]
@@ -38,7 +39,7 @@ all = ["matimo-core[all]"]
 
 [project.urls]
 Homepage = "https://matimo.dev"
-Documentation = "https://matimo.dev/docs"
+Documentation = "https://docs.matimo.dev/"
 Repository = "https://github.com/tallclub/matimo"
 Issues = "https://github.com/tallclub/matimo/issues"
 

{matimo-0.1.3 → matimo-0.2.0}/src/matimo/__init__.py

@@ -28,7 +28,7 @@ try:
     from importlib.metadata import version as _pkg_version
     __version__ = _pkg_version("matimo")
 except Exception:
-    __version__ = "0.1.1.post1"  # fallback for editable / source installs
+    __version__ = "0.2.0"  # fallback for editable / source installs
 
 # ---------------------------------------------------------------------------
 # matimo-core re-exports
@@ -41,6 +41,7 @@ from matimo.approval.handler import (  # noqa: E402
     ApprovalCallback,
     ApprovalHandler,
     ApprovalRequest,
+    definition_requires_approval,
     get_global_approval_handler,
     set_global_approval_handler,
 )
@@ -129,7 +130,7 @@ from matimo.errors import (  # noqa: E402
 
 # Executors
 from matimo.executors.command_executor import CommandExecutor  # noqa: E402
-from matimo.executors.function_executor import FunctionExecutor  # noqa: E402
+from matimo.executors.function_executor import FunctionExecutor, FunctionToolContext  # noqa: E402
 from matimo.executors.http_executor import HttpExecutor  # noqa: E402
 
 # Main entry point + sync API
@@ -157,12 +158,26 @@ from matimo.mcp.tool_converter import convert_parameters_to_mcp_schema  # noqa:
 
 # Policy
 from matimo.policy.approval_manifest import ApprovalManifest, ApprovalRecord  # noqa: E402
+from matimo.policy.audit_sink import (  # noqa: E402
+    AUDIT_GENESIS_HASH,
+    AuditLogVerification,
+    AuditSink,
+    JsonlFileSink,
+    hash_audit_entry,
+    redact_secrets,
+    verify_audit_log,
+)
 from matimo.policy.content_validator import ContentViolation, validate_tool_content  # noqa: E402
 from matimo.policy.default_policy import DefaultPolicyEngine, PolicyEngine, get_tier_for_tool  # noqa: E402
 from matimo.policy.integrity_tracker import IntegrityAction, ToolIntegrityTracker  # noqa: E402
 from matimo.policy.policy_loader import load_policy_from_file  # noqa: E402
-from matimo.policy.risk_classifier import classify_risk  # noqa: E402
+from matimo.policy.risk_classifier import (  # noqa: E402
+    classify_execution_risk,
+    classify_risk,
+    meets_risk_threshold,
+)
 from matimo.policy.types import (  # noqa: E402
+    GovernanceMode,
     HITLCallback,
     HITLRequest,
     MatimoEvent,
@@ -223,6 +238,30 @@ def convert_tools_to_crewai(
     return _inner(tools, matimo_instance, credentials)
 
 
+def convert_tools_to_agno(
+    tools: list[ToolDefinition],
+    matimo_instance: Matimo,
+    credentials: dict[str, str] | None = None,
+    **kwargs: object,
+) -> list[object]:
+    """Convert Matimo tools to Agno Function list. Requires agno."""
+    from matimo.integrations.agno import convert_tools_to_agno as _inner
+    return _inner(tools, matimo_instance, credentials, **kwargs)  # type: ignore[arg-type]
+
+
+def MatimoTools(  # noqa: N802
+    matimo_instance: Matimo,
+    tools: list[ToolDefinition] | None = None,
+    **kwargs: object,
+) -> object:
+    """Build an Agno Toolkit exposing governed Matimo tools. Requires agno.
+
+    Named in CapWords to match Agno's <Name>Tools toolkit convention.
+    """
+    from matimo.integrations.agno import MatimoTools as _inner
+    return _inner(matimo_instance, tools, **kwargs)  # type: ignore[arg-type]
+
+
 def get_core_tools_path() -> str:
     """Return the absolute path to matimo-core's bundled tool definitions.
 
@@ -277,7 +316,7 @@ __all__ = [
     "ParsedSkillContent", "SemanticSearchResult",
     "TfIdfEmbeddingProvider", "EmbeddingProvider", "cosine_similarity",
     # Executors
-    "HttpExecutor", "CommandExecutor", "FunctionExecutor",
+    "HttpExecutor", "CommandExecutor", "FunctionExecutor", "FunctionToolContext",
     # Auth
     "inject_auth_parameters", "extract_parameter_placeholders",
     "OAuth2Handler", "OAuth2ProviderLoader",
@@ -285,15 +324,19 @@ __all__ = [
     # Approval
     "ApprovalHandler", "ApprovalRequest", "ApprovalCallback",
     "get_global_approval_handler", "set_global_approval_handler",
+    "definition_requires_approval",
     # Encodings
     "apply_parameter_encodings",
     # Policy
     "PolicyEngine", "DefaultPolicyEngine", "PolicyConfig",
     "PolicyDecision", "PolicyAllowed", "PolicyDenied", "PolicyPendingApproval",
-    "RiskLevel", "PolicyTier", "MatimoEvent", "MatimoEventHandler",
+    "RiskLevel", "PolicyTier", "MatimoEvent", "MatimoEventHandler", "GovernanceMode",
     "HITLCallback", "HITLRequest", "ContentViolation", "validate_tool_content",
-    "classify_risk", "get_tier_for_tool", "ToolIntegrityTracker", "IntegrityAction",
+    "classify_risk", "classify_execution_risk", "meets_risk_threshold",
+    "get_tier_for_tool", "ToolIntegrityTracker", "IntegrityAction",
     "ApprovalManifest", "ApprovalRecord", "load_policy_from_file",
+    "AuditSink", "JsonlFileSink", "AuditLogVerification", "verify_audit_log",
+    "redact_secrets", "hash_audit_entry", "AUDIT_GENESIS_HASH",
     # MCP
     "MCPServer", "MCPServerOptions", "create_mcp_server",
     "convert_parameters_to_mcp_schema",
@@ -303,6 +346,7 @@ __all__ = [
     # Integrations
     "convert_tools_to_langchain", "get_skills_metadata",
     "build_relevant_skill_prompt", "convert_tools_to_crewai",
+    "convert_tools_to_agno", "MatimoTools",
     # Decorators
     "tool", "set_global_matimo_instance", "get_global_matimo_instance",
     # Logging