primethink-cli 1.4.0__tar.gz → 1.5.0__tar.gz

{primethink_cli-1.4.0 → primethink_cli-1.5.0}/DEVELOPER.md

@@ -55,8 +55,8 @@ pip install -e ".[dev]"
 primethink-cli/
 ├── primethink.py           # Main CLI implementation (single module)
 ├── primethink_mcp.py       # MCP server (pt mcp), reuses primethink.py's helpers; optional [mcp] extra
-├── internal_tools/         # primethink-agent-tools: LangChain tools plugin for PT agents
-│                           #   (own distribution; depends on primethink-cli; reuses its helpers)
+├── primethink_agent_tools/ # Agent tools plugin: LangChain tools for PT agents; optional [agent-tools] extra
+│                           #   (entry point primethink.tools; reuses primethink.py's helpers)
 ├── pyproject.toml          # Package configuration (entry point: pt)
 ├── setup.py                # Legacy packaging shim
 ├── requirements.txt        # Runtime dependencies
@@ -85,7 +85,10 @@ primethink-cli/
     ├── test_task_commands.py # Task command tests
     ├── test_live_app.py    # Safe GitHub template scaffolding tests
     ├── test_install_developer_skill.py # Recursive public skill installer tests
-    └── test_install_skill.py # bundled CLI skill installer tests
+    ├── test_install_skill.py # bundled CLI skill installer tests
+    ├── test_mcp_server.py  # MCP server tests (skipped without the mcp SDK)
+    ├── test_agent_tools.py # Agent tools plugin tests (skipped without langchain-core)
+    └── test_packaging.py   # Wheel/entry-point/extras contract (runs on a base install)
 ```
 
 ## Architecture
@@ -142,7 +145,7 @@ def my_command(thing_id, profile, api_url):
 
 Security boundaries are enforced before the destination is exposed: HTTPS GitHub repository URLs only, compressed/expanded size and file-count limits, repository-relative manifest paths, path-traversal and duplicate-path checks, symbolic-link rejection, and refusal to touch an existing destination. Tests build in-memory ZIP archives and mock `requests.request`; do not make live GitHub calls in the test suite. The default catalog lives in the separate `primethink-app-templates` repository.
 
-Because this command only creates local source files and does not call the PrimeThink API, it has no MCP or `primethink-agent-tools` equivalent.
+Because this command only creates local source files and does not call the PrimeThink API, it has no MCP or agent-tools equivalent.
 
 #### 4. Agent Skill Installation
 
@@ -185,16 +188,18 @@ Key differences from the CLI, driven by MCP-over-stdio constraints:
 
 `mcp` is an optional dependency (the `[mcp]` extra, Python 3.10+); `pt mcp` imports `primethink_mcp` lazily and prints an install hint if the SDK is missing. Tests live in `tests/test_mcp_server.py` and `pytest.importorskip("mcp")` so they skip cleanly where the SDK isn't installed.
 
-#### 7. Agent Tools Plugin (`internal_tools/`)
+#### 7. Agent Tools Plugin (`primethink_agent_tools/`)
 
-`internal_tools/` is a **separate distribution** (`primethink-agent-tools`) that depends on `primethink-cli` and exposes the admin/management API as LangChain tools for PrimeThink agents, discovered via the `primethink.tools` entry point. It reuses the CLI's code rather than re-implementing it:
+`primethink_agent_tools/` ships **inside the `primethink-cli` wheel**, enabled by the optional `[agent-tools]` extra (`langchain-core`, `pydantic`; Python 3.9+). It exposes the admin/management API as LangChain tools for PrimeThink agents, discovered via the `primethink.tools` entry point that `pyproject.toml` declares (`primethink_admin = "primethink_agent_tools:register"`). It reuses the CLI's code rather than re-implementing it:
 
 - **Transport reuse without a rewrite.** Tools call `primethink._api_call` (the CLI's `requests` layer) through a small async wrapper (`client.api_json`) that runs it in `asyncio.to_thread` — the agent runtime is async, and `requests` is sync. No httpx dependency; `requests` comes transitively from `primethink-cli`.
 - **Payload reuse.** Tools import `_clean_payload`, `_TASK_PORTABLE_FIELDS`, `_VERSION_FIELDS`, etc. from `primethink`, so payload shaping matches `pt`/`pt mcp`. Only endpoint path strings are written locally (the accepted trade for not restructuring the CLI).
 - **Auth.** Per-user token from the `ADMIN_PRIMETHINK_API_TOKEN` setting, resolved via the injected `get_user_setting_value` context (`settings.PrimethinkSettingsProvider`), with a `StaticSettingsProvider` fallback for tests/standalone.
 - **Scope.** Admin/management only (tasks, agents, chats, collections + collection↔chat assignment). Excludes hot-path search, document byte transfer, messaging/orchestration, and destructive deletes — those stay native.
 
-This directory is **not** part of the `primethink-cli` wheel (the main `pyproject.toml` ships only `primethink`/`primethink_mcp`); it builds and tests independently (`pip install -e ./internal_tools[dev]`, `cd internal_tools && pytest`). When you add or change an API command that belongs in the agent surface, add/update the matching tool in `internal_tools/src/primethink_agent_tools/tools.py` and its test.
+Because the plugin and the private CLI helpers it imports (`_api_call`, `_clean_payload`, `_TASK_PORTABLE_FIELDS`, `_VERSION_FIELDS`) always ship in the same wheel, there is no cross-package version skew to guard against. The base CLI install is unaffected: the entry point is declared, but nothing loads it unless the PrimeThink API calls it, and `register()` imports langchain lazily — and when it is called without the extra, it raises a `ModuleNotFoundError` whose message names `pip install 'primethink-cli[agent-tools]'` (the API logs it and continues without the plugin). The API image installs `primethink-cli[agent-tools]==<version>`; see [`docs/agent-tools.md`](docs/agent-tools.md) for setup.
+
+Tests live in `tests/test_agent_tools.py` and `pytest.importorskip("langchain_core")`, so they skip where the extra isn't installed (the `dev` extra installs it); the packaging contract (entry point, `pyproject.toml` packages/extras, RECORD contents of a non-editable install, the `register()` install hint) lives in `tests/test_packaging.py` and needs no extra. When you add or change an API command that belongs in the agent surface, add/update the matching tool in `primethink_agent_tools/tools.py` and its test.
 
 ## Adding New Commands
 

{primethink_cli-1.4.0 → primethink_cli-1.5.0}/MANIFEST.in

@@ -7,6 +7,11 @@ recursive-include docs *.md *.txt
 recursive-include install *.sh *.ps1 *.cmd *.rb
 recursive-include scripts *.sh
 recursive-include skills *.md
+# setuptools auto-includes tests/test_*.py; add the package marker and shared
+# fixtures the test modules import (`from tests.conftest import ...`), plus the
+# pytest config, so a bare `pytest` inside an unpacked sdist collects `tests/`.
+recursive-include tests *.py
+include pytest.ini
 # Internal design/spec artifacts live under docs/ but must not ship in the sdist.
 prune docs/superpowers
 global-exclude __pycache__

{primethink_cli-1.4.0 → primethink_cli-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: primethink-cli
-Version: 1.4.0
+Version: 1.5.0
 Summary: PrimeThink CLI - A powerful tool for interacting with PrimeThink AI API
 Author-email: PrimeThink <support@primethink.ai>
 License-Expression: MIT
@@ -26,10 +26,15 @@ Requires-Dist: click>=8.0.0
 Requires-Dist: requests>=2.25.0
 Provides-Extra: mcp
 Requires-Dist: mcp<2,>=1.2.0; extra == "mcp"
+Provides-Extra: agent-tools
+Requires-Dist: langchain-core>=0.3.0; extra == "agent-tools"
+Requires-Dist: pydantic>=2.0; extra == "agent-tools"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
 Requires-Dist: mcp<2,>=1.2.0; python_version >= "3.10" and extra == "dev"
+Requires-Dist: langchain-core>=0.3.0; python_version >= "3.10" and extra == "dev"
+Requires-Dist: pydantic>=2.0; python_version >= "3.10" and extra == "dev"
 Dynamic: license-file
 
 # PrimeThink CLI
@@ -66,7 +71,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | Command | Description |
 |---|---|
 | `pt version` | Display the CLI version |
-| `pt whoami` | Show the authenticated user and their groups |
+| `pt whoami` | Show the authenticated user, their groups, active group, and configured providers |
 | `pt mcp` | Run PrimeThink as an MCP server (exposes the API as tools over stdio) |
 | `pt install-skill` | Install the bundled CLI agent skill for Claude Code and compatible agents |
 | `pt install-developer-skill` | Install the complete public PrimeThink developer skill, including nested resources |
@@ -79,7 +84,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt profile remove` | Remove a profile |
 | `pt chat send` | Send a message to a chat (by ID/mention) or an agent |
 | `pt chat list` | List chats (paginated, filterable by star/archive/workspace) |
