matimo-github 0.1.0__py3-none-any.whl

matimo_github/tools/search-code/definition.yaml

@@ -0,0 +1,75 @@
+name: github-search-code
+description: Search for code content across GitHub repositories
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Code search query with qualifiers (e.g., 'className:MyClass repo:owner/repo')
+  sort:
+    type: string
+    required: false
+    description: Sort field - indexed (default)
+    default: indexed
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/code'
+  query_params:
+    q: '{query}'
+    sort: '{sort}'
+    order: '{order}'
+    per_page: '{per_page}'
+    page: '{page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    rate_limit: 10 req/min authenticated (requires authentication)
+    note: Code search requires authentication and only searches default branch
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of code search result objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find function definitions
+    params:
+      query: 'function handleSubmit repo:facebook/react'
+  - name: Search for configuration files
+    params:
+      query: 'filename:tsconfig.json'

matimo_github/tools/search-issues/definition.yaml

@@ -0,0 +1,75 @@
+name: github-search-issues
+description: Search for issues and pull requests across GitHub
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query with qualifiers (e.g., 'is:open type:issue repo:owner/repo')
+  sort:
+    type: string
+    required: false
+    description: Sort field - comments, reactions, created, or updated
+    default: created
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/issues'
+  query_params:
+    q: '{query}'
+    sort: '{sort}'
+    order: '{order}'
+    per_page: '{per_page}'
+    page: '{page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    rate_limit: 30 req/min authenticated
+    scope: Searches both issues and pull requests
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of issue/PR objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find open issues with bug label
+    params:
+      query: 'is:open label:bug type:issue'
+  - name: Find pull requests awaiting review
+    params:
+      query: 'is:open type:pr review:pending'

matimo_github/tools/search-repositories/definition.yaml

@@ -0,0 +1,83 @@
+name: github-search-repositories
+description: Search for repositories on GitHub by name, description, topics, or stars
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query (e.g., 'language:javascript stars:>1000')
+  sort:
+    type: string
+    required: false
+    description: Sort field - stars, forks, help-wanted-issues, or updated
+    default: stars
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/repositories'
+  query_params:
+    q: '{query}'
+    sort: '{sort}'
+    order: '{order}'
+    per_page: '{per_page}'
+    page: '{page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  name: Authorization
+  notes:
+    env: GITHUB_TOKEN
+    types: OAuth2 token or Personal Access Token
+    rate_limit: 30 req/min authenticated
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+      description: Total number of matching repositories
+    incomplete_results:
+      type: boolean
+      description: Whether results were truncated
+    items:
+      type: array
+      description: Array of repository objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Search popular JavaScript repos
+    params:
+      query: 'language:javascript stars:>5000'
+      sort: stars
+  - name: Search recently updated Python projects
+    params:
+      query: 'language:python updated:>2024-01-01'
+      sort: updated
+      order: desc

matimo_github/tools/search-users/definition.yaml

@@ -0,0 +1,75 @@
+name: github-search-users
+description: Search for GitHub users by name, location, or follower count
+version: '1.0.0'
+
+parameters:
+  query:
+    type: string
+    required: true
+    description: Search query (e.g., 'location:San Francisco followers:>5000')
+  sort:
+    type: string
+    required: false
+    description: Sort field - followers, repositories, or joined
+    default: followers
+  order:
+    type: string
+    required: false
+    description: Sort order - asc or desc
+    default: desc
+  per_page:
+    type: number
+    required: false
+    description: Results per page (max 100)
+    default: 30
+  page:
+    type: number
+    required: false
+    description: Page number for pagination
+    default: 1
+
+execution:
+  type: http
+  method: GET
+  url: 'https://api.github.com/search/users'
+  query_params:
+    q: '{query}'
+    sort: '{sort}'
+    order: '{order}'
+    per_page: '{per_page}'
+    page: '{page}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+  timeout: 30000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    optional: Can be called without authentication (public users only)
+    rate_limit: 30 req/min authenticated
+
+output_schema:
+  type: object
+  properties:
+    total_count:
+      type: number
+    items:
+      type: array
+      description: Array of user objects
+
+error_handling:
+  retry: 2
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Find developers in San Francisco
+    params:
+      query: 'location:"San Francisco" followers:>100'
+  - name: Find contributors to TypeScript
+    params:
+      query: 'org:microsoft followers:>50'

