agentsquire 0.2.2__py3-none-any.whl

agentsquire-0.2.2.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: agentsquire
+Version: 0.2.2
+Summary: Let a Python package carry its own agent integrations and install them into whatever agent harness is present.
+Author: TacoTakumi
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,agent-skills,claude-code,cli,harness,skills
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: click
+Requires-Dist: pyyaml
+Description-Content-Type: text/markdown
+
+# AgentSquire
+
+A reusable Python library + CLI that lets a Python package carry its own agent
+integrations (Agent Skills) and install them into whatever agent harness is
+present - the executable is the framework.
+
+Your CLI ships its skills as package data inside its own wheel, adds
+`agentsquire` as a plain pip dependency, and mounts a ready-made subcommand
+group. Your users only ever see your tool:
+
+```
+$ awiki skills install
+installed awiki-search -> /home/you/.claude/skills/awiki-search
+```
+
+Supported harnesses at launch: Claude Code, pi, Hermes, and opencode. Detection
+is by marker directory; every operation is local (no network in any verb). Each
+harness's directories, scopes, and behaviour are recorded in
+[docs/harnesses.md](docs/harnesses.md).
+
+## Consumer integration guide
+
+### 1. Ship skills as package data
+
+Lay each skill out as a directory containing a `SKILL.md` (the agentskills.io
+format) under a `skills/` resource inside your importable package:
+
+```
+your_pkg/
+    __init__.py
+    skills/
+        my-skill/
+            SKILL.md
+            reference.md
+```
+
+The skills ride inside your wheel; make sure your build backend includes
+package data (hatchling includes it by default, setuptools needs
+`include-package-data`). No source checkout is needed at run time - skills are
+enumerated straight from the installed wheel.
+
+### 2. Mount the subcommand group
+
+One call returns a click group with `install`, `status`, `update`, and
+`uninstall` subcommands, parameterized by your package name, the resource path
+(default `"skills"`), and the default scope.
+
+For a click CLI:
+
+```python
+import click
+
+from agentsquire.cli import skills_command_group
+
+
+@click.group()
+def cli():
+    """Your CLI."""
+
+
+cli.add_command(skills_command_group("your_pkg", default_scope="user"))
+```
+
+For a typer CLI, mount onto the underlying click command:
+
+```python
+import typer
+import typer.main
+
+from agentsquire.cli import skills_command_group
+
+app = typer.Typer()
+
+
+@app.callback()
+def main():
+    """Your CLI."""
+
+
+cli = typer.main.get_command(app)
+cli.add_command(skills_command_group("your_pkg", default_scope="user"))
+```
+
+Your users now run `your-cli skills install` and friends. Every subcommand
+takes `--scope user|project` (overriding your declared default) and
+`--harness NAME` (default: all detected harnesses).
+
+Choosing the default scope: `user` installs into the harness's per-user
+skills directory and follows the user everywhere - right for general-purpose
+tools. `project` installs into the current project's directory - right for
+skills that only make sense inside a repository that uses your tool.
+
+### 3. Surface updates proactively (optional)
+
+Place the one-call staleness hook at your CLI entry point. When installed
+skills have updates available it prints a single advisory line on stderr,
+for example:
+
+    your-cli: a skills update is available for 1 skill (alpha); run `your-cli skills update`
+
+The hook is notice-only: it never prompts, never reads stdin, and never
+updates anything itself - the explicit `skills update` verb stays the sole
+updater. It writes nothing to stdout, never changes your exit code, and
+swallows its own errors, so it can never break the command it runs inside:
+
+```python
+from agentsquire import BundledPackageDataSource, check_stale
+
+
+def main():
+    check_stale(
+        BundledPackageDataSource("your_pkg"),
+        prog_name="your-cli",
+        update_command="your-cli skills update",
+    )
+    # ... the rest of your entry point
+```
+
+The notice shows unless a suppression gate holds: `CI` set to a non-empty
+value, or `AGENTSQUIRE_NO_UPDATE_CHECK` set to a non-empty value. It is not
+gated on an interactive terminal - it fires on non-TTY stderr too, so an
+agent harness that runs your CLI with captured stderr still sees that an
+update is available. Suppression is presence-disables, the `NO_COLOR`
+convention: any non-empty value disables the notice (`CI=false` and
+`AGENTSQUIRE_NO_UPDATE_CHECK=0` both suppress), while an empty string is
+treated as unset.
+
+### 4. Mark your package as skill-carrying (optional)
+
+One pyproject line registers your package under the `agentsquire.skills`
+entry-point group. Nothing reads it today - it is reserved for a future
+environment-wide listing of skill-carrying packages and changes no behaviour:
+
+```toml
+[project.entry-points."agentsquire.skills"]
+your_pkg = "your_pkg"
+```
+
+## The provenance and update model
+
+Installs are plain copies - no symlinks, no lockfile, no references back into
+site-packages - so an installed skill survives upgrade or removal of your
+package. Each installed `SKILL.md` carries a provenance stamp in its
+frontmatter `metadata.agentsquire` map: `installer`, `installer_version`,
+`source_package`, `source_version`, and `content_hash`. The skill body is
+byte-identical to what you shipped.
+
+`status` classifies every skill by local hash compares only (no network,
+ever): not-installed, up-to-date, update-available (your shipped copy moved
+on), or locally-modified (the user edited the install, the directory carries
+no stamp, or a symlink sits at the target - none of them ours to touch).
+`update` refreshes update-available skills and skips locally modified ones
+unless `--force` is given; `uninstall` removes only directories whose stamp
+names your package. User content is never silently overwritten or deleted -
+a pre-existing symlink at a target (a common hand-wired setup) is reported
+and skipped, never followed or clobbered.
+
+## Python API
+
+Everything the CLI group does is available as plain Python - enumerate,
+detect, install, status, update, uninstall, and the staleness check - with no
+CLI involved. See [docs/api.md](docs/api.md) for the reference.
+
+## License
+
+MIT.