-| `pt chat create` | Create a new chat |
+| `pt chat create` | Create a new chat (`--from-task-id` launches a task into it) |
 | `pt chat rename` | Rename a chat |
 | `pt chat goal` | Update a chat's goal |
 | `pt chat type` | Switch a chat between `live-app` and `chat` mode |
@@ -127,8 +132,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt agent list-docs` | List documents in an agent's knowledge base |
 | `pt agent upload-docs` | Upload files to an agent's knowledge base |
 | `pt agent attach-collections` / `pt agent detach-collection` | Attach / detach collections for agent RAG |
+| `pt agent upload-image` / `pt agent delete-image` | Upload / delete an agent's image |
 | `pt capability list` / `create` / `update` / `delete` | Manage agent capabilities |
 | `pt capability archive` / `unarchive` / `duplicate` | Archive, unarchive, or duplicate a capability |
+| `pt capability resolve` | Resolve capability codes/ids to ids |
 | `pt models list` / `pt models embeddings` | Discover LLM / embedding models from the catalog |
 | `pt scheduled-job list` / `create` / `update` | Manage scheduled jobs (prompts on a schedule) in a chat |
 | `pt scheduled-job set-status` / `delete` | Pause/resume or delete a scheduled job |
@@ -141,6 +148,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt tag list` / `create` / `assign` | List, create, and assign tags (task/agent/capability/collection) |
 | `pt group list` / `get` / `create` / `update` / `delete` | Manage groups (organizations) |
 | `pt group members` / `remove-member` / `invite` / `add-agent` | Manage group members, invites, and agents |
