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

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

@@ -7,6 +7,8 @@ recursive-include docs *.md *.txt
 recursive-include install *.sh *.ps1 *.cmd *.rb
 recursive-include scripts *.sh
 recursive-include skills *.md
+# Internal design/spec artifacts live under docs/ but must not ship in the sdist.
+prune docs/superpowers
 global-exclude __pycache__
 global-exclude *.py[co]
 global-exclude .DS_Store

{primethink_cli-1.3.4/primethink_cli.egg-info → primethink_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: primethink-cli
-Version: 1.3.4
+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
@@ -25,11 +25,11 @@ License-File: LICENSE
 Requires-Dist: click>=8.0.0
 Requires-Dist: requests>=2.25.0
 Provides-Extra: mcp
-Requires-Dist: mcp>=1.2.0; 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>=1.2.0; python_version >= "3.10" and extra == "dev"
+Requires-Dist: mcp<2,>=1.2.0; python_version >= "3.10" and extra == "dev"
 Dynamic: license-file
 
 # PrimeThink CLI
@@ -89,26 +89,66 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt chat list-files` | List files and directories in a chat |
 | `pt chat upload-files` | Upload local files to a chat |
 | `pt chat download-file` | Download a file from a chat |
+| `pt chat delete-file` | Delete a file from a chat by document ID (asks for confirmation) |
+| `pt chat upload-text` | Create a chat document from raw text (no local file) |
+| `pt chat list-users` | List a chat's members |
+| `pt chat invite-members` / `pt chat remove-members` | Invite / remove users and agents in a chat |
+| `pt chat edit-message` / `delete-message` / `clear-messages` / `retry-message` | Edit, delete, clear, or retry chat messages |
+| `pt chat export-message` / `save-as-task` | Export a message (md/docx/pdf) or save a chat as a task |
 | `pt chat sync-to` | Sync a local directory into a chat |
 | `pt chat sync-from` | Sync a chat's files to a local directory |
 | `pt chat sync` | Two-way sync between a chat folder and a local directory |
+| `pt chatdb init` | Initialize a chat's ChatDB (Live App data) store |
+| `pt chatdb list` | List entities in a chat's ChatDB store |
+| `pt chatdb get` | Get one ChatDB entity by ID |
+| `pt chatdb add` | Add one or more rows to a ChatDB entity |
+| `pt chatdb update` | Update ChatDB entities (single or bulk) |
+| `pt chatdb delete` | Delete ChatDB entities (asks for confirmation) |
 | `pt collection list` | List collections (paginated, searchable) |
+| `pt collection create` | Create a collection |
+| `pt collection get` | Fetch a collection's details as JSON |
+| `pt collection update` | Update a collection's fields (name, indexing, …) |
+| `pt collection reindex` | Trigger a reindex of a collection |
+| `pt collection copy` | Duplicate a collection (by UUID) |
+| `pt collection delete` | Delete a collection (asks for confirmation; `--yes` to skip) |
 | `pt collection list-files` | List files and directories in a collection |
 | `pt collection upload-files` | Upload local files to a collection |
+| `pt collection upload-text` | Create a collection document from raw text (no local file) |
+| `pt collection delete-file` | Delete files from a collection by document ID (asks for confirmation) |
 | `pt collection download-file` | Download a file from a collection |
 | `pt collection sync-to` | Sync a local directory into a collection |
 | `pt collection sync-from` | Sync a collection's files to a local directory |
-| `pt agent list` | List agents (virtual assistants), filterable by name/type/status |
+| `pt agent list` | List agents (virtual assistants), filterable by name/type/status (`--summary` trims heavy config) |
 | `pt agent get` | Fetch an agent's details as JSON |
 | `pt agent create` | Create an agent |
 | `pt agent update` | Update fields on an existing agent |
 | `pt agent delete` | Delete an agent (asks for confirmation; `--yes` to skip) |
 | `pt agent types` | List available agent types |
+| `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 capability list` / `create` / `update` / `delete` | Manage agent capabilities |
+| `pt capability archive` / `unarchive` / `duplicate` | Archive, unarchive, or duplicate a capability |
+| `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 |
+| `pt {chat,collection,task,agent} mkdir` / `rmdir` | Create / delete a folder in a chat, collection, task, or agent |
+| `pt {chat,collection,task,agent} move-dir` / `rename-dir` | Move / rename a folder |
+| `pt {chat,collection,task} list-versions` / `new-version` / `new-text-version` | Manage a document's versions |
+| `pt {chat,collection,task} set-production-version` / `delete-version` | Promote or delete a document version |
+| `pt workspace list` / `create` / `rename` / `set-goal` / `delete` | Manage chat workspaces |
+| `pt workspace archive` / `pin` / `add-chat` / `remove-chat` | Organize chats within workspaces |
+| `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 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 |
 | `pt task create` | Create a task (supports schedules, canvases, and more) |
 | `pt task update` | Update fields on an existing task |
 | `pt task get` | Fetch a task's details as JSON |
+| `pt task upload-text` | Create a task document from raw text (no local file) |
+| `pt task add-docs` / `pt task delete-docs` | Add / delete task knowledge documents |
 | `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 |
@@ -122,7 +162,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt search chat` | Semantic search within a chat |
 | `pt search collection` | Semantic search within a collection |
 | `pt search messages` | Semantic search across chat messages |
+| `pt search images` | Search a collection's images by example image and/or text |
 | `pt image generate` | Generate an AI image and save it locally |
+| `pt voice stt` / `tts` / `diarize` / `translate` | Transcribe, synthesize, diarize, or translate audio |
+| `pt video analyze` | Analyze a video file |
 
 Every command that calls the API also accepts `--profile` (use a specific profile for one request) and `--api-url`/`-u` (override the API URL for one request). See the [full CLI reference](docs/cli-reference.md) for every option and example.
 

{primethink_cli-1.3.4 → primethink_cli-1.4.0}/README.md

@@ -55,26 +55,66 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt chat list-files` | List files and directories in a chat |
 | `pt chat upload-files` | Upload local files to a chat |
 | `pt chat download-file` | Download a file from a chat |
+| `pt chat delete-file` | Delete a file from a chat by document ID (asks for confirmation) |
+| `pt chat upload-text` | Create a chat document from raw text (no local file) |
+| `pt chat list-users` | List a chat's members |
+| `pt chat invite-members` / `pt chat remove-members` | Invite / remove users and agents in a chat |
+| `pt chat edit-message` / `delete-message` / `clear-messages` / `retry-message` | Edit, delete, clear, or retry chat messages |
+| `pt chat export-message` / `save-as-task` | Export a message (md/docx/pdf) or save a chat as a task |
 | `pt chat sync-to` | Sync a local directory into a chat |
 | `pt chat sync-from` | Sync a chat's files to a local directory |
 | `pt chat sync` | Two-way sync between a chat folder and a local directory |
+| `pt chatdb init` | Initialize a chat's ChatDB (Live App data) store |
+| `pt chatdb list` | List entities in a chat's ChatDB store |
+| `pt chatdb get` | Get one ChatDB entity by ID |
+| `pt chatdb add` | Add one or more rows to a ChatDB entity |
+| `pt chatdb update` | Update ChatDB entities (single or bulk) |
+| `pt chatdb delete` | Delete ChatDB entities (asks for confirmation) |
 | `pt collection list` | List collections (paginated, searchable) |
+| `pt collection create` | Create a collection |
+| `pt collection get` | Fetch a collection's details as JSON |
+| `pt collection update` | Update a collection's fields (name, indexing, …) |
+| `pt collection reindex` | Trigger a reindex of a collection |
+| `pt collection copy` | Duplicate a collection (by UUID) |
+| `pt collection delete` | Delete a collection (asks for confirmation; `--yes` to skip) |
 | `pt collection list-files` | List files and directories in a collection |
 | `pt collection upload-files` | Upload local files to a collection |
+| `pt collection upload-text` | Create a collection document from raw text (no local file) |
+| `pt collection delete-file` | Delete files from a collection by document ID (asks for confirmation) |
 | `pt collection download-file` | Download a file from a collection |
 | `pt collection sync-to` | Sync a local directory into a collection |
 | `pt collection sync-from` | Sync a collection's files to a local directory |
-| `pt agent list` | List agents (virtual assistants), filterable by name/type/status |
+| `pt agent list` | List agents (virtual assistants), filterable by name/type/status (`--summary` trims heavy config) |
 | `pt agent get` | Fetch an agent's details as JSON |
 | `pt agent create` | Create an agent |
 | `pt agent update` | Update fields on an existing agent |
 | `pt agent delete` | Delete an agent (asks for confirmation; `--yes` to skip) |
 | `pt agent types` | List available agent types |
+| `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 capability list` / `create` / `update` / `delete` | Manage agent capabilities |
+| `pt capability archive` / `unarchive` / `duplicate` | Archive, unarchive, or duplicate a capability |
+| `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 |
+| `pt {chat,collection,task,agent} mkdir` / `rmdir` | Create / delete a folder in a chat, collection, task, or agent |
+| `pt {chat,collection,task,agent} move-dir` / `rename-dir` | Move / rename a folder |
+| `pt {chat,collection,task} list-versions` / `new-version` / `new-text-version` | Manage a document's versions |
+| `pt {chat,collection,task} set-production-version` / `delete-version` | Promote or delete a document version |
+| `pt workspace list` / `create` / `rename` / `set-goal` / `delete` | Manage chat workspaces |
+| `pt workspace archive` / `pin` / `add-chat` / `remove-chat` | Organize chats within workspaces |
+| `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 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 |
 | `pt task create` | Create a task (supports schedules, canvases, and more) |
 | `pt task update` | Update fields on an existing task |
 | `pt task get` | Fetch a task's details as JSON |
+| `pt task upload-text` | Create a task document from raw text (no local file) |
+| `pt task add-docs` / `pt task delete-docs` | Add / delete task knowledge documents |
 | `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 |
@@ -88,7 +128,10 @@ pt chat send --agent AGENT_ID --message "your message"
 | `pt search chat` | Semantic search within a chat |
 | `pt search collection` | Semantic search within a collection |
 | `pt search messages` | Semantic search across chat messages |
+| `pt search images` | Search a collection's images by example image and/or text |
 | `pt image generate` | Generate an AI image and save it locally |
+| `pt voice stt` / `tts` / `diarize` / `translate` | Transcribe, synthesize, diarize, or translate audio |
+| `pt video analyze` | Analyze a video file |
 
 Every command that calls the API also accepts `--profile` (use a specific profile for one request) and `--api-url`/`-u` (override the API URL for one request). See the [full CLI reference](docs/cli-reference.md) for every option and example.
 

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

@@ -34,7 +34,7 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | CLI command | Method & endpoint |
 |---|---|
 | `pt task actions` | `GET /api/v1/tasks/available_task_actions` |
-| `pt task execute` | `POST /api/v1/tasks/execute_task_action` |
+| `pt task execute` | `POST /api/v1/tasks/{action_name}/execute` |
 | `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` |
@@ -48,8 +48,38 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt chat list-files` | `GET /api/v1/chats/{chat_id}/directories` |
 | `pt chat upload-files` / `sync-to` | `POST /api/v1/chats/{chat_id}/documents` |
 | `pt chat download-file` (filename lookup, then download below) | `GET /api/v1/chats/{chat_id}/document/{document_id}` |
+| `pt chat delete-file` | `DELETE /api/v1/chats/{chat_id}/document/{document_id}` |
+| `pt chat upload-text` | `POST /api/v1/chats/{chat_id}/texts` (bare array; `path` is a query param) |
+| `pt chat list-users` | `GET /api/v1/chats/{chat_id}/users` |
+| `pt chat invite-members` | `POST /api/v1/chats/{chat_id}/members` (`{user_ids, vas_ids}`) |
+| `pt chat remove-members` | `DELETE /api/v1/chats/{chat_id}/members` (`{user_ids, vas_ids}`) |
+| `pt chat edit-message` | `PUT /api/v1/chats/update_message_text/{message_id}` (`{message}`) |
+| `pt chat delete-message` | `DELETE /api/v1/chats/{chat_id}/messages/{message_id}` |
+| `pt chat clear-messages` | `POST /api/v1/chats/{chat_id}/messages/clear` |
+| `pt chat retry-message` | `POST /api/v1/chats/messages/{message_id}/retry` |
+| `pt chat export-message` | `GET /api/v1/chats/{chat_id}/save-as-{md\|docx\|pdf}-file/{msg_id}` |
+| `pt chat save-as-task` | `POST /api/v1/chats/{chat_id}/save-as-task` |
+| `pt scheduled-job list` | `GET /api/v1/scheduled_jobs/scheduled_jobs_in_chat/{chat_id}` |
+| `pt scheduled-job create` | `POST /api/v1/scheduled_jobs/scheduled_job_in_chat` |
+| `pt scheduled-job update` | `PUT /api/v1/scheduled_jobs/scheduled_job_in_chat/{job_id}` |
+| `pt scheduled-job set-status` | `PATCH /api/v1/scheduled_jobs/scheduled_job_in_chat/{job_id}/status?status=Active\|Paused` |
+| `pt scheduled-job delete` | `DELETE /api/v1/scheduled_jobs/scheduled_job_in_chat/{job_id}` |
 | document download (used by `download-file` and `sync-from`) | `GET /api/v1/documents/{document_id}/download` |
+| `pt chatdb init` | `POST /api/v1/chats/{chat_id}/chatdb/init` |
+| `pt chatdb list` | `POST /api/v1/chats/{chat_id}/chatdb/list` |
+| `pt chatdb get` | `GET /api/v1/chats/{chat_id}/chatdb/entities/{entity_id}` |
+| `pt chatdb add` | `POST /api/v1/chats/{chat_id}/chatdb/entities` |
+| `pt chatdb update` | `PATCH /api/v1/chats/{chat_id}/chatdb/entities` |
+| `pt chatdb delete` | `DELETE /api/v1/chats/{chat_id}/chatdb/entities` |
 | `pt collection list` | `GET /api/v1/collections` |
+| `pt collection create` | `POST /api/v1/collections` (params: `name`, `description`, `type`, `public`) |
+| `pt collection get` | `GET /api/v1/collections/{collection_id}` |
+| `pt collection update` | `PATCH /api/v1/collections/{collection_id}` |
+| `pt collection reindex` | `POST /api/v1/collections/{collection_id}/reindex` |
+| `pt collection copy` | `POST /api/v1/collections/{collection_uuid}/copy` |
+| `pt collection upload-text` | `POST /api/v1/collections/{collection_id}/texts` (`{texts, path}` body) |
+| `pt collection delete` | `DELETE /api/v1/collections/{collection_id}` |
+| `pt collection delete-file` | `DELETE /api/v1/collections/{collection_id}/documents` (body: array of document IDs) |
 | `pt collection list-files` | `GET /api/v1/collections/{collection_id}/directories` |
 | `pt collection upload-files` / `sync-to` | `POST /api/v1/collections/{collection_id}/documents` |
 | `pt collection download-file` (filename lookup, then download above) | `GET /api/v1/collections/{collection_id}` |
@@ -59,9 +89,25 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt agent update` | `PATCH /api/v1/virtual-assistants/{va_id}` |
 | `pt agent delete` | `DELETE /api/v1/virtual-assistants/{va_id}` |
 | `pt agent types` | `GET /api/v1/virtual-assistants/types` |
+| `pt agent list-docs` | `GET /api/v1/virtual-assistants/{va_id}/documents` |
+| `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 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 models list` | `GET /api/v1/catalog/llm/models` |
+| `pt models embeddings` | `GET /api/v1/catalog/embeddings/models` |
+| `pt task list` | `GET /api/v1/tasks/` |
 | `pt task create` | `POST /api/v1/tasks/` |
 | `pt task update` | `PATCH /api/v1/tasks/{task_id}` |
 | `pt task get` | `GET /api/v1/tasks/{task_id}` |
+| `pt task upload-text` | `POST /api/v1/tasks/{task_id}/texts` (bare array; `path` is a query param) |
+| `pt task add-docs` | `POST /api/v1/tasks/{task_id}/documents` (multipart) |
+| `pt task delete-docs` | `DELETE /api/v1/tasks/{task_id}/documents` (`{document_ids}`) |
 | `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` |
@@ -77,8 +123,51 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `pt search chat` | `GET /api/v1/chats/{chat_id}/semantic_search` |
 | `pt search collection` | `POST /api/v1/collections/{collection_id}/search` |
 | `pt search messages` | `GET /api/v1/chats/chat_semantic_search_messages` |
+| `pt search images` | `POST /api/v1/collections/{collection_id}/search/images` (multipart `image`, form `query`) |
 | `pt image generate` | `POST /api/v1/images/tti` |
+| `pt voice stt` | `POST /api/v1/voice/stt` (multipart `file`) |
+| `pt voice tts` | `POST /api/v1/voice/tts` (JSON; returns audio or JSON) |
+| `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 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` |
+| `pt workspace set-goal` | `PUT /api/v1/chat-workspaces/{id}/goal` |
+| `pt workspace archive` / `unarchive` | `POST /api/v1/chat-workspaces/{id}/archive/{true\|false}` |
+| `pt workspace pin` / `unpin` | `POST /api/v1/chat-workspaces/{id}/pin/{true\|false}` |
+| `pt workspace add-chat` | `POST /api/v1/chat-workspaces/{id}/add-chat/{chat_id}` |
+| `pt workspace remove-chat` | `DELETE /api/v1/chat-workspaces/remove-chat/{chat_id}` |
+| `pt workspace delete` | `DELETE /api/v1/chat-workspaces/{id}?delete_chats_in_workspace=` |
+| `pt tag list` | `GET /api/v1/tags?model=` |
+| `pt tag create` | `POST /api/v1/tags` (`{model, name, tag_category}`) |
+| `pt tag assign` | `PUT /api/v1/tags/assignments` (`{model, owner_id, tag_ids}`) |
+| `pt group list` | `GET /api/v1/groups/` |
+| `pt group get` | `GET /api/v1/groups/{group_id}` |
+| `pt group create` | `POST /api/v1/groups/` |
+| `pt group update` | `PUT /api/v1/groups/{group_id}` |
+| `pt group delete` | `DELETE /api/v1/groups/{group_id}` |
+| `pt group members` | `GET /api/v1/groups/{group_id}/members` |
+| `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 {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}`) |
+| `pt {chat,collection,task,agent} rename-dir` | `PUT /api/v1/{owner}/{id}/directories/rename` (`{src_dir_path, new_dir_name}`) |
+
+`{owner}` is `chats`, `collections`, `tasks`, or `virtual-assistants`; the MCP `create_directory`/`delete_directory`/`move_directory`/`rename_directory` tools select it via an `owner_type` of `chat`/`collection`/`task`/`agent`.
+
+| Command (under `pt chat` / `pt collection` / `pt task`) | Endpoint (`{owner}` = `chats`/`collections`/`tasks`) |
+|---|---|
+| `list-versions` | `GET /api/v1/{owner}/{id}/documents/{document_id}/versions` |
+| `new-version` | `POST /api/v1/{owner}/{id}/documents/{document_id}/create_new_version?version_name=…` (multipart `document`) |
+| `new-text-version` | `POST /api/v1/{owner}/{id}/documents/{document_id}/create_new_text_version?version_name=…` (`TextWithName` body) |
+| `set-production-version` | `POST /api/v1/{owner}/{id}/documents/{document_id}/set_production_version?version_number=…` |
+| `delete-version` | `DELETE /api/v1/{owner}/{id}/documents/{document_id}/delete_version/{version_number}` |
+
+The MCP `list_document_versions`/`create_document_version`/`create_document_text_version`/`set_production_version`/`delete_document_version` tools select the owner via an `owner_type` of `chat`/`collection`/`task`.
 
 ---
 
@@ -103,12 +192,15 @@ pt task actions [--profile PROFILE_NAME] [--api-url API_URL]
 
 Execute a specific task action with a message and optional files.
 
-**Endpoint**: `POST /api/v1/tasks/execute_task_action`
+**Endpoint**: `POST /api/v1/tasks/{task_id_or_action_name}/execute`
+
+The action name (or task ID) is URL-encoded into the path — there is no
+generic `/tasks/execute_task_action` route.
 
 **Content-Type**: `multipart/form-data`
 
 **Parameters**:
-- `task_action_name` (string, required): Name of the task action to execute
+- `{task_id_or_action_name}` (path, required): Name of the task action to execute (or a task ID)
 - `message_input` (string, required): Input message for the task
 - `files` (file, optional): Files to attach (can be multiple)
 - `return_original_message` (boolean, optional): Whether to return the original message