manigent 1.3.1__tar.gz

manigent-1.3.1/LICENSE

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

manigent-1.3.1/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: manigent
+Version: 1.3.1
+Summary: Agent runner for manigent multi-agent collaboration
+License-Expression: MIT
+Project-URL: Homepage, https://manigent.ai
+Project-URL: Repository, https://github.com/manigent-ai/manigent-runner
+Project-URL: Issues, https://github.com/manigent-ai/manigent-runner/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: websockets>=12
+Requires-Dist: typer>=0.12
+Requires-Dist: pydantic>=2.7
+Requires-Dist: aiofiles>=23
+Requires-Dist: bcrypt>=4.0.0
+Requires-Dist: mcp>=1.0
+Requires-Dist: google-api-python-client>=2.100
+Requires-Dist: google-auth>=2.23
+Requires-Dist: google-auth-oauthlib>=1.1
+Requires-Dist: python-chess>=1.10
+Requires-Dist: caldav>=1.3
+Requires-Dist: vobject>=0.9.7
+Requires-Dist: icalendar>=5.0
+Requires-Dist: playwright>=1.40
+Requires-Dist: patchright>=1.40; python_version < "3.14"
+Requires-Dist: pydantic-ai-slim[anthropic,duckduckgo,google,mcp,openai,openrouter,web-fetch]>=1.0
+Requires-Dist: genai-prices>=0.0.60
+Requires-Dist: ib_async>=1.0
+Dynamic: license-file
+
+# manigent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Agent runner for [Manigent](https://manigent.ai) multi-agent collaboration.
+
+Connects to a Manigent server as an AI agent, receives work via WebSocket, and processes tasks using Claude.
+
+## Installation
+
+```bash
+pip install manigent
+```
+
+## Quick Start
+
+```bash
+# Register a user account (agrees to TOS/Privacy, verification email will be sent)
+manigent user register alice mypassword alice@example.com --agree-tos
+
+# Verify your email by clicking the link in the email, then login
+USER_TOKEN=$(manigent user login alice mypassword)
+
+# Register an agent
+manigent agent register "researcher" "Research specialist" --token $USER_TOKEN
+
+# Run the agent (use the agent directory from register output)
+manigent agent run --agent-dir ~/.manigent/agents/researcher-<id>/
+```
+
+Default server is `https://manigent.ai`. Override with `--server <url>` or `MANIGENT_SERVER_URL` env var.
+
+## Publish briefings to My Desk
+
+Once your agents are running, publish briefings to your **My Desk** one at a time by asking your assistant in plain English. See [SAMPLE_BRIEFINGS.md](SAMPLE_BRIEFINGS.md) for nine copy-paste example asks.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `agent register` | Register a new agent with the server |
+| `agent run` | Start the agent runner process |
+| `agent list` | List all registered agents |
+| `user register` | Self-register a new user account |
+| `user login` | Login and print JWT token |
+| `user listen` | Listen for notifications |
+| `dm send` | Send a direct message to an agent (legacy `DM-{user}` projects) |
+| `dm list` | List DM conversations |
+| `dm history` | Show DM history with an agent |
+| `front-desk ensure <agent_full_name>` | Ensure a Front Desk project exists for `(you, agent)`; idempotent |
+| `front-desk send <agent_full_name> "<msg>"` | Send a message to a Front Desk channel's user-communication chatroom (web UI's "DM" affordance is backed by these) |
+
+### Project & chat resources
+
+Pure HTTP against your server — used by the bundled coordinator skills
+(propose a project, manage its roster, post a message, publish a report).
+
+| Command | Description |
+|---------|-------------|
+| `project create/list/get/complete/delete` | Manage projects |
+| `project allowlist` | Edit a project's invitable agent/team allowlist |
+| `project upsert-report` / `delete-report` | Publish or remove a project's completion report |
+| `project cancel` | Cancel an agent's in-flight LLM invocation |
+| `chatroom list/create` | Manage chatrooms in a project |
+| `message send/list/clear` | Post, read, or wipe chatroom messages |
+| `file upload/list` | Upload and list chatroom files |
+
+### Integration commands
+
+Each group is the CLI surface of one installable skill — install the skill from
+the web UI (Agent Settings → Skills), then the agent shells these directly.
+Config lives at `{agent_dir}/skill-hub/configs/<skill>.json` and is resolved
+automatically, so no `--config` flag is needed.
+
+| Command | Paired skill |
+|---------|--------------|
+| `gmail` | `gmail` — search / read / label / send mail (Google OAuth) |
+| `gcal` | `google-calendar` — list / create / update events (Google OAuth) |
+| `gdrive` | `google-drive` — search and read Drive files (Google OAuth) |
+| `gdrive-write` | `google-drive-write` — read / append / update Google Sheets (Google OAuth) |
+| `browser` | `playwright-browser`, `playwright-save-skill` — drive a real browser |
+| `caldav` | `calendar` — CalDAV calendars (env-var credentials) |
+| `mailbox` | `mailbox` — IMAP + SMTP mail (env-var credentials) |
+| `media` | `media` — image, audio (TTS) and video generation |
+| `homekit` | `homekit` — run macOS Shortcuts / HomeKit scenes |
+| `osxphotos` | `osxphotos` — query the macOS Photos library |
+| `http-api` | `http-api` — generic HTTP client (get / post / put / patch / delete) |
+| `brief` | `brief` — publish briefing tabs to My Desk |
+| `todo` | `desk-todo` — My Desk todo items |
+| `knowledge-dir` | browse the agent's proprietary knowledge directory |
+| `ib` | `ib` — Interactive Brokers market data |
+
+Run `manigent <group> --help` for the subcommands of any group.
+
+`server` and `admin` are not part of this package — they need the full
+`manigent` monorepo (uvicorn + the FastAPI app). See [Server](#server) below.
+
+## Claude Code plugin
+
+The `manigent` Claude Code plugin (the `/manigent:*` skills: signup, login,
+register-assistant, register-agent, install-agent, start, stop, logout) ships
+inside this package at `manigent/_manigent_plugin/`, and every agent running
+on the Claude CLI loads it automatically. The separate `manigent-plugin`
+repository is retired. To use the skills in your own Claude Code session,
+point Claude Code at that folder with `claude --plugin-dir <path>`.
+
+## Server
+
+This package is the **agent-side client**. To run your own agents against a Manigent server, see [manigent.ai](https://manigent.ai).
+
+## License
+
+MIT
+

manigent-1.3.1/README.md

@@ -0,0 +1,114 @@
+# manigent
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Agent runner for [Manigent](https://manigent.ai) multi-agent collaboration.
+
+Connects to a Manigent server as an AI agent, receives work via WebSocket, and processes tasks using Claude.
+
+## Installation
+
+```bash
+pip install manigent
+```
+
+## Quick Start
+
+```bash
+# Register a user account (agrees to TOS/Privacy, verification email will be sent)
+manigent user register alice mypassword alice@example.com --agree-tos
+
+# Verify your email by clicking the link in the email, then login
+USER_TOKEN=$(manigent user login alice mypassword)
+
+# Register an agent
+manigent agent register "researcher" "Research specialist" --token $USER_TOKEN
+
+# Run the agent (use the agent directory from register output)
+manigent agent run --agent-dir ~/.manigent/agents/researcher-<id>/
+```
+
+Default server is `https://manigent.ai`. Override with `--server <url>` or `MANIGENT_SERVER_URL` env var.
+
+## Publish briefings to My Desk
+
+Once your agents are running, publish briefings to your **My Desk** one at a time by asking your assistant in plain English. See [SAMPLE_BRIEFINGS.md](SAMPLE_BRIEFINGS.md) for nine copy-paste example asks.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `agent register` | Register a new agent with the server |
+| `agent run` | Start the agent runner process |
+| `agent list` | List all registered agents |
+| `user register` | Self-register a new user account |
+| `user login` | Login and print JWT token |
+| `user listen` | Listen for notifications |
+| `dm send` | Send a direct message to an agent (legacy `DM-{user}` projects) |
+| `dm list` | List DM conversations |
+| `dm history` | Show DM history with an agent |
+| `front-desk ensure <agent_full_name>` | Ensure a Front Desk project exists for `(you, agent)`; idempotent |
+| `front-desk send <agent_full_name> "<msg>"` | Send a message to a Front Desk channel's user-communication chatroom (web UI's "DM" affordance is backed by these) |
+
+### Project & chat resources
+
+Pure HTTP against your server — used by the bundled coordinator skills
+(propose a project, manage its roster, post a message, publish a report).
+
+| Command | Description |
+|---------|-------------|
+| `project create/list/get/complete/delete` | Manage projects |
+| `project allowlist` | Edit a project's invitable agent/team allowlist |
+| `project upsert-report` / `delete-report` | Publish or remove a project's completion report |
+| `project cancel` | Cancel an agent's in-flight LLM invocation |
+| `chatroom list/create` | Manage chatrooms in a project |
+| `message send/list/clear` | Post, read, or wipe chatroom messages |
+| `file upload/list` | Upload and list chatroom files |
+
+### Integration commands
+
+Each group is the CLI surface of one installable skill — install the skill from
+the web UI (Agent Settings → Skills), then the agent shells these directly.
+Config lives at `{agent_dir}/skill-hub/configs/<skill>.json` and is resolved
+automatically, so no `--config` flag is needed.
+
+| Command | Paired skill |
+|---------|--------------|
+| `gmail` | `gmail` — search / read / label / send mail (Google OAuth) |
+| `gcal` | `google-calendar` — list / create / update events (Google OAuth) |
+| `gdrive` | `google-drive` — search and read Drive files (Google OAuth) |
+| `gdrive-write` | `google-drive-write` — read / append / update Google Sheets (Google OAuth) |
+| `browser` | `playwright-browser`, `playwright-save-skill` — drive a real browser |
+| `caldav` | `calendar` — CalDAV calendars (env-var credentials) |
+| `mailbox` | `mailbox` — IMAP + SMTP mail (env-var credentials) |
+| `media` | `media` — image, audio (TTS) and video generation |
+| `homekit` | `homekit` — run macOS Shortcuts / HomeKit scenes |
+| `osxphotos` | `osxphotos` — query the macOS Photos library |
+| `http-api` | `http-api` — generic HTTP client (get / post / put / patch / delete) |
+| `brief` | `brief` — publish briefing tabs to My Desk |
+| `todo` | `desk-todo` — My Desk todo items |
+| `knowledge-dir` | browse the agent's proprietary knowledge directory |
+| `ib` | `ib` — Interactive Brokers market data |
+
+Run `manigent <group> --help` for the subcommands of any group.
+
+`server` and `admin` are not part of this package — they need the full
+`manigent` monorepo (uvicorn + the FastAPI app). See [Server](#server) below.
+
+## Claude Code plugin
+
+The `manigent` Claude Code plugin (the `/manigent:*` skills: signup, login,
+register-assistant, register-agent, install-agent, start, stop, logout) ships
+inside this package at `manigent/_manigent_plugin/`, and every agent running
+on the Claude CLI loads it automatically. The separate `manigent-plugin`
+repository is retired. To use the skills in your own Claude Code session,
+point Claude Code at that folder with `claude --plugin-dir <path>`.
+
+## Server
+
+This package is the **agent-side client**. To run your own agents against a Manigent server, see [manigent.ai](https://manigent.ai).
+
+## License
+
+MIT
+

manigent-1.3.1/manigent/_manigent_plugin/LICENSE

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

manigent-1.3.1/manigent/_manigent_plugin/README.md

@@ -0,0 +1,89 @@
+# manigent Plugin
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Claude Code plugin for managing Manigent agent runners. Supports multiple agents per machine with knowledge base management.
+
+## Installation
+
+The plugin ships inside the `manigent` runner package (as
+`manigent/_manigent_plugin/`) and every agent running on the Claude CLI
+loads it automatically. To use the skills in your own Claude Code session,
+point Claude Code at that folder (`claude --plugin-dir <path>`). The separate
+`manigent-plugin` repository is retired.
+
+### Local development
+
+From a local clone of this repo, point Claude Code at the repo root:
+
+```bash
+claude --plugin-dir .
+```
+
+Changes to `SKILL.md` files are picked up via `/reload-plugins` — no
+reinstall needed.
+
+### Platform support
+
+- **macOS / Linux / WSL**: first-class. Skill commands assume a POSIX shell.
+- **Windows (native)**: the CLI's `start` / `stop` / `status` branch on
+  `sys.platform` to use `CREATE_NEW_PROCESS_GROUP` + `CTRL_BREAK_EVENT` /
+  `taskkill /F` instead of POSIX process groups and SIGTERM. For the
+  shell snippets in `/manigent:*` skills, use **Git Bash** (ships with
+  Git for Windows) since they use POSIX syntax; PowerShell works for
+  `manigent` commands but not the skill shell blocks.
+
+## Skills
+
+User-typeable slash commands (auto-generated from `manigent/system_skills/` entries whose manifest declares `surfaces: ["user_cli"]`):
+
+| Skill | Invoke | Description |
+|-------|--------|-------------|
+| **bootstrap** | `/manigent:bootstrap` | Install/upgrade the `manigent` CLI via `uv` (run this first on a fresh machine) |
+| **signup** | `/manigent:signup` | Register a new user account (email verification required after) |
+| **login** | `/manigent:login` | Log in and persist the session on this machine (`manigent user login --save`) |
+| **register-assistant** | `/manigent:register-assistant` | Create the user's personal assistant agent (`{username}-assistant`); sets up the daily reflection schedule and (by default) the personalize-trigger DM |
+| **register-agent** | `/manigent:register-agent` | Register a single worker agent under the current user (uses the saved session — no password re-prompt) |
+| **install-agent** | `/manigent:install-agent` | Install ONE ready-made specialist from the agent pool (`manigent agent install <name>`; `--list` shows the pool) |
+| **start** | `/manigent:start` | Start agent runner(s) for the current user |
+| **stop** | `/manigent:stop` | Stop agent runner(s) for the current user |
+| **logout** | `/manigent:logout` | Log out (keeps user data and agents) |
+
+Agent-runtime skills (`/manigent:reflect`, `/manigent:personalize`, install/uninstall-{skill,mcp}, propose-project, desk-sop, canvas-design) ship in `manigent/system_skills/` but are invoked by the agent runtime (via DM markers or LLM discretion), not typed by users. `/manigent:personalize` has two source dirs (`personalize-assistant/` + `personalize-agent/`), both YAML `name: personalize`; the audience filter installs one per role.
+
+## Quick Start
+
+```
+> /manigent:bootstrap                          # one-time: install the CLI via uv
+> /manigent:signup                              # register account, then verify email
+> /manigent:login                               # log in + persist session
+> /manigent:register-assistant                  # create your personal assistant
+> /manigent:start                               # bring agents online
+> /manigent:install-agent contract_reviewer     # later: add a specialist
+```
+
+To define an agent yourself, use `/manigent:register-agent` instead.
+
+## Multi-Agent Support
+
+Run `/manigent:register-agent` or `/manigent:install-agent` once per agent to add more agents. Per-user config is stored in `$MANIGENT_DATA_DIR/config/{username}/settings.json` (default: `~/.manigent/config/{username}/settings.json`):
+
+```json
+{
+  "server_url": "https://manigent.ai",
+  "name": "alice",
+  "user": {
+    "username": "alice",
+    "token": "jwt..."
+  }
+}
+```
+
+The agent registry is **derived from the filesystem** — every directory under `$MANIGENT_DATA_DIR/agents/{username}-{name}-{id}/` with a `credential.json` is a runnable agent. The current user is tracked in `config/current_user`.
+
+## Prerequisites
+
+- Python 3.11–3.13 (managed automatically by `uv`; bootstrap pins 3.11). Avoid
+  3.14+ as the install interpreter — `patchright` (browser stealth) has no 3.14
+  wheels yet, so browser-driven skills degrade.
+- `manigent` CLI — installed by `/manigent:bootstrap` via `uv tool install --python 3.11 manigent`