+| `pt settings list` / `get` / `set` / `delete` | Manage group/user settings and provider API keys (secrets never shown) |
+| `pt user list` / `search` | Look up users you can see by name or email |
+| `pt notification list` / `unread-count` | List your notifications or count the unread ones |
+| `pt notification mark-read` / `mark-unread` / `mark-all-read` / `delete` | Mark notifications read/unread, mark all read, or delete one |
 | `pt task list` | List tasks, filterable by name/type/status and paginated |
 | `pt task actions` | List available task actions |
 | `pt task execute` | Execute a task action with a message and optional files |
@@ -152,12 +163,17 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt task delete` | Delete a task (asks for confirmation; `--yes` to skip) |
 | `pt task duplicate` | Duplicate a task |
 | `pt task set-public` / `pt task set-private` | Make a task public / private |
-| `pt task publish` | Create/update a task from a project directory |
+| `pt task publish` | Create/update a task from a project directory (`--type`, feature toggles, optional `task.json`) |
+| `pt task launch` | Launch a task into a new chat, optionally inside a workspace |
 | `pt task test` | Sync a task goal into a new or existing chat |
 | `pt task export` | Export a task's portable config as JSON (for `pt task import`) |
 | `pt task import` | Create a new task from an exported JSON file (deploy across environments with `--profile`) |
 | `pt task create-version` | Snapshot a task's current state as a named version |
 | `pt task upload-image` | Upload an image for a task |
+| `pt eval list` / `add` / `update` / `delete` | Manage a task's evaluation-data set (the test plan) |
+| `pt eval settings` | Configure a task's evaluation settings (schedule, evaluator, thresholds) |
+| `pt eval run` / `runs` / `run-get` / `results` / `download` | Run a task evaluation and inspect its runs and results |
+| `pt eval simulate` / `simulations` / `delete-simulation` | Run and manage agent-vs-agent task simulations |
 | `pt search documents` | Semantic search across documents in a vector store collection |
 | `pt search chat` | Semantic search within a chat |
 | `pt search collection` | Semantic search within a collection |
@@ -171,7 +187,7 @@ Every command that calls the API also accepts `--profile` (use a specific profil
 
 `--help` works in either position: `pt chat send --help`, `pt chat --help send`, and `pt --help chat send` all print the same page.
 
-> **Tip:** `-p` is the short flag for `--profile` in the `pt task`, `pt agent`, and `pt search` groups, `pt image generate`, and `pt whoami`, but in the `pt chat` and `pt collection` groups there is no `-p` for profile — there `-p` means `--path` (a directory inside the chat/collection) on the file commands. Use the long form `--profile` when in doubt.
+> **Tip:** `-p` is the short flag for `--profile` in most groups (e.g. `pt task`, `pt agent`, `pt search`, `pt settings`, `pt user`, `pt notification`, `pt eval`), `pt image generate`, and `pt whoami`, but in the `pt chat` and `pt collection` groups there is no `-p` for profile — there `-p` means `--path` (a directory inside the chat/collection) on the file commands. Use the long form `--profile` when in doubt.
 
 ## Configuration
 
@@ -339,8 +355,12 @@ pt task import tasks/briefing.json --profile production
 
 # Publish a conventional task project (GOAL.md required); pass an ID to update
 pt task publish ./tasks/briefing --virtual-assistant-id 7
+pt task publish ./tasks/briefing --virtual-assistant-id 7 --type group --chat-history --docs-enabled --scheduled-jobs
 pt task publish ./tasks/briefing --task-id 99 --virtual-assistant-id 7
 
+# Launch a task into a chat (optionally inside a workspace), as the web app does
+pt task launch 99 --workspace-id 738
+
 # Make the resulting task public/private, or test its goal in a chat
 pt task set-public 99
 pt task set-private 99
@@ -429,21 +449,20 @@ for the full tool list.
 
 ## Agent Tools Plugin
 
-Beyond the CLI and MCP server, this repo also ships **[`primethink-agent-tools`](internal_tools/)**
-(under `internal_tools/`) — a plugin that exposes the PrimeThink admin/management
-API (tasks, agents, chats, collections) as **LangChain tools for PrimeThink
-agents**, reusing the same client code as `pt`. It's a separate distribution that
-depends on `primethink-cli`, so the CLI stays lean, and the plugin is installed
-only in the agent runtime:
+Beyond the CLI and MCP server, the package also ships the **agent tools plugin**
+(`primethink_agent_tools`) — it exposes the PrimeThink admin/management API
+(tasks, agents, chats, collections) as **LangChain tools for PrimeThink
+agents**, reusing the same client code as `pt`. It's enabled by the optional
+`agent-tools` extra, so plain CLI installs stay lean (no langchain) and the
+plugin is installed only in the agent runtime / API image:
 
 ```bash