matimo_github/tools/update-code-alert/definition.yaml

@@ -0,0 +1,86 @@
+name: github-update-code-alert
+description: Update the status of a code scanning security alert
+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
+  alert_number:
+    type: number
+    required: true
+    description: Alert number
+  state:
+    type: string
+    required: true
+    description: New state - open, dismissed, or fixed
+  dismissed_reason:
+    type: string
+    required: false
+    description: If dismissing, the reason - false positive, won't fix, used in tests, etc.
+  dismissed_comment:
+    type: string
+    required: false
+    description: Optional comment when dismissing
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.github.com/repos/{owner}/{repo}/code-scanning/alerts/{alert_number}'
+  headers:
+    Accept: application/vnd.github+json
+    Authorization: 'Bearer {GITHUB_TOKEN}'
+    X-GitHub-Api-Version: '2022-11-28'
+    Content-Type: application/json
+  body:
+    state: '{state}'
+    dismissed_reason: '{dismissed_reason}'
+    dismissed_comment: '{dismissed_comment}'
+  timeout: 15000
+
+authentication:
+  type: bearer
+  location: header
+  notes:
+    env: GITHUB_TOKEN
+    required: true
+    permission: Security events write
+    note: Requires GitHub Advanced Security enabled
+
+output_schema:
+  type: object
+  properties:
+    number:
+      type: number
+    state:
+      type: string
+    dismissed_at:
+      type: string
+    dismissed_reason:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Dismiss false positive
+    params:
+      owner: myorg
+      repo: myrepo
+      alert_number: 42
+      state: dismissed
+      dismissed_reason: false positive
+  - name: Reopen alert
+    params:
+      owner: myorg
+      repo: myrepo
+      alert_number: 42
+      state: open

matimo_github/tools/update-issue/definition.yaml

@@ -0,0 +1,98 @@
+name: github-update-issue
+description: Update an issue - title, body, state, assignees, labels
+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
+  issue_number:
+    type: number
+    required: true
+    description: Issue number
+  title:
+    type: string
+    required: false
+    description: New issue title
+  body:
+    type: string
+    required: false
+    description: New issue body
+  state:
+    type: string
+    required: false
+    description: New state - open or closed
+  assignees:
+    type: array
+    required: false
+    description: Array of usernames to assign
+  labels:
+    type: array
+    required: false
+    description: Array of label names
+
+execution:
+  type: http
+  method: PATCH
+  url: 'https://api.github.com/repos/{owner}/{repo}/issues/{issue_number}'
+  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}'
+    state: '{state}'
+    assignees: '{assignees}'
+    labels: '{labels}'
+  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
+    title:
+      type: string
+    state:
+      type: string
+    updated_at:
+      type: string
+
+error_handling:
+  retry: 1
+  backoff_type: exponential
+  initial_delay_ms: 1000
+
+examples:
+  - name: Close an issue
+    params:
+      owner: myorg
+      repo: myrepo
+      issue_number: 42
+      state: closed
+  - name: Update issue labels
+    params:
+      owner: myorg
+      repo: myrepo
+      issue_number: 42
+      labels:
+        - fixed
+        - closed

