matimo-github 0.1.0__tar.gz

matimo_github-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Dependencies
+**/node_modules/
+package-lock.json
+yarn.lock
+
+# Build output
+**/dist/
+*.tsbuildinfo
+
+# Python compiled / build
+**/__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+**/build/
+**/.eggs/
+**/.venv/
+**/.mypy_cache/
+**/.ruff_cache/
+**/.pytest_cache/
+
+# Test coverage
+**/coverage/
+**/.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+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
+typescript/examples/mcp/matimo-tools/skills/matimo-health-check/SKILL.md
+typescript/examples/mcp/matimo-tools/skills/moltbook-identity/SKILL.md
+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

matimo_github-0.1.0/PKG-INFO

@@ -0,0 +1,151 @@
+Metadata-Version: 2.4
+Name: matimo-github
+Version: 0.1.0
+Summary: Matimo provider — GitHub tools (repos, issues, PRs, releases)
+License: MIT
+Keywords: agents,ai,github,matimo,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Requires-Dist: matimo-core<0.2.0,>=0.1.0
+Description-Content-Type: text/markdown
+
+# matimo-github
+
+> GitHub tools for [Matimo](https://matimo.dev) — manage repositories, issues, pull requests, releases, and more.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-github)](https://pypi.org/project/matimo-github/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-github
+```
+
+---
+
+## Available Tools (27 Total)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **Repositories** | `get-repository` | Get repository details |
+| | `list-repositories` | List repositories for user/org |
+| | `create-repository` | Create a new repository |
+| | `delete-repository` | Delete a repository |
+| | `search-repositories` | Search GitHub repositories |
+| **Issues** | `list-issues` | List issues in a repository |
+| | `get-issue` | Get a single issue |
+| | `create-issue` | Create a new issue |
+| | `update-issue` | Update issue title, body, state, labels |
+| | `search-issues` | Search issues across GitHub |
+| **Pull Requests** | `list-pull-requests` | List PRs in a repository |
+| | `create-pull-request` | Open a new pull request |
+| | `merge-pull-request` | Merge a pull request |
+| **Releases** | `list-releases` | List releases for a repository |
+| | `create-release` | Create a new release with tag |
+| **Commits** | `list-commits` | List commits on a branch |
+| **Collaborators** | `list-collaborators` | List repository collaborators |
+| | `add-collaborator` | Add a collaborator |
+| **Code Search** | `search-code` | Search code across repositories |
+| | `search-users` | Search GitHub users |
+| **Security** | `list-code-alerts` | List Dependabot/code scanning alerts |
+| | `update-code-alert` | Dismiss or resolve a code alert |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_github import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # List open issues
+    result = await matimo.execute('list-issues', {
+        'owner': 'my-org',
+        'repo': 'my-repo',
+        'state': 'open',
+    })
+
+    # Create an issue
+    await matimo.execute('create-issue', {
+        'owner': 'my-org',
+        'repo': 'my-repo',
+        'title': 'Bug: login fails on mobile',
+        'body': 'Steps to reproduce...',
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export GITHUB_TOKEN="ghp_your-personal-access-token"
+```
+
+### Required Scopes
+
+| Operations | Required Scope |
+|-----------|---------------|
+| Read public repos, issues, PRs | `public_repo` |
+| Read private repositories | `repo` |
+| Create/update issues, PRs | `repo` |
+| Manage collaborators | `repo` + `admin:org` |
+| Delete repositories | `delete_repo` |
+| Read security alerts | `security_events` |
+
+---
+
+## LangChain Agent Example
+
+```python
+from matimo import Matimo
+from matimo_github import get_tools_path
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(get_tools_path())
+lc_tools = convert_tools_to_langchain(
+    matimo.list_tools(), matimo,
+    credentials={'GITHUB_TOKEN': os.environ['GITHUB_TOKEN']},
+)
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a GitHub 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 open issues in tallclub/matimo'})
+```
+
+---
+
+## Documentation
+
+- [GitHub REST API Reference](https://docs.github.com/en/rest)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/github)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-github/
+- **GitHub:** https://github.com/tallclub/matimo
+- **GitHub Docs:** https://docs.github.com/en/rest
+

matimo_github-0.1.0/README.md

@@ -0,0 +1,137 @@
+# matimo-github
+
+> GitHub tools for [Matimo](https://matimo.dev) — manage repositories, issues, pull requests, releases, and more.
+
+[![PyPI](https://img.shields.io/pypi/v/matimo-github)](https://pypi.org/project/matimo-github/)
+[![Docs](https://img.shields.io/badge/docs-matimo.dev-blue)](https://matimo.dev/docs)
+
+---
+
+## Installation
+
+```bash
+pip install matimo matimo-github
+```
+
+---
+
+## Available Tools (27 Total)
+
+| Category | Tool | Description |
+|----------|------|-------------|
+| **Repositories** | `get-repository` | Get repository details |
+| | `list-repositories` | List repositories for user/org |
+| | `create-repository` | Create a new repository |
+| | `delete-repository` | Delete a repository |
+| | `search-repositories` | Search GitHub repositories |
+| **Issues** | `list-issues` | List issues in a repository |
+| | `get-issue` | Get a single issue |
+| | `create-issue` | Create a new issue |
+| | `update-issue` | Update issue title, body, state, labels |
+| | `search-issues` | Search issues across GitHub |
+| **Pull Requests** | `list-pull-requests` | List PRs in a repository |
+| | `create-pull-request` | Open a new pull request |
+| | `merge-pull-request` | Merge a pull request |
+| **Releases** | `list-releases` | List releases for a repository |
+| | `create-release` | Create a new release with tag |
+| **Commits** | `list-commits` | List commits on a branch |
+| **Collaborators** | `list-collaborators` | List repository collaborators |
+| | `add-collaborator` | Add a collaborator |
+| **Code Search** | `search-code` | Search code across repositories |
+| | `search-users` | Search GitHub users |
+| **Security** | `list-code-alerts` | List Dependabot/code scanning alerts |
+| | `update-code-alert` | Dismiss or resolve a code alert |
+
+---
+
+## Quick Start
+
+```python
+import asyncio
+import os
+from matimo import Matimo
+from matimo_github import get_tools_path
+
+async def main():
+    matimo = await Matimo.init(get_tools_path())
+
+    # List open issues
+    result = await matimo.execute('list-issues', {
+        'owner': 'my-org',
+        'repo': 'my-repo',
+        'state': 'open',
+    })
+
+    # Create an issue
+    await matimo.execute('create-issue', {
+        'owner': 'my-org',
+        'repo': 'my-repo',
+        'title': 'Bug: login fails on mobile',
+        'body': 'Steps to reproduce...',
+    })
+
+asyncio.run(main())
+```
+
+---
+
+## Authentication
+
+```bash
+export GITHUB_TOKEN="ghp_your-personal-access-token"
+```
+
+### Required Scopes
+
+| Operations | Required Scope |
+|-----------|---------------|
+| Read public repos, issues, PRs | `public_repo` |
+| Read private repositories | `repo` |
+| Create/update issues, PRs | `repo` |
+| Manage collaborators | `repo` + `admin:org` |
+| Delete repositories | `delete_repo` |
+| Read security alerts | `security_events` |
+
+---
+
+## LangChain Agent Example
+
+```python
+from matimo import Matimo
+from matimo_github import get_tools_path
+from matimo.integrations.langchain import convert_tools_to_langchain
+from langchain_openai import ChatOpenAI
+from langchain.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate
+
+matimo = await Matimo.init(get_tools_path())
+lc_tools = convert_tools_to_langchain(
+    matimo.list_tools(), matimo,
+    credentials={'GITHUB_TOKEN': os.environ['GITHUB_TOKEN']},
+)
+llm = ChatOpenAI(model='gpt-4o-mini')
+prompt = ChatPromptTemplate.from_messages([
+    ('system', 'You are a GitHub 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 open issues in tallclub/matimo'})
+```
+
+---
+
+## Documentation
+
+- [GitHub REST API Reference](https://docs.github.com/en/rest)
+- [Python Examples](https://github.com/tallclub/matimo/tree/main/python/examples/native/github)
+
+---
+
+## Links
+
+- **PyPI:** https://pypi.org/project/matimo-github/
+- **GitHub:** https://github.com/tallclub/matimo
+- **GitHub Docs:** https://docs.github.com/en/rest
+

matimo_github-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "matimo-github"
+version = "0.1.0"
+description = "Matimo provider — GitHub tools (repos, issues, PRs, releases)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.11"
+keywords = ["ai", "tools", "agents", "matimo", "github"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+]
+dependencies = [
+    "matimo-core>=0.1.0,<0.2.0",
+]
+
+[project.entry-points."matimo.providers"]
+github = "matimo_github:get_tools_path"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/matimo_github"]

matimo_github-0.1.0/src/matimo_github/__init__.py

@@ -0,0 +1,17 @@
+"""Matimo github provider — exposes the path to YAML tool definitions."""
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+
+def get_tools_path() -> str:
+    """Return the absolute path to the bundled github tool definitions."""
+    try:
+        ref = importlib.resources.files("matimo_github") / "tools"
+        return str(ref)
+    except Exception:
+        return str(Path(__file__).parent / "tools")
+
+
+__all__ = ["get_tools_path"]

matimo_github-0.1.0/src/matimo_github/tools/add-collaborator/definition.yaml

@@ -0,0 +1,73 @@
+name: github-add-collaborator
+description: Add a user as a collaborator to a repository
+version: '1.0.0'
+requires_approval: true
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  username:
+    type: string
+    required: true
+    description: GitHub username to add
+  permission:
+    type: string
+    required: false
+    description: Permission level - pull, triage, push, maintain, or admin
+    default: push
+
+execution:
+  type: http
+  method: PUT
+  url: 'https://api.github.com/repos/{owner}/{repo}/collaborators/{username}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    permission: '{permission}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Repository administration
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    invitee:
+      type: object
+    permissions:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Add collaborator with push access
+    params:
+      owner: myorg
+      repo: myrepo
+      username: newuser
+      permission: push
+  - name: Add collaborator with admin access
+    params:
+      owner: myorg
+      repo: myrepo
+      username: admin_user
+      permission: admin

matimo_github-0.1.0/src/matimo_github/tools/create-issue/definition.yaml

@@ -0,0 +1,96 @@
+name: github-create-issue
+description: Create a new issue in a repository
+version: '1.0.0'
+requires_approval: true
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  title:
+    type: string
+    required: true
+    description: Issue title
+  body:
+    type: string
+    required: false
+    description: Issue description (markdown supported)
+  assignees:
+    type: array
+    required: false
+    description: Array of github usernames to assign
+  labels:
+    type: array
+    required: false
+    description: Array of label names
+  milestone:
+    type: number
+    required: false
+    description: Milestone ID number
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.github.com/repos/{owner}/{repo}/issues'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    title: '{title}'
+    body: '{body}'
+    assignees: '{assignees}'
+    labels: '{labels}'
+    milestone: '{milestone}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Issues write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    number:
+      type: number
+      description: Issue number in repository
+    title:
+      type: string
+    state:
+      type: string
+    html_url:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Create simple issue
+    params:
+      owner: myorg
+      repo: myrepo
+      title: Bug in login flow
+      body: Users cannot log in with SSO
+  - name: Create issue with labels
+    params:
+      owner: myorg
+      repo: myrepo
+      title: Add dark mode
+      body: Implement dark theme
+      labels:
+        - enhancement
+        - ui

matimo_github-0.1.0/src/matimo_github/tools/create-pull-request/definition.yaml

@@ -0,0 +1,103 @@
+name: github-create-pull-request
+description: Create a new pull request
+version: '1.0.0'
+requires_approval: true
+
+parameters:
+  owner:
+    type: string
+    required: true
+    description: Repository owner username or organization
+  repo:
+    type: string
+    required: true
+    description: Repository name
+  title:
+    type: string
+    required: true
+    description: Pull request title
+  body:
+    type: string
+    required: false
+    description: Pull request description
+  head:
+    type: string
+    required: true
+    description: Head branch name or user:ref
+  base:
+    type: string
+    required: true
+    description: Base branch name
+  draft:
+    type: boolean
+    required: false
+    description: Whether PR is a draft
+    default: false
+  maintainer_can_modify:
+    type: boolean
+    required: false
+    description: Allow maintainers to edit PR
+    default: true
+
+execution:
+  type: http
+  method: POST
+  url: 'https://api.github.com/repos/{owner}/{repo}/pulls'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    title: '{title}'
+    body: '{body}'
+    head: '{head}'
+    base: '{base}'
+    draft: '{draft}'
+    maintainer_can_modify: '{maintainer_can_modify}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Pull requests write
+
+output_schema:
+  type: object
+  properties:
+    id:
+      type: number
+    number:
+      type: number
+    title:
+      type: string
+    state:
+      type: string
+    html_url:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Create pull request
+    params:
+      owner: myorg
+      repo: myrepo
+      title: Add new feature
+      body: This PR adds support for...
+      head: feature/new-feature
+      base: main
+  - name: Create draft PR
+    params:
+      owner: myorg
+      repo: myrepo
+      title: WIP - Feature in progress
+      head: feature/experimental
+      base: main
+      draft: true