-pip install primethink-cli primethink-agent-tools
+pip install 'primethink-cli[agent-tools]'
 ```
 
 The PrimeThink API discovers it automatically via the `primethink.tools` entry
 point. Authentication uses a per-user `ADMIN_PRIMETHINK_API_TOKEN` setting. See
-[`internal_tools/README.md`](internal_tools/README.md) for the tool list, auth,
-and setup.
+[`docs/agent-tools.md`](docs/agent-tools.md) for the tool list, auth, and setup.
 
 ## Agent Skills
 

primethink_cli-1.4.0/primethink_cli.egg-info/PKG-INFO → primethink_cli-1.5.0/README.md

@@ -1,37 +1,3 @@
-Metadata-Version: 2.4
-Name: primethink-cli
-Version: 1.4.0
-Summary: PrimeThink CLI - A powerful tool for interacting with PrimeThink AI API
-Author-email: PrimeThink <support@primethink.ai>
-License-Expression: MIT
-Project-URL: Homepage, https://primethink.ai
-Project-URL: Documentation, https://primethink.ai/cli/install
-Project-URL: Repository, https://github.com/primethink-ai/primethink-cli
-Project-URL: Issues, https://github.com/primethink-ai/primethink-cli/issues
-Keywords: cli,ai,primethink,api,assistant
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.0.0
-Requires-Dist: requests>=2.25.0
-Provides-Extra: mcp
-Requires-Dist: mcp<2,>=1.2.0; extra == "mcp"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: mcp<2,>=1.2.0; python_version >= "3.10" and extra == "dev"
-Dynamic: license-file
-
 # PrimeThink CLI
 
 Command Line Interface for interacting with the PrimeThink API.
@@ -66,7 +32,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | Command | Description |
 |---|---|
 | `pt version` | Display the CLI version |
-| `pt whoami` | Show the authenticated user and their groups |
+| `pt whoami` | Show the authenticated user, their groups, active group, and configured providers |
 | `pt mcp` | Run PrimeThink as an MCP server (exposes the API as tools over stdio) |
 | `pt install-skill` | Install the bundled CLI agent skill for Claude Code and compatible agents |
 | `pt install-developer-skill` | Install the complete public PrimeThink developer skill, including nested resources |
@@ -79,7 +45,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt profile remove` | Remove a profile |
 | `pt chat send` | Send a message to a chat (by ID/mention) or an agent |
 | `pt chat list` | List chats (paginated, filterable by star/archive/workspace) |
