soliplex-concierge 0.1__py3-none-any.whl

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

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

@@ -0,0 +1,7 @@
+soliplex_concierge/config.py,sha256=CLeZVmGFl8B59A3B5MDfJV-ioDrl7dzRKk9IGEZRgsc,962
+soliplex_concierge/tools/gitea.py,sha256=6UvYgxlV3ZtKtbYUUxsYUiO5OFtAvlNDo2FfHxx0F70,1018
+soliplex_concierge-0.1.dist-info/licenses/LICENSE,sha256=pQGCrNy-iPha4jIhHdzhY0iJO23LUUymDinb1YxlX-I,1065
+soliplex_concierge-0.1.dist-info/METADATA,sha256=8ucfgZJYHfvpO5Ya04-SiNeCMiX4ZkMC2SU7YQaM_C8,2409
+soliplex_concierge-0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+soliplex_concierge-0.1.dist-info/top_level.txt,sha256=FIqJEctICTfZA0D2Cm32BaYpCFzF1iUJymbVQCsszAg,19
+soliplex_concierge-0.1.dist-info/RECORD,,

soliplex_concierge-0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

soliplex_concierge-0.1.dist-info/licenses/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.dist-info/top_level.txt

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