matimo_github-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,27 @@
+matimo_github/__init__.py,sha256=NrzTX-RBXrIXDBsj6d5jXi0MxZe1OqR5DTBDcMb36Fo,475
+matimo_github/tools/add-collaborator/definition.yaml,sha256=XD3U_lR1aMHaRiR8ni4EkZeEfe4td6B-89nnAiilwLI,1558
+matimo_github/tools/create-issue/definition.yaml,sha256=GmZGOxVJS8vx6IQlFFdtSu-cCfIoszp8VgA5xfkBwnY,1981
+matimo_github/tools/create-pull-request/definition.yaml,sha256=XBrmQXBdl_IiaMi-CpZdfJF_31kqCccYIIF2TCXzSOk,2125
+matimo_github/tools/create-release/definition.yaml,sha256=y1K0zNjXhpeIhEy_ArM2pHv1iMWEsEuvgZPCcN9He1s,2130
+matimo_github/tools/create-repository/definition.yaml,sha256=EZIJAos9auKIszhS1DlqSw-fX6C6b8OvL4d4WVS-Ji8,2478
+matimo_github/tools/delete-repository/definition.yaml,sha256=26ikpI3K7eL5xn4f8hvbuWxECAYomV4huMXVc8JoiYw,1100
+matimo_github/tools/get-issue/definition.yaml,sha256=uT4M416uMee1mDI1olxZNg43whu3UTJVxcXFrbpPWSg,1325
+matimo_github/tools/get-repository/definition.yaml,sha256=OuRB6BvnCACPdh35M3LUotrDD1_LWMG_ETGTEDkO7mo,1546
+matimo_github/tools/list-code-alerts/definition.yaml,sha256=h6XkpFtHl0qZdNEbFrEA3uUwEo4x_L8RW-6_5leSVng,1925
+matimo_github/tools/list-collaborators/definition.yaml,sha256=F9p4sNRHQsPpsG8lby7DuDRKvoF685D8JPoeOVJ1oXg,1686
+matimo_github/tools/list-commits/definition.yaml,sha256=zt8muBl4_n-ShyqhCd9o8PpCb_xweXJgzmKyYsY8ZDw,1711
+matimo_github/tools/list-issues/definition.yaml,sha256=5Hiw4eDrt8H-8DXNn73V2NZYJC5tK1vPaK84S82SdXM,2109
+matimo_github/tools/list-pull-requests/definition.yaml,sha256=Xp6YY731pymT8XJiiZRkKW_Fn-fojAbBfO0s_muLI3c,2031
+matimo_github/tools/list-releases/definition.yaml,sha256=HT7eVzTRdYs1vygs-ta0i79H4waBlvsrgUbaKkPNAp4,1326
+matimo_github/tools/list-repositories/definition.yaml,sha256=vqjr3LepkLHcOjsfFCec5ygV6E_hHEVNqdw_Mqwm1Po,1741
+matimo_github/tools/merge-pull-request/definition.yaml,sha256=rPkx1HJY2VuVczBPs1WAbfyqJxeckQSJbk-6OpxpSi8,1900
+matimo_github/tools/search-code/definition.yaml,sha256=vAgKCNgCsDEYzX9DTJUNocVFR_lmfLxNDgfif0uTgeY,1725
+matimo_github/tools/search-issues/definition.yaml,sha256=XIhzOTCgiDdpUxmq0ezQdDS3Lz3cxF0CgWjPuEuTHPs,1687
+matimo_github/tools/search-repositories/definition.yaml,sha256=Mi-eyLqO3nF0IPyDFOBcYad6GvYH_gT8NxkB2gn7x1E,1948
+matimo_github/tools/search-users/definition.yaml,sha256=-uhK2Bu_55nNp4rfFyFWPcJ6YOk1Dvdj1ZQ115LrsRQ,1703
+matimo_github/tools/update-code-alert/definition.yaml,sha256=XvkKZEPyl2g1IHeHR2WTnorpakxqHepp31Fu6r2QTvo,1951
+matimo_github/tools/update-issue/definition.yaml,sha256=6uztV19vNloUDPcJlhKv-3g9egcW73Re3d-3Xt68EmI,1947
+matimo_github-0.1.0.dist-info/METADATA,sha256=TQRP5B7XBO-x3Ll926evg-s47vBmrx6-X6YDGrbGBoE,4546
+matimo_github-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+matimo_github-0.1.0.dist-info/entry_points.txt,sha256=BU1c8DBdjs2sGs_FSjNuezbKLbNmLhaxlm_DuQdGdyI,57
+matimo_github-0.1.0.dist-info/RECORD,,

matimo_github-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

matimo_github-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[matimo.providers]
+github = matimo_github:get_tools_path