-| `pt chat create` | Create a new chat |
+| `pt chat create` | Create a new chat (`--from-task-id` launches a task into it) |
 | `pt chat rename` | Rename a chat |
 | `pt chat goal` | Update a chat's goal |
 | `pt chat type` | Switch a chat between `live-app` and `chat` mode |
@@ -127,8 +93,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt agent list-docs` | List documents in an agent's knowledge base |
 | `pt agent upload-docs` | Upload files to an agent's knowledge base |
 | `pt agent attach-collections` / `pt agent detach-collection` | Attach / detach collections for agent RAG |
+| `pt agent upload-image` / `pt agent delete-image` | Upload / delete an agent's image |
 | `pt capability list` / `create` / `update` / `delete` | Manage agent capabilities |
 | `pt capability archive` / `unarchive` / `duplicate` | Archive, unarchive, or duplicate a capability |
+| `pt capability resolve` | Resolve capability codes/ids to ids |
 | `pt models list` / `pt models embeddings` | Discover LLM / embedding models from the catalog |
 | `pt scheduled-job list` / `create` / `update` | Manage scheduled jobs (prompts on a schedule) in a chat |
 | `pt scheduled-job set-status` / `delete` | Pause/resume or delete a scheduled job |
@@ -141,6 +109,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt tag list` / `create` / `assign` | List, create, and assign tags (task/agent/capability/collection) |
 | `pt group list` / `get` / `create` / `update` / `delete` | Manage groups (organizations) |
 | `pt group members` / `remove-member` / `invite` / `add-agent` | Manage group members, invites, and agents |
+| `pt settings list` / `get` / `set` / `delete` | Manage group/user settings and provider API keys (secrets never shown) |
+| `pt user list` / `search` | Look up users you can see by name or email |
+| `pt notification list` / `unread-count` | List your notifications or count the unread ones |
+| `pt notification mark-read` / `mark-unread` / `mark-all-read` / `delete` | Mark notifications read/unread, mark all read, or delete one |
 | `pt task list` | List tasks, filterable by name/type/status and paginated |
 | `pt task actions` | List available task actions |
 | `pt task execute` | Execute a task action with a message and optional files |
