Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@ name: Issue templates
blank_issues_enabled: false
contact_links:
- name: Architecture overview
url: https://github.com/askmy-stack/Tool-Semantics/blob/main/docs/architecture.md
url: https://github.com/askmy-stack/tool-semantics/blob/main/docs/architecture.md
about: Read how snapshots, diffs, and reports fit together before proposing large changes.
- name: Roadmap
url: https://github.com/askmy-stack/Tool-Semantics/blob/main/ROADMAP.md
url: https://github.com/askmy-stack/tool-semantics/blob/main/ROADMAP.md
about: Check planned milestones to avoid duplicate proposals.
20 changes: 20 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
version: 2
updates:
- package-ecosystem: github-actions
directory: /
schedule:
interval: weekly
groups:
github-actions:
patterns:
- "*"

- package-ecosystem: pip
directory: /
schedule:
interval: weekly
groups:
python-minor-patch:
update-types:
- minor
- patch
4 changes: 4 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,10 @@ mypy src
pytest --cov=tool_semantics
```

## Dependency updates

Dependabot opens weekly PRs for GitHub Actions and Python dependencies. These updates are welcome — review CI results and merge when green.

## Typing

The package ships a `py.typed` marker. Keep public APIs fully typed; `mypy` runs in strict mode on `src/`.
Expand Down
17 changes: 12 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@
</p>

<p align="center">
<a href="https://github.com/askmy-stack/Tool-Semantics/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/askmy-stack/Tool-Semantics/actions/workflows/ci.yml/badge.svg" /></a>
<a href="https://github.com/askmy-stack/tool-semantics/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/askmy-stack/tool-semantics/actions/workflows/ci.yml/badge.svg" /></a>
<a href="https://www.python.org/downloads/"><img alt="Python 3.11+" src="https://img.shields.io/badge/python-3.11%2B-0d9488?logo=python&logoColor=white" /></a>
<a href="LICENSE"><img alt="License Apache-2.0" src="https://img.shields.io/badge/license-Apache%202.0-1f2933" /></a>
<a href="https://github.com/askmy-stack/Tool-Semantics/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22"><img alt="Good first issues" src="https://img.shields.io/badge/good%20first%20issues-open-f59e0b" /></a>
<a href="https://github.com/askmy-stack/tool-semantics/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22"><img alt="Good first issues" src="https://img.shields.io/badge/good%20first%20issues-open-f59e0b" /></a>
</p>

---
Expand Down Expand Up @@ -171,8 +171,15 @@ from tool_semantics.probes import Probe, ProbeKind, evaluate_probes
snapshot = capture_manifest(Path("examples/github_server_v1.json"))
report = evaluate_probes(
snapshot,
[Probe(id="search", intent="find issues", expected_tool="search_issues",
required_params=["query"], kind=ProbeKind.POSITIVE)],
[
Probe(
id="search",
intent="find issues",
expected_tool="search_issues",
required_params=["query"],
kind=ProbeKind.POSITIVE,
)
],
)
assert report.passed
```
Expand All @@ -196,7 +203,7 @@ We welcome issues and PRs — especially documentation fixes, tests, and compati

- Read [CONTRIBUTING.md](CONTRIBUTING.md)
- Follow the [Code of Conduct](CODE_OF_CONDUCT.md)
- Browse [good first issues](https://github.com/askmy-stack/Tool-Semantics/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
- Browse [good first issues](https://github.com/askmy-stack/tool-semantics/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)

## Security

Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@ Treat MCP metadata, tool descriptions, outputs, and generated probes as **untrus

Tool-Semantics must not automatically execute discovered tools in the MVP.

Please report security issues privately via [GitHub Security Advisories](https://github.com/askmy-stack/Tool-Semantics/security/advisories/new). Do not open a public issue for vulnerabilities that could enable remote code execution, secret leakage, or unsafe tool invocation.
Please report security issues privately via [GitHub Security Advisories](https://github.com/askmy-stack/tool-semantics/security/advisories/new). Do not open a public issue for vulnerabilities that could enable remote code execution, secret leakage, or unsafe tool invocation.

We aim to acknowledge reports within 7 days.
8 changes: 4 additions & 4 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,10 @@ dependencies = [
]

[project.urls]
Homepage = "https://github.com/askmy-stack/Tool-Semantics"
Repository = "https://github.com/askmy-stack/Tool-Semantics"
Issues = "https://github.com/askmy-stack/Tool-Semantics/issues"
Changelog = "https://github.com/askmy-stack/Tool-Semantics/blob/main/CHANGELOG.md"
Homepage = "https://github.com/askmy-stack/tool-semantics"
Repository = "https://github.com/askmy-stack/tool-semantics"
Issues = "https://github.com/askmy-stack/tool-semantics/issues"
Changelog = "https://github.com/askmy-stack/tool-semantics/blob/main/CHANGELOG.md"

[project.optional-dependencies]
dev = [
Expand Down
Loading