irene-tools 0.1.0__tar.gz

irene_tools-0.1.0/LICENSE

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

irene_tools-0.1.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: irene-tools
+Version: 0.1.0
+Summary: Portable, zero-dependency @tool decorator for authoring agent toolkits — runs in Irene, standalone, or under agno.
+Author: Irene
+License: MIT
+Keywords: agent,llm,tools,toolkit
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# irene-tools
+
+A tiny, **zero-dependency** `@tool` decorator for authoring agent toolkits. A toolkit
+authored with `irene-tools` is **portable**: it runs inside Irene, runs standalone
+(`python toolkit.py`), and is usable by [agno](https://github.com/agno-agi/agno) and other
+frameworks — because it depends on nothing.
+
+```python
+from irene_tools import tool
+
+@tool(category="weather")
+def get_forecast(city: str) -> str:
+    """Get the forecast for a city."""
+    return f"Sunny in {city}"
+```
+
+## Why
+
+A capability you build should be yours to keep and move. `irene-tools` is the opposite of
+lock-in: the decorator only stamps metadata and returns your function unchanged, so the same
+`toolkit.py` works everywhere. No SDK to install a runtime, no framework coupling.
+
+## The toolkit convention
+
+```
+my_toolkit/
+  toolkit.py       # @tool-decorated functions
+  manifest.json    # derived: {name, description, tools[...], manifest_version}
+```
+
+## API
+
+- `@tool(category="custom", tags=[], description=None, dangerous=False)` — mark a function.
+- `get_workspace()` — the dir to read/write files in (host-injected; `cwd` standalone).
+- `get_secret(key, default=None)` — the current end-user's per-user secret (host-injected).
+
+MIT licensed.

irene_tools-0.1.0/README.md

@@ -0,0 +1,37 @@
+# irene-tools
+
+A tiny, **zero-dependency** `@tool` decorator for authoring agent toolkits. A toolkit
+authored with `irene-tools` is **portable**: it runs inside Irene, runs standalone
+(`python toolkit.py`), and is usable by [agno](https://github.com/agno-agi/agno) and other
+frameworks — because it depends on nothing.
+
+```python
+from irene_tools import tool
+
+@tool(category="weather")
+def get_forecast(city: str) -> str:
+    """Get the forecast for a city."""
+    return f"Sunny in {city}"
+```
+
+## Why
+
+A capability you build should be yours to keep and move. `irene-tools` is the opposite of
+lock-in: the decorator only stamps metadata and returns your function unchanged, so the same
+`toolkit.py` works everywhere. No SDK to install a runtime, no framework coupling.
+
+## The toolkit convention
+
+```
+my_toolkit/
+  toolkit.py       # @tool-decorated functions
+  manifest.json    # derived: {name, description, tools[...], manifest_version}
+```
+
+## API
+
+- `@tool(category="custom", tags=[], description=None, dangerous=False)` — mark a function.
+- `get_workspace()` — the dir to read/write files in (host-injected; `cwd` standalone).
+- `get_secret(key, default=None)` — the current end-user's per-user secret (host-injected).
+
+MIT licensed.

irene_tools-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "irene-tools"
+version = "0.1.0"
+description = "Portable, zero-dependency @tool decorator for authoring agent toolkits — runs in Irene, standalone, or under agno."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Irene" }]
+keywords = ["agent", "llm", "tools", "toolkit"]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Intended Audience :: Developers",
+]
+dependencies = []
+
+[tool.setuptools.packages.find]
+where = ["src"]

irene_tools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

irene_tools-0.1.0/src/irene_tools/__init__.py

@@ -0,0 +1,19 @@
+"""irene-tools — portable, zero-dependency `@tool` decorator for agent toolkits.
+
+    from irene_tools import tool
+
+    @tool(category="weather")
+    def get_forecast(city: str) -> str:
+        '''Get the forecast for a city.'''
+        ...
+
+A toolkit is a folder: `toolkit.py` (@tool-decorated functions) + a derived
+`manifest.json`. Runs in Irene, standalone, or under agno — because it depends on
+nothing.
+"""
+from irene_tools.decorator import get_secret, get_workspace, tool
+
+__version__ = "0.1.0"
+MANIFEST_VERSION = 1
+
+__all__ = ["tool", "get_workspace", "get_secret", "__version__", "MANIFEST_VERSION"]

irene_tools-0.1.0/src/irene_tools/decorator.py

@@ -0,0 +1,62 @@
+"""irene_tools.decorator — the portable @tool marker.
+
+Zero dependencies. A toolkit is a folder with a `toolkit.py` whose functions are
+marked with `@tool`; a host (Irene, or any framework) discovers them and exposes
+them to a model. The decorator only STAMPS metadata and returns the function
+UNCHANGED, so the same function is:
+  - callable directly (`get_forecast("NYC")`),
+  - importable + runnable standalone (`python toolkit.py`),
+  - usable by agno (which accepts a plain callable via `Function.from_callable`).
+
+Portability comes from NOT depending on any framework — this is the whole point.
+"""
+from __future__ import annotations
+
+import os
+from typing import Callable, List, Optional
+
+
+def tool(func: Optional[Callable] = None, *, category: str = "custom",
+         tags: Optional[List[str]] = None, dangerous: bool = False,
+         runtime: str = "python", description: Optional[str] = None,
+         **_extra) -> Callable:
+    """Mark a function as an agent-callable tool.
+
+    Works bare (`@tool`), called (`@tool()`), parametrized (`@tool(category="x")`),
+    and legacy-positional (`@tool("x")`). FORGIVING: `description=` is a first-class
+    kwarg (the model's most natural form) and any other kwarg is swallowed by
+    `**_extra`, so importing a toolkit never TypeErrors. Returns the function
+    unchanged plus a `_irene_tool` metadata attribute (read at authoring/inspection
+    time; Irene's loader discovers tools by AST, not this attribute).
+    """
+    if isinstance(func, str):            # legacy positional: @tool("category")
+        category, func = func, None
+
+    def decorator(f: Callable) -> Callable:
+        f._irene_tool = {
+            "category": category,
+            "tags": list(tags or []),
+            "dangerous": bool(dangerous),
+            "runtime": runtime,
+            "description": description,
+        }
+        return f
+    return decorator(func) if callable(func) else decorator
+
+
+def get_workspace() -> str:
+    """The directory a tool should read/write files in. Standalone this is just
+    `os.getcwd()`; a host runtime (Irene) sets cwd to the session workspace before
+    invoking the tool."""
+    return os.getcwd()
+
+
+def get_secret(key: str, default=None):
+    """The CURRENT end-user's per-user secret for this tool on a multi-user deployed
+    agent. Returns `default` standalone / single-tenant (e.g. a bare `python
+    toolkit.py`); the host runtime injects real values in the sandbox. Never read
+    `os.environ` for per-user values (that's the OWNER's shared secret)."""
+    return default
+
+
+__all__ = ["tool", "get_workspace", "get_secret"]

irene_tools-0.1.0/src/irene_tools.egg-info/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: irene-tools
+Version: 0.1.0
+Summary: Portable, zero-dependency @tool decorator for authoring agent toolkits — runs in Irene, standalone, or under agno.
+Author: Irene
+License: MIT
+Keywords: agent,llm,tools,toolkit
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# irene-tools
+
+A tiny, **zero-dependency** `@tool` decorator for authoring agent toolkits. A toolkit
+authored with `irene-tools` is **portable**: it runs inside Irene, runs standalone
+(`python toolkit.py`), and is usable by [agno](https://github.com/agno-agi/agno) and other
+frameworks — because it depends on nothing.
+
+```python
+from irene_tools import tool
+
+@tool(category="weather")
+def get_forecast(city: str) -> str:
+    """Get the forecast for a city."""
+    return f"Sunny in {city}"
+```
+
+## Why
+
+A capability you build should be yours to keep and move. `irene-tools` is the opposite of
+lock-in: the decorator only stamps metadata and returns your function unchanged, so the same
+`toolkit.py` works everywhere. No SDK to install a runtime, no framework coupling.
+
+## The toolkit convention
+
+```
+my_toolkit/
+  toolkit.py       # @tool-decorated functions
+  manifest.json    # derived: {name, description, tools[...], manifest_version}
+```
+
+## API
+
+- `@tool(category="custom", tags=[], description=None, dangerous=False)` — mark a function.
+- `get_workspace()` — the dir to read/write files in (host-injected; `cwd` standalone).
+- `get_secret(key, default=None)` — the current end-user's per-user secret (host-injected).
+
+MIT licensed.

irene_tools-0.1.0/src/irene_tools.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+src/irene_tools/__init__.py
+src/irene_tools/decorator.py
+src/irene_tools.egg-info/PKG-INFO
+src/irene_tools.egg-info/SOURCES.txt
+src/irene_tools.egg-info/dependency_links.txt
+src/irene_tools.egg-info/top_level.txt

irene_tools-0.1.0/src/irene_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

irene_tools-0.1.0/src/irene_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+irene_tools