@@ -152,12 +124,17 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt task delete` | Delete a task (asks for confirmation; `--yes` to skip) |
 | `pt task duplicate` | Duplicate a task |
 | `pt task set-public` / `pt task set-private` | Make a task public / private |
-| `pt task publish` | Create/update a task from a project directory |
+| `pt task publish` | Create/update a task from a project directory (`--type`, feature toggles, optional `task.json`) |
+| `pt task launch` | Launch a task into a new chat, optionally inside a workspace |
 | `pt task test` | Sync a task goal into a new or existing chat |
 | `pt task export` | Export a task's portable config as JSON (for `pt task import`) |
 | `pt task import` | Create a new task from an exported JSON file (deploy across environments with `--profile`) |
 | `pt task create-version` | Snapshot a task's current state as a named version |
 | `pt task upload-image` | Upload an image for a task |
+| `pt eval list` / `add` / `update` / `delete` | Manage a task's evaluation-data set (the test plan) |
+| `pt eval settings` | Configure a task's evaluation settings (schedule, evaluator, thresholds) |
+| `pt eval run` / `runs` / `run-get` / `results` / `download` | Run a task evaluation and inspect its runs and results |
+| `pt eval simulate` / `simulations` / `delete-simulation` | Run and manage agent-vs-agent task simulations |
 | `pt search documents` | Semantic search across documents in a vector store collection |
 | `pt search chat` | Semantic search within a chat |
 | `pt search collection` | Semantic search within a collection |
@@ -171,7 +148,7 @@ Every command that calls the API also accepts `--profile` (use a specific profil
 
 `--help` works in either position: `pt chat send --help`, `pt chat --help send`, and `pt --help chat send` all print the same page.
 
-> **Tip:** `-p` is the short flag for `--profile` in the `pt task`, `pt agent`, and `pt search` groups, `pt image generate`, and `pt whoami`, but in the `pt chat` and `pt collection` groups there is no `-p` for profile — there `-p` means `--path` (a directory inside the chat/collection) on the file commands. Use the long form `--profile` when in doubt.
+> **Tip:** `-p` is the short flag for `--profile` in most groups (e.g. `pt task`, `pt agent`, `pt search`, `pt settings`, `pt user`, `pt notification`, `pt eval`), `pt image generate`, and `pt whoami`, but in the `pt chat` and `pt collection` groups there is no `-p` for profile — there `-p` means `--path` (a directory inside the chat/collection) on the file commands. Use the long form `--profile` when in doubt.
 
 ## Configuration
 
@@ -339,8 +316,12 @@ pt task import tasks/briefing.json --profile production
 
 # Publish a conventional task project (GOAL.md required); pass an ID to update
 pt task publish ./tasks/briefing --virtual-assistant-id 7
+pt task publish ./tasks/briefing --virtual-assistant-id 7 --type group --chat-history --docs-enabled --scheduled-jobs
 pt task publish ./tasks/briefing --task-id 99 --virtual-assistant-id 7
 
+# Launch a task into a chat (optionally inside a workspace), as the web app does
+pt task launch 99 --workspace-id 738
+
 # Make the resulting task public/private, or test its goal in a chat
 pt task set-public 99
 pt task set-private 99
@@ -429,21 +410,20 @@ for the full tool list.
 
 ## Agent Tools Plugin
 
-Beyond the CLI and MCP server, this repo also ships **[`primethink-agent-tools`](internal_tools/)**
-(under `internal_tools/`) — a plugin that exposes the PrimeThink admin/management
-API (tasks, agents, chats, collections) as **LangChain tools for PrimeThink
-agents**, reusing the same client code as `pt`. It's a separate distribution that
-depends on `primethink-cli`, so the CLI stays lean, and the plugin is installed
-only in the agent runtime:
+Beyond the CLI and MCP server, the package also ships the **agent tools plugin**
+(`primethink_agent_tools`) — it exposes the PrimeThink admin/management API
+(tasks, agents, chats, collections) as **LangChain tools for PrimeThink
+agents**, reusing the same client code as `pt`. It's enabled by the optional
+`agent-tools` extra, so plain CLI installs stay lean (no langchain) and the
+plugin is installed only in the agent runtime / API image:
 
 ```bash
-pip install primethink-cli primethink-agent-tools
+pip install 'primethink-cli[agent-tools]'
 ```
 
 The PrimeThink API discovers it automatically via the `primethink.tools` entry
 point. Authentication uses a per-user `ADMIN_PRIMETHINK_API_TOKEN` setting. See
-[`internal_tools/README.md`](internal_tools/README.md) for the tool list, auth,
-and setup.
+[`docs/agent-tools.md`](docs/agent-tools.md) for the tool list, auth, and setup.
 
 ## Agent Skills
 

{primethink_cli-1.4.0 → primethink_cli-1.5.0}/SPECS.md

@@ -38,7 +38,7 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt chat send CHAT_ID` | `POST /api/v1/chats/{chat_id_or_mention}/messages` |
 | `pt chat send --agent ID` | `POST /api/v1/virtual-assistants/{agent_id}/messages` |
 | `pt chat list` | `GET /api/v1/chats` |
-| `pt chat create` | `POST /api/v1/chats` |
+| `pt chat create` | `POST /api/v1/chats` (`--from-task-id` adds `?copy_from_task_id=`) |
 | `pt chat rename` | `PUT /api/v1/chats/{chat_id}/name` |
 | `pt chat goal` | `PUT /api/v1/chats/{chat_id}/goal` |
 | `pt chat type` | `PUT /api/v1/chats/{chat_id}/page_type?page_type=html\|chat` |
@@ -93,12 +93,15 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt agent upload-docs` | `POST /api/v1/virtual-assistants/{va_id}/documents` (multipart) |
 | `pt agent attach-collections` | `POST /api/v1/virtual-assistants/{va_id}/collections/attach` |
 | `pt agent detach-collection` | `DELETE /api/v1/virtual-assistants/{va_id}/collections/{collection_id}` |
+| `pt agent upload-image` | `POST /api/v1/virtual-assistants/{va_id}/image` (multipart) |
+| `pt agent delete-image` | `DELETE /api/v1/virtual-assistants/{va_id}/image` |
 | `pt capability list` | `GET /api/v1/virtual-assistants/capabilities` |
 | `pt capability create` | `POST /api/v1/virtual-assistants/capabilities` |
 | `pt capability update` | `PATCH /api/v1/virtual-assistants/capabilities/{capability_id}` |
 | `pt capability delete` | `DELETE /api/v1/virtual-assistants/capabilities/{capability_id}` |
 | `pt capability archive` / `unarchive` | `PUT /api/v1/virtual-assistants/capabilities/{capability_id}/archived?archived=true\|false` |
 | `pt capability duplicate` | `POST /api/v1/virtual-assistants/capabilities/{capability_id}/duplicate` |
+| `pt capability resolve` | resolves capability codes/ids to ids via `GET /api/v1/virtual-assistants/capabilities` |
 | `pt models list` | `GET /api/v1/catalog/llm/models` |
 | `pt models embeddings` | `GET /api/v1/catalog/embeddings/models` |
 | `pt task list` | `GET /api/v1/tasks/` |
@@ -111,7 +114,8 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt task delete` | `DELETE /api/v1/tasks/{task_id}` |
 | `pt task duplicate` | `POST /api/v1/tasks/{task_id}/duplicate` |
 | `pt task set-public` / `set-private` | `PATCH /api/v1/tasks/{task_id}/public-status?task_type=public\|private` |
-| `pt task publish` | `POST /api/v1/tasks/` or `PATCH /api/v1/tasks/{task_id}` |
+| `pt task publish` | `POST /api/v1/tasks/` or `PATCH /api/v1/tasks/{task_id}` (type/toggles from options or the project's `task.json`) |
+| `pt task launch` | `POST /api/v1/chats?copy_from_task_id={task_id}[&task_version_number=N]` (body: optional `chat_workspace_id`, `name`) |
 | `pt task test` | `POST /api/v1/chats` (new only), `PUT /api/v1/chats/{chat_id}/page_type` (existing only), `PUT /api/v1/chats/{chat_id}/goal` |
 | `pt live-app publish` | task create/update + task version + task directory/document/version endpoints |
 | `pt live-app test` | chat create/page-type/goal + chat directory/document/version endpoints |
@@ -130,7 +134,7 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt voice diarize` | `POST /api/v1/voice/diarize` (multipart `file`[, `speaker_file`]) |
 | `pt voice translate` | `POST /api/v1/voice/translate` (multipart `file`) |
 | `pt video analyze` | `POST /api/v1/video/analyze` (multipart `file`) |
-| `pt whoami` | `GET /api/v1/users/me` + `GET /api/v1/users/me/groups` |
+| `pt whoami` | `GET /api/v1/users/me` + `GET /api/v1/users/me/groups` (response also includes `active_group` and `configured_providers`) |
 | `pt workspace list` | `GET /api/v1/chat-workspaces` |
 | `pt workspace create` | `POST /api/v1/chat-workspaces` |
 | `pt workspace rename` | `PUT /api/v1/chat-workspaces/{id}/name` |
@@ -152,6 +156,29 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt group remove-member` | `DELETE /api/v1/groups/{group_id}/members/` (`[user_ids]`) |
 | `pt group invite` | `POST /api/v1/groups/invite/?email=&role_id=` |
 | `pt group add-agent` / `remove-agent` | `POST /api/v1/groups/{group_id}/add_vas` / `DELETE .../remove_vas` (`[vas_ids]`) |
+| `pt settings list` | `GET /api/v1/groups/current/settings` + `GET /api/v1/users/me/settings` (+ dedicated properties); secret values never shown |
+| `pt settings get` | `GET` the group or user setting for KEY (`--scope group\|user`; sensitive values redacted) |
+| `pt settings set` | routed by KEY to the group/user setting endpoint; provider `*_API_KEY` keys stored as secrets |
+| `pt settings delete` | `DELETE` the KV setting for KEY (`--scope group\|user`; dedicated properties can't be deleted) |
+| `pt user list` / `search` | `GET /api/v1/users/me/visible-users[/full]` (search/limit are client-side) |
+| `pt notification list` | `GET /api/v1/notifications?page=&page_size=` (`--unread-only` is client-side) |
+| `pt notification unread-count` | `GET /api/v1/notifications/unread-count` |
+| `pt notification mark-read` / `mark-unread` | `POST /api/v1/notifications/{notification_id}/mark-as-read` / `.../mark-as-unread` |
+| `pt notification mark-all-read` | `POST /api/v1/notifications/mark-all-as-read` |
+| `pt notification delete` | `DELETE /api/v1/notifications/{notification_id}` |
+| `pt eval list` | `GET /api/v1/tasks/{task_id}/evaluation-data` |
+| `pt eval add` | `POST /api/v1/tasks/{task_id}/evaluation-data` |
+| `pt eval update` | `PATCH /api/v1/tasks/{task_id}/evaluation-data/{eval_id}` |
+| `pt eval delete` | `DELETE /api/v1/tasks/{task_id}/evaluation-data/{eval_id}` |
+| `pt eval settings` | `PATCH /api/v1/tasks/{task_id}/evaluation-settings` |
+| `pt eval run` | `POST /api/v1/tasks/{task_id}/evaluation` |
+| `pt eval runs` | `GET /api/v1/tasks/{task_id}/evaluations/runs/` |
+| `pt eval run-get` | `GET /api/v1/tasks/{task_id}/evaluations/runs/{run_id}` |
+| `pt eval results` | `GET /api/v1/tasks/{task_id}/evaluation_results` |
+| `pt eval download` | `GET /api/v1/tasks/{task_id}/evaluations/runs/{run_id}/download` |
+| `pt eval simulate` | `POST /api/v1/tasks/{task_id}/simulations` |
+| `pt eval simulations` | `GET /api/v1/tasks/{task_id}/simulations` |
+| `pt eval delete-simulation` | `DELETE /api/v1/tasks/{task_id}/simulations/{sim_id}` |
 | `pt {chat,collection,task,agent} mkdir` | `POST /api/v1/{owner}/{id}/directories?path=…` |
 | `pt {chat,collection,task,agent} rmdir` | `DELETE /api/v1/{owner}/{id}/directories/delete` (`{dir_path, delete_recursively}`) |
 | `pt {chat,collection,task,agent} move-dir` | `POST /api/v1/{owner}/{id}/directories/move` (`{src_dir, dest_parent, merge_dirs}`) |
@@ -283,11 +310,13 @@ pt chat list [--page N] [--page-size N] [--search TEXT] [--starred/--no-starred]
 
 **Body**: JSON object; all fields optional and omitted unless set — `name`, `goal`, `virtual_assistant_id` (int), `chat_workspace_id`, `parent_chat_id` (int), `type` (`standard` | `direct_users`; server default `standard`), `public` (bool), `members` (int array).
 
+**Query parameters** (task launch): `copy_from_task_id` (int) makes the server copy that task's goal, default agent, settings, documents, collections and scheduled job into the new chat and post its initial prompt — the route the web app uses to open a task; `task_version_number` (int, optional) launches a specific version. A `task_id` in the body is ignored by the server. Exposed as `pt task launch` / `pt chat create --from-task-id` and the `launch_task` MCP tool.
+
 **Success statuses**: 200, 201
 
 **CLI Command**:
 ```bash
-pt chat create [--name TEXT] [--goal TEXT | --goal-file PATH] [--virtual-assistant-id ID] [--workspace-id ID] [--parent-chat-id ID] [--type TYPE] [--public/--no-public] [--member USER_ID]...
+pt chat create [--name TEXT] [--goal TEXT | --goal-file PATH] [--virtual-assistant-id ID] [--workspace-id ID] [--parent-chat-id ID] [--type TYPE] [--public/--no-public] [--member USER_ID]... [--from-task-id TASK_ID]
 ```
 
 ---
@@ -827,7 +856,7 @@ pt search messages QUERY --collection-name NAME [--chat-id N] [--user-id N] [--a
 
 **Endpoints**: `GET /api/v1/users/me` and `GET /api/v1/users/me/groups`
 
-The CLI calls both and prints one combined JSON object: `{ "user": { ... }, "groups": [ ... ] }`.
+The CLI calls both and prints one combined JSON object: `{ "user": { ... }, "groups": [ ... ], "active_group": { "id": …, "name": … }, "configured_providers": [ ... ] }`. `active_group` is the user's currently active group; `configured_providers` lists the LLM provider slugs that have an API key set.
 
 **CLI Command**:
 ```bash