soliplex-concierge 0.1__tar.gz

soliplex_concierge-0.1/LICENSE

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

soliplex_concierge-0.1/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: soliplex-concierge
+Version: 0.1
+Summary: Soliplex extension for LLM-driven room access / creation requests.
+Author-email: Enfold <info@enfoldsystems.net>
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: soliplex
+Requires-Dist: pydantic
+Requires-Dist: pydantic-ai-slim<2.0,>=1.100
+Dynamic: license-file
+
+# `soliplex-concierge`: room access / creation support
+
+This project provides a [Soliplex](https://github.com/soliplex/soliplex)
+extension to support LLM-driven, on-demand creation of issues tracking
+requested changes to a Soliplex installation's configuration:
+
+- Access to a non-public room
+- Creation of a new room
+
+Components:
+
+- The [Python library](src/soliplex_concierge) contains code to support
+  both the issue creation tasks and the scripts which actually perform
+  the requested updates.
+
+- The [agent skill](skill/) contains a
+  [skill definition](https://agentskills.io) which allows an agent to
+  perform these tasks.
+
+## Install & wire up
+
+1. Install this package into the environment that runs Soliplex (it depends
+   on `soliplex`):
+
+   ```sh
+   pip install -e .
+   ```
+
+2. Merge the entries from
+   [`example/installation-snippet.yaml`](example/installation-snippet.yaml)
+   into your `installation.yaml`. They:
+
+   - register the tool-config class via `meta.tool_configs` (Soliplex
+     resolves the tool by its dotted `tool_name`; no core edit is needed),
+   - add this package's `skill/` directory to `filesystem_skills_paths` and
+     enable the `soliplex-concierge` filesystem skill, and
+   - declare the `GITEA_HOST` environment variable and `GITEA_ACCESS_TOKEN`
+     secret used by the room's `gitea` MCP toolset.
+
+3. Copy [`example/rooms/about_soliplex/`](example/rooms/about_soliplex) into
+   your installation's `rooms/` directory, editing the `owner` / `repo` on
+   the `get_gitea_issue_target` tool to point at your tracking repository.
+
+4. Set `GITEA_HOST` and `GITEA_ACCESS_TOKEN` (see the `.env` lines at the
+   bottom of the installation snippet).
+
+## Status
+
+The issue-filing concierge (the `about_soliplex` room, its `gitea` tool, and
+the agent skill) is implemented. The scripts that *act on* approved requests
+— actually creating rooms and granting room access — are a planned
+follow-up.

soliplex_concierge-0.1/README.md

@@ -0,0 +1,52 @@
+# `soliplex-concierge`: room access / creation support
+
+This project provides a [Soliplex](https://github.com/soliplex/soliplex)
+extension to support LLM-driven, on-demand creation of issues tracking
+requested changes to a Soliplex installation's configuration:
+
+- Access to a non-public room
+- Creation of a new room
+
+Components:
+
+- The [Python library](src/soliplex_concierge) contains code to support
+  both the issue creation tasks and the scripts which actually perform
+  the requested updates.
+
+- The [agent skill](skill/) contains a
+  [skill definition](https://agentskills.io) which allows an agent to
+  perform these tasks.
+
+## Install & wire up
+
+1. Install this package into the environment that runs Soliplex (it depends
+   on `soliplex`):
+
+   ```sh
+   pip install -e .
+   ```
+
+2. Merge the entries from
+   [`example/installation-snippet.yaml`](example/installation-snippet.yaml)
+   into your `installation.yaml`. They:
+
+   - register the tool-config class via `meta.tool_configs` (Soliplex
+     resolves the tool by its dotted `tool_name`; no core edit is needed),
+   - add this package's `skill/` directory to `filesystem_skills_paths` and
+     enable the `soliplex-concierge` filesystem skill, and
+   - declare the `GITEA_HOST` environment variable and `GITEA_ACCESS_TOKEN`
+     secret used by the room's `gitea` MCP toolset.
+
+3. Copy [`example/rooms/about_soliplex/`](example/rooms/about_soliplex) into
+   your installation's `rooms/` directory, editing the `owner` / `repo` on
+   the `get_gitea_issue_target` tool to point at your tracking repository.
+
+4. Set `GITEA_HOST` and `GITEA_ACCESS_TOKEN` (see the `.env` lines at the
+   bottom of the installation snippet).
+
+## Status
+
+The issue-filing concierge (the `about_soliplex` room, its `gitea` tool, and
+the agent skill) is implemented. The scripts that *act on* approved requests
+— actually creating rooms and granting room access — are a planned
+follow-up.

soliplex_concierge-0.1/pyproject.toml

@@ -0,0 +1,92 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "soliplex-concierge"
+version = "0.1"
+description = "Soliplex extension for LLM-driven room access / creation requests."
+authors = [{ name = "Enfold", email = "info@enfoldsystems.net" }]
+readme = "README.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "soliplex",
+    "pydantic",
+    "pydantic-ai-slim >= 1.100, < 2.0",
+]
+
+[dependency-groups]
+dev = [
+    "anyio >= 4.12.1, < 4.13",
+    "coverage >= 7.13.5, < 7.14",
+    "pytest >= 9.0.2, < 9.1",
+    "pytest-cov >= 7.0.0, < 7.1",
+    "pytest-asyncio >= 1.3.0, < 1.4",
+    "pytest-xdist >= 3.8.0, < 3.9",
+    "ruff >= 0.15.6, < 0.16",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+namespaces = true  # PEP 420: discover packages without empty __init__.py
+
+[tool.pytest.ini_options]
+pythonpath = [".", "tests/unit"]
+python_files = "test_*.py"
+testpaths = ["tests/unit"]
+addopts = "--cov=soliplex_concierge --cov=tests/unit --cov-branch --cov-fail-under=100"
+filterwarnings = [
+]
+markers = [
+]
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.ruff]
+line-length = 79
+exclude = [
+]
+target-version = "py313"
+
+[tool.ruff.lint]
+select = [
+    # flake8
+    "F",
+    # pycodestyle
+    "E",
+    # flake8-bugbear
+    "B",
+    # pyupgrade
+    "U",
+    # isort
+    "I",
+    # pandas vet
+    "PD",
+    # tryceratops
+    "TRY",
+    # flake8-pytest-style
+    "PT",
+]
+ignore = [
+    "PT019",  # incorrecly flags '@mock.patch' args as fixtures
+]
+
+[tool.ruff.lint.isort]
+force-single-line = true
+
+[tool.ruff.lint.flake8-pytest-style]
+parametrize-names-type = "csv"
+
+[tool.pymarkdown]
+extensions.front-matter.enabled = true
+plugins.line-length.enabled = false             # md013
+plugins.no-duplicate-heading.enabled = false    # md024
+plugins.no-inline-html.enabled = false          # md033
+plugins.no-emphasis-as-heading.enabled = false  # md036
+plugins.first-line-heading.enabled = false      # md041
+plugins.code-block-style.enabled = false        # md046

soliplex_concierge-0.1/setup.cfg

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

soliplex_concierge-0.1/src/soliplex_concierge/config.py

@@ -0,0 +1,34 @@
+"""Tool configuration types for the 'soliplex-concierge' extension.
+
+Register 'GiteaIssueTargetToolConfig' with a Soliplex installation by listing
+it under the installation's 'meta.tool_configs', e.g.::
+
+    meta:
+      tool_configs:
+        - "soliplex_concierge.config.GiteaIssueTargetToolConfig"
+
+Soliplex then maps the 'tool_name' in a room's 'tools:' entry to this class.
+"""
+
+import dataclasses
+
+from soliplex.config import tools as config_tools
+
+GITC_TOOL_NAME = "soliplex_concierge.tools.gitea.get_gitea_issue_target"
+_, GITC_TOOL_KIND = GITC_TOOL_NAME.rsplit(".", 1)
+
+
+@dataclasses.dataclass(kw_only=True)
+class GiteaIssueTargetToolConfig(config_tools.ToolConfig):
+    kind: str = GITC_TOOL_KIND
+    tool_name: str = GITC_TOOL_NAME
+
+    owner: str
+    repo: str
+
+    def get_extra_parameters(self) -> dict:
+        local = {
+            "owner": self.owner,
+            "repo": self.repo,
+        }
+        return super().get_extra_parameters() | local

soliplex_concierge-0.1/src/soliplex_concierge/tools/gitea.py

@@ -0,0 +1,34 @@
+"""Tools supporting the Gitea integration used by the 'about_soliplex' room."""
+
+import pydantic
+import pydantic_ai
+from soliplex import agents
+
+from soliplex_concierge import config
+
+
+class GiteaIssueTarget(pydantic.BaseModel):
+    """The Gitea repository where room requests should be filed."""
+
+    owner: str
+    repo: str
+
+
+async def get_gitea_issue_target(
+    ctx: pydantic_ai.RunContext[agents.AgentDependencies],
+) -> GiteaIssueTarget:
+    """Return the Gitea repository configured for filing room requests.
+
+    Call this before creating a Gitea issue, then pass the returned 'owner'
+    and 'repo' values verbatim as the new issue's 'owner' and 'repo'
+    arguments. Never guess or invent repository coordinates.
+
+    Returns:
+        GiteaIssueTarget: the 'owner' and 'repo' of this room's configured
+        issue-tracking repository.
+    """
+    tool_config = ctx.deps.tool_configs[config.GITC_TOOL_KIND]
+    return GiteaIssueTarget(
+        owner=tool_config.owner,
+        repo=tool_config.repo,
+    )

soliplex_concierge-0.1/src/soliplex_concierge.egg-info/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: soliplex-concierge
+Version: 0.1
+Summary: Soliplex extension for LLM-driven room access / creation requests.
+Author-email: Enfold <info@enfoldsystems.net>
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: soliplex
+Requires-Dist: pydantic
+Requires-Dist: pydantic-ai-slim<2.0,>=1.100
+Dynamic: license-file
+
+# `soliplex-concierge`: room access / creation support
+
+This project provides a [Soliplex](https://github.com/soliplex/soliplex)
+extension to support LLM-driven, on-demand creation of issues tracking
+requested changes to a Soliplex installation's configuration:
+
+- Access to a non-public room
+- Creation of a new room
+
+Components:
+
+- The [Python library](src/soliplex_concierge) contains code to support
+  both the issue creation tasks and the scripts which actually perform
+  the requested updates.
+
+- The [agent skill](skill/) contains a
+  [skill definition](https://agentskills.io) which allows an agent to
+  perform these tasks.
+
+## Install & wire up
+
+1. Install this package into the environment that runs Soliplex (it depends
+   on `soliplex`):
+
+   ```sh
+   pip install -e .
+   ```
+
+2. Merge the entries from
+   [`example/installation-snippet.yaml`](example/installation-snippet.yaml)
+   into your `installation.yaml`. They:
+
+   - register the tool-config class via `meta.tool_configs` (Soliplex
+     resolves the tool by its dotted `tool_name`; no core edit is needed),
+   - add this package's `skill/` directory to `filesystem_skills_paths` and
+     enable the `soliplex-concierge` filesystem skill, and
+   - declare the `GITEA_HOST` environment variable and `GITEA_ACCESS_TOKEN`
+     secret used by the room's `gitea` MCP toolset.
+
+3. Copy [`example/rooms/about_soliplex/`](example/rooms/about_soliplex) into
+   your installation's `rooms/` directory, editing the `owner` / `repo` on
+   the `get_gitea_issue_target` tool to point at your tracking repository.
+
+4. Set `GITEA_HOST` and `GITEA_ACCESS_TOKEN` (see the `.env` lines at the
+   bottom of the installation snippet).
+
+## Status
+
+The issue-filing concierge (the `about_soliplex` room, its `gitea` tool, and
+the agent skill) is implemented. The scripts that *act on* approved requests
+— actually creating rooms and granting room access — are a planned
+follow-up.

soliplex_concierge-0.1/src/soliplex_concierge.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/soliplex_concierge/config.py
+src/soliplex_concierge.egg-info/PKG-INFO
+src/soliplex_concierge.egg-info/SOURCES.txt
+src/soliplex_concierge.egg-info/dependency_links.txt
+src/soliplex_concierge.egg-info/requires.txt
+src/soliplex_concierge.egg-info/top_level.txt
+src/soliplex_concierge/tools/gitea.py

soliplex_concierge-0.1/src/soliplex_concierge.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

soliplex_concierge-0.1/src/soliplex_concierge.egg-info/requires.txt

@@ -0,0 +1,3 @@
+soliplex
+pydantic
+pydantic-ai-slim<2.0,>=1.100

soliplex_concierge-0.1/src/soliplex_concierge.egg-info/top_level.txt

@@ -0,0 +1 @@
+soliplex_concierge