agentsquire-0.2.2.dist-info/RECORD

@@ -0,0 +1,15 @@
+agentsquire/__init__.py,sha256=s6Y6f2DchgNp8riZ1Dr4sDFJYht6qWQOG_th7CrSyZ4,2188
+agentsquire/cli.py,sha256=y-FJBfssy-uOBPjVgkNE-cqPoWmmKr5dtiLwUc8hEas,8017
+agentsquire/harnesses.py,sha256=-6XsC1P9MueT_lqtJIYapvIElTEPyimNJQwHDY300YI,4574
+agentsquire/hashing.py,sha256=APvh1LhZd2CSlVD3OdE9y9EeX9LYrJ0gqYpAHFbJwOk,2104
+agentsquire/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentsquire/roots.py,sha256=-njiahU1UCdXdMTGaoAiXjpPLjAoeGOtimBi00jSkvE,1793
+agentsquire/skills.py,sha256=VZHkpFeccLOFuikl5FGm4hk3I7zO-2hr0lydyp3-ILs,2922
+agentsquire/sources.py,sha256=5bvDDMmV1DpihyNSkfcBBZeOVjhMHCtwsEAc8YgewSg,3981
+agentsquire/staleness.py,sha256=_szRvaEPxbjFfCYXzZyeaAHe4oUd8F8cFUKUYNDmSu8,2834
+agentsquire/stamping.py,sha256=11-zQ2z3kwCgCfqSGpX5LbodSqoQ3zBeoNKCWfK322c,2770
+agentsquire/verbs.py,sha256=vtuQWtMxGPUnponseGaKUY446BBn1lH10MeRR3n55yQ,11624
+agentsquire-0.2.2.dist-info/METADATA,sha256=ZoRBVKxh6saOWq7BKeioBkfyRrqP4zNzE11PSkIRn9w,6645
+agentsquire-0.2.2.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+agentsquire-0.2.2.dist-info/licenses/LICENSE,sha256=72RvUJ6QewdDdqZvEH1O8r01ACLQjYgU1B_ejnR5vH8,1067
+agentsquire-0.2.2.dist-info/RECORD,,

agentsquire-0.2.2.dist-info/WHEEL

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

agentsquire-0.2.2.dist-info/licenses/LICENSE

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