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

{primethink_cli-1.5.0/primethink_cli.egg-info → primethink_cli-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: primethink-cli
-Version: 1.5.0
+Version: 1.6.0
 Summary: PrimeThink CLI - A powerful tool for interacting with PrimeThink AI API
 Author-email: PrimeThink <support@primethink.ai>
 License-Expression: MIT
@@ -26,6 +26,7 @@ Requires-Dist: click>=8.0.0
 Requires-Dist: requests>=2.25.0
 Provides-Extra: mcp
 Requires-Dist: mcp<2,>=1.2.0; extra == "mcp"
+Requires-Dist: pydantic>=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"
@@ -104,7 +105,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | `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 list` | List entities in a chat's ChatDB store (or an attached DB Collection via `--collection`/`--collection-id`) |
 | `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) |

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/README.md

@@ -65,7 +65,7 @@ pt chat send --agent AGENT_ID --message "your message"
 | `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 list` | List entities in a chat's ChatDB store (or an attached DB Collection via `--collection`/`--collection-id`) |
 | `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) |

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

@@ -66,13 +66,13 @@ To obtain an API key, go to `Settings > API Keys` in the PrimeThink app and gene
 | `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 chatdb list` | `POST /api/v1/chats/{chat_id}/chatdb/list` (body may add `collection_name`/`collection_id`) |
+| `pt chatdb get` | `GET /api/v1/chats/{chat_id}/chatdb/entities/{entity_id}` (query: `collection_name`, `collection_id`) |
+| `pt chatdb add` | `POST /api/v1/chats/{chat_id}/chatdb/entities` (body may add `collection_name`/`collection_id`) |
+| `pt chatdb update` | `PATCH /api/v1/chats/{chat_id}/chatdb/entities` (body may add `collection_name`/`collection_id`) |
+| `pt chatdb delete` | `DELETE /api/v1/chats/{chat_id}/chatdb/entities` (body may add `collection_name`/`collection_id`) |
 | `pt collection list` | `GET /api/v1/collections` |
-| `pt collection create` | `POST /api/v1/collections` (params: `name`, `description`, `type`, `public`) |
+| `pt collection create` | `POST /api/v1/collections` (params: `name`, `description`, `type` = `collection`/`skill`/`external_source`/`db`, `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` |

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/USER_GUIDE.md

@@ -77,7 +77,7 @@ pt version
 
 You should see output like:
 ```
-PrimeThink CLI v1.5.0
+PrimeThink CLI v1.6.0
 ```
 
 ## Getting Started
@@ -713,6 +713,19 @@ pt chatdb delete 123 --entity-id 7          # asks for confirmation; --yes to sk
 
 `--data` takes a single JSON object; `--items` takes a JSON array for bulk operations. On update, `--merge` patches the existing row while `--replace` overwrites it, and `--if-unchanged-since TIMESTAMP` guards against overwriting a row that changed underneath you.
 
+### DB Collections
+
+A **DB Collection** is a collection of type `db` that holds the same kind of entities, but can be shared between chats. Once one is attached to a chat, `list`, `get`, `add`, `update` and `delete` can target it instead of the chat's own ChatDB, by name or by ID:
+
+```bash
+pt collection create --name project-db --type db     # note the id, e.g. 42
+# attach it to the chat in the web app, then:
+pt chatdb add 123 --entity tasks --data '{"title": "a"}' --collection project-db
+pt chatdb list 123 --entity tasks --collection-id 42
+```
+
+Prefer `--collection-id` when two attached DB Collections share a name, or in scripts that should survive a rename. If you pass both, they must identify the same collection. A collection attached read-only accepts `list`/`get` but rejects writes. This mirrors `pt.db('project-db')` / `pt.db(42)` in a Live App.
+
 > Building the Live App itself (the front-end that uses this data) is covered by the **primethink-developer** skill; `pt chatdb` is the deterministic data plane underneath it.
 
 ## Semantic Search
@@ -1144,10 +1157,10 @@ pt eval delete 99 EVAL_ID
 ### 2. Configure how evaluations run
 
 ```bash
-pt eval settings 99 --active --run-time daily --evaluator-agent-id 7 --pass-threshold 0.8
+pt eval settings 99 --active --run-time daily --evaluator-agent-id 7 --pass-threshold 80
 ```
 
-`--run-time` is `manual`, `daily`, `weekly`, or `monthly`; `--pass-threshold` is the minimum score to count as a pass; `--message-delay-ms` throttles messages during a run.
+`--run-time` is `manual`, `daily`, `weekly`, or `monthly`; `--pass-threshold` is the minimum score to count as a pass, as a whole-number percentage from 1 to 100 (`80`, not `0.8`) — anything outside that range is rejected by the CLI before a request is made; `--message-delay-ms` throttles messages during a run.
 
 ### 3. Run it, then read the results
 
@@ -1270,8 +1283,8 @@ Defaults are `--framework react --tailwind --flowbite`. Flowbite depends on Tail
 After generation:
 
 1. Read the generated `README.md`; build and deployment steps differ by template.
-2. Rename the sample Chat DB entity so it is unique to your app.
-3. Replace the sample CRUD interface while retaining the PrimeThink runtime, theme, persistence, and real-time patterns.
+2. Name every Chat DB entity for your app. The templates ship none, and a generic name such as `item` collides with a sibling app in the same chat.
+3. Build the interface on the blank starter, keeping the PrimeThink wiring it ships: the runtime, the host-theme bridge, and the deployment configuration.
 4. Build if required, then upload the files described by the template README.
 
 The default Flowbite React starter is a Vite project and requires a local `npm install` and build. The other default starters are no-build, one-file HTML applications. The CLI itself intentionally runs neither package installation nor generated code.

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/docs/agent-tools.md

@@ -60,7 +60,7 @@ resolve on 3.8. The `dev` extra installs the plugin's test dependencies only on
 
 ```bash
 # In the API image (production): one pinned line in requirements.txt
-primethink-cli[agent-tools]==1.5.0
+primethink-cli[agent-tools]==1.6.0
 
 # From a checkout (dev): the dev extra already includes langchain-core
 pip install -e ".[dev]"

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/docs/cli-reference.md

@@ -1,6 +1,6 @@
 # PrimeThink CLI — Command Reference
 
-Complete reference for every command in the PrimeThink CLI (`pt`), version 1.5.0.
+Complete reference for every command in the PrimeThink CLI (`pt`), version 1.6.0.
 
 Commands are organized into noun groups: `profile`, `live-app`, `chat`, `collection`, `agent`, `task`, `search`, and `image`.
 
@@ -221,7 +221,7 @@ Display the CLI version.
 
 ```bash
 pt version
-# PrimeThink CLI v1.5.0
+# PrimeThink CLI v1.6.0
 ```
 
 ### `pt whoami`
@@ -1021,6 +1021,13 @@ Entities are grouped by name (think tables); each row has an `id`. Initialize th
 
 > Unlike `pt chat`/`pt collection`, this group *does* use `-p` for `--profile` (there is no `--path` here).
 
+**Targeting a DB Collection.** By default every command below except `init` reads and writes the chat's own ChatDB. Pass `--collection NAME` and/or `--collection-id N` to target a **DB Collection** (a collection of type `db`, see `pt collection create --type db`) attached to the chat instead. The ID is unambiguous when several attached DB Collections share a name, and it survives a rename; when you pass both, they must identify the same collection or the API answers 404. Writes (`add`, `update`, `delete`) to a collection attached read-only are rejected with 403. The target is sent as `collection_name`/`collection_id` in the request body, or as query parameters for `get`. There is no `pt` command to attach a collection to a chat yet — attach it in the web app.
+
+```bash
+pt chatdb list 123 --entity tasks --collection project-db
+pt chatdb add 123 --entity tasks --data '{"title": "a"}' --collection-id 42
+```
+
 ### `pt chatdb init`
 
 Initialize the ChatDB store for a chat.
@@ -1047,6 +1054,8 @@ pt chatdb list CHAT_ID [OPTIONS]
 | `--offset` | Row offset |
 | `--page` | Page number |
 | `--page-size` | Results per page |
+| `--collection` | Target an attached DB Collection by name instead of the chat's own ChatDB |
+| `--collection-id` | Target an attached DB Collection by ID (≥ 1; unambiguous when names repeat) |
 
 Calls `POST /api/v1/chats/{chat_id}/chatdb/list`.
 
@@ -1060,9 +1069,14 @@ pt chatdb list 123 --entity todos --filters '{"done": false}' --limit 20
 Get a single ChatDB entity by its ID.
 
 ```bash
-pt chatdb get CHAT_ID ENTITY_ID [--profile NAME] [--api-url URL]
+pt chatdb get CHAT_ID ENTITY_ID [--collection NAME] [--collection-id N] [--profile NAME] [--api-url URL]
 ```
 
+| Option | Description |
+|---|---|
+| `--collection` | Target an attached DB Collection by name instead of the chat's own ChatDB |
+| `--collection-id` | Target an attached DB Collection by ID (≥ 1; unambiguous when names repeat) |
+
 Calls `GET /api/v1/chats/{chat_id}/chatdb/entities/{entity_id}`.
 
 ### `pt chatdb add`
@@ -1078,6 +1092,8 @@ pt chatdb add CHAT_ID --entity NAME [--data JSON] [--items JSON]
 | `--entity` | Entity name to add to (required) |
 | `--data` | A single row as a JSON object |
 | `--items` | Multiple rows as a JSON array (bulk insert) |
+| `--collection` | Target an attached DB Collection by name instead of the chat's own ChatDB |
+| `--collection-id` | Target an attached DB Collection by ID (≥ 1; unambiguous when names repeat) |
 
 Calls `POST /api/v1/chats/{chat_id}/chatdb/entities`.
 
@@ -1101,8 +1117,10 @@ pt chatdb update CHAT_ID [OPTIONS]
 | `--merge` / `--replace` | Merge `--data` into the existing row or replace it (server default applies if unset) |
 | `--items` | Bulk updates as a JSON array |
 | `--if-unchanged-since` | Only update if the row is unchanged since this timestamp (optimistic concurrency) |
+| `--collection` | Target an attached DB Collection by name instead of the chat's own ChatDB |
+| `--collection-id` | Target an attached DB Collection by ID (≥ 1; unambiguous when names repeat) |
 
-Requires at least one of `--entity-id`/`--data` or `--items`. Calls `PATCH /api/v1/chats/{chat_id}/chatdb/entities`.
+Requires at least one of `--entity-id`/`--data` or `--items`; a collection target on its own does not count. Calls `PATCH /api/v1/chats/{chat_id}/chatdb/entities`.
 
 ```bash
 pt chatdb update 123 --entity-id 7 --data '{"done": true}' --merge
@@ -1113,9 +1131,17 @@ pt chatdb update 123 --entity-id 7 --data '{"done": true}' --merge
 Delete a single row (`--entity-id`) or several (`--ids`). **Destructive and irreversible** — prompts for confirmation unless `--yes` is passed.
 
 ```bash
-pt chatdb delete CHAT_ID [--entity-id N | --ids 1,2,3] [--yes]
+pt chatdb delete CHAT_ID [--entity-id N | --ids 1,2,3] [--collection NAME] [--collection-id N] [--yes]
 ```
 
+| Option | Description |
+|---|---|
+| `--entity-id` | ID of a single row to delete |
+| `--ids` | Comma-separated row IDs to delete |
+| `--collection` | Target an attached DB Collection by name instead of the chat's own ChatDB |
+| `--collection-id` | Target an attached DB Collection by ID (≥ 1; unambiguous when names repeat) |
+| `--yes` | Skip the confirmation prompt |
+
 Requires `--entity-id` or `--ids`. Calls `DELETE /api/v1/chats/{chat_id}/chatdb/entities`.
 
 ```bash
@@ -1162,7 +1188,7 @@ pt collection create --name NAME [OPTIONS]
 |---|---|
 | `--name` | Collection name (required) |
 | `--description` | Collection description |
-| `--type` | Collection type: `collection`, `skill`, or `external_source` (server default: `collection`) |
+| `--type` | Collection type: `collection`, `skill`, `external_source`, or `db` (a DB Collection: structured entities that `pt chatdb --collection` and Live Apps' `pt.db()` read and write) (server default: `collection`) |
 | `--public` / `--private` | Make the collection public or private (server default: private) |
 
 Calls `POST /api/v1/collections` and prints the created collection as JSON.
@@ -1198,7 +1224,7 @@ pt collection update COLLECTION_ID [OPTIONS]
 |---|---|
 | `--name` | Collection name |
 | `--description` | Collection description |
-| `--type` | Collection type: `collection`, `skill`, or `external_source` |
+| `--type` | Collection type: `collection`, `skill`, `external_source`, or `db` |
 | `--public` / `--private` | Make the collection public or private |
 | `--indexed` / `--not-indexed` | Enable or disable indexing |
 | `--ocr-instructions` | OCR instructions for document processing |
@@ -2472,7 +2498,7 @@ pt eval update TASK_ID EVAL_ID [--user-query …] [--ideal-response …] [--type
 pt eval delete TASK_ID EVAL_ID [--yes]                       # DESTRUCTIVE
 
 # Configure how evaluations run
-pt eval settings TASK_ID [--active | --inactive] [--run-time manual|daily|weekly|monthly] [--evaluator-agent-id N] [--pass-threshold F] [--message-delay-ms N]
+pt eval settings TASK_ID [--active | --inactive] [--run-time manual|daily|weekly|monthly] [--evaluator-agent-id N] [--pass-threshold 1-100] [--message-delay-ms N]
 
 # Run an evaluation and inspect its runs/results
 pt eval run TASK_ID [--version N] [--model-override M]
@@ -2503,13 +2529,13 @@ pt eval delete-simulation TASK_ID SIM_ID [--yes]             # DESTRUCTIVE
 | `simulations` | `GET /api/v1/tasks/{id}/simulations` | `list_task_simulations` |
 | `delete-simulation` | `DELETE /api/v1/tasks/{id}/simulations/{sim_id}` | `delete_task_simulation` |
 
-`--type` for a test case is `exact` (exact-match), `similar` (fuzzy/semantic match), or `agent` (an evaluator agent judges the response). `--examples` takes a JSON object of good/bad example fields. `--chat-group` (default `1`) groups related test cases.
+`--pass-threshold` is the minimum score that counts as a pass, as a whole-number percentage from 1 to 100 (`80`, not `0.8`); the CLI rejects anything outside that range with a usage error before any request is made. `--type` for a test case is `exact` (exact-match), `similar` (fuzzy/semantic match), or `agent` (an evaluator agent judges the response). `--examples` takes a JSON object of good/bad example fields. `--chat-group` (default `1`) groups related test cases.
 
 ```bash
 # Build a two-case plan, make it evaluator-judged and daily, then run it
 pt eval add 99 --user-query "What's your return window?" --ideal-response "30 days" --type similar
 pt eval add 99 --user-query "Refund a gift?" --ideal-response "Yes, store credit" --type agent --evaluator-agent-id 7
-pt eval settings 99 --active --run-time daily --evaluator-agent-id 7 --pass-threshold 0.8
+pt eval settings 99 --active --run-time daily --evaluator-agent-id 7 --pass-threshold 80
 pt eval run 99
 pt eval results 99 | jq '.[] | {case, passed, score}'
 ```

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/primethink.py

@@ -7,6 +7,8 @@ import json
 import shutil
 import tempfile
 import zipfile
+import re
+import html as html_module
 import contextlib
 import mimetypes
 import webbrowser
@@ -921,7 +923,7 @@ def cli():
 @cli.command()
 def version():
     """Display the version of PrimeThink CLI."""
-    click.echo("PrimeThink CLI v1.5.0")
+    click.echo("PrimeThink CLI v1.6.0")
 
 
 @cli.command()
@@ -1208,6 +1210,107 @@ def _select_live_app_template(templates, framework, tailwind, flowbite):
     return template_id, _safe_catalog_path(item.get('path'), 'template path')
 
 
+# ---------------------------------------------------------------------------
+# Scaffold identity
+#
+# `pt live-app new` used to extract the archive verbatim, so the TEMPLATE's own
+# <title> and meta description shipped with the app. In a reported build they
+# reached production: nothing downstream rewrites them, `verify-dist` cannot tell a
+# placeholder from a deliberate title, and the browser tab is the last place anyone
+# looks. This is the one point in the whole flow where the app has a name, so it is
+# the only place the rewrite can happen.
+# ---------------------------------------------------------------------------
+
+_TITLE_TAG = re.compile(r'(<title\b[^>]*>)(.*?)(</title>)', re.IGNORECASE | re.DOTALL)
+# The quotes are back-referenced, not just "one of ' or \"". Matching them
+# independently breaks on an apostrophe inside a double-quoted attribute:
+# content="Bob's canvas" would end the match at the apostrophe and leave
+# `s canvas"` dangling in the markup after the replacement.
+_DESCRIPTION_META = re.compile(
+    r'(<meta\b[^>]*\bname=(["\'])description\2[^>]*?\bcontent=(["\']))(.*?)\3',
+    re.IGNORECASE | re.DOTALL,
+)
+
+# npm rejects a package name longer than this.
+_MAX_PACKAGE_NAME = 214
+
+
+# Directory names that describe a slot rather than an app. A repo convention that
+# scaffolds into `<app>/sandbox` would otherwise title every app "Sandbox" — which it
+# did, and it reached a published task before anyone noticed.
+_CONTAINER_DIR_NAMES = {'sandbox', 'app', 'apps', 'src', 'dist', 'web', 'client', 'frontend'}
+
+
+def _app_identity(destination):
+    """A display title and an npm-safe package name, from the target directory name.
+
+    ``my-cool-app`` -> ``("My Cool App", "my-cool-app")``. When the target is a
+    container directory, the parent names the app instead:
+    ``word-painter/sandbox`` -> ``("Word Painter", "word-painter")``.
+    """
+    resolved = Path(destination).resolve()
+    raw = resolved.name
+    if raw.lower() in _CONTAINER_DIR_NAMES and resolved.parent.name:
+        raw = resolved.parent.name
+    words = [w for w in re.split(r'[-_\s]+', raw) if w]
+    title = ' '.join(w[:1].upper() + w[1:] for w in words) if words else raw
+    package = re.sub(r'[^a-z0-9._-]+', '-', raw.lower()).strip('-._')
+    package = package[:_MAX_PACKAGE_NAME].rstrip('-._')
+    return title, (package or 'primethink-live-app')
+
+
+def _personalise_live_app_template(staging, title, package_name):
+    """Stamp the new app's identity over the template's, in the staging directory.
+
+    Best-effort: a template that ships no index.html or no package.json is left
+    alone, and an unreadable or malformed file is skipped rather than failing the
+    scaffold. Returns the list of files actually changed, for the command output.
+    """
+    changed = []
+
+    index_html = Path(staging) / 'index.html'
+    if index_html.is_file():
+        try:
+            source = index_html.read_text(encoding='utf-8')
+        except (OSError, UnicodeDecodeError):
+            source = None
+        if source is not None:
+            escaped = html_module.escape(title, quote=True)
+            description = html_module.escape(
+                f'{title} \u2014 a PrimeThink Live App', quote=True
+            )
+            updated, titles = _TITLE_TAG.subn(
+                lambda m: m.group(1) + escaped + m.group(3), source, count=1
+            )
+            updated, metas = _DESCRIPTION_META.subn(
+                lambda m: m.group(1) + description + m.group(3), updated, count=1
+            )  # group(3) is the opening content quote, reused as the closing one
+            if (titles or metas) and updated != source:
+                try:
+                    index_html.write_text(updated, encoding='utf-8')
+                    changed.append('index.html')
+                except OSError:
+                    pass
+
+    package_json = Path(staging) / 'package.json'
+    if package_json.is_file():
+        try:
+            manifest = json.loads(package_json.read_text(encoding='utf-8'))
+        except (OSError, UnicodeDecodeError, ValueError):
+            manifest = None
+        if isinstance(manifest, dict) and manifest.get('name') != package_name:
+            manifest['name'] = package_name
+            try:
+                package_json.write_text(
+                    json.dumps(manifest, indent=2) + '\n', encoding='utf-8'
+                )
+                changed.append('package.json')
+            except OSError:
+                pass
+
+    return changed
+
+
 def _extract_live_app_template(archive_bytes, destination, framework, tailwind, flowbite):
     """Safely and atomically extract one selected template into destination."""
     destination = Path(destination)
@@ -1275,6 +1378,8 @@ def _extract_live_app_template(archive_bytes, destination, framework, tailwind,
                     target.parent.mkdir(parents=True, exist_ok=True)
                     with archive.open(info) as source, open(target, 'wb') as output:
                         shutil.copyfileobj(source, output)
+                title, package_name = _app_identity(destination)
+                personalised = _personalise_live_app_template(staging, title, package_name)
                 if destination.exists():
                     raise click.ClickException(f"destination already exists: {destination}")
                 staging.replace(destination)
@@ -1282,7 +1387,7 @@ def _extract_live_app_template(archive_bytes, destination, framework, tailwind,
             raise
         except (OSError, RuntimeError, zipfile.BadZipFile) as e:
             raise click.ClickException(f"could not create live app at {destination}: {e}")
-    return template_id
+    return template_id, title, personalised
 
 
 @cli.group(name='live-app')
@@ -1310,11 +1415,13 @@ def live_app_new(directory, framework, tailwind, flowbite, repo_url, ref):
     if directory.exists():
         raise click.ClickException(f"destination already exists: {directory}")
     archive = _download_template_archive(repo_url, ref)
-    template_id = _extract_live_app_template(
+    template_id, title, personalised = _extract_live_app_template(
         archive, directory, framework, tailwind, flowbite
     )
     click.echo(f"Created PrimeThink Live App at {directory}")
     click.echo(f"Template: {template_id} ({framework}, tailwind={'yes' if tailwind else 'no'}, flowbite={'yes' if flowbite else 'no'})")
+    if personalised:
+        click.echo(f"Named \"{title}\" in {', '.join(personalised)} — edit if you want something else.")
     click.echo("Next: read the generated README.md and learn how to build Live Apps.")
 
 
@@ -1936,8 +2043,31 @@ def install_developer_skill(target, custom_dir, force, repo_url, ref):
     file_count = _extract_github_subdirectory(
         archive, DEVELOPER_SKILL_PATH, destination, force=force
     )
+    # Record what was installed. Three build reports in a row could not cite which
+    # revision of the skill they were reporting against, because the installed tree
+    # carries no marker at all — which makes a finding unfixable by anyone who was
+    # not in that session.
+    from datetime import datetime, timezone
+    installed_at = datetime.now(timezone.utc).replace(microsecond=0).isoformat()
+    marker = destination / 'VERSION'
+    try:
+        marker.write_text(
+            f"ref: {ref}\n"
+            f"repo: {repo_url}\n"
+            f"path: {DEVELOPER_SKILL_PATH}\n"
+            f"files: {file_count}\n"
+            f"installed_at: {installed_at}\n",
+            encoding='utf-8',
+        )
+    except OSError as exc:
+        # A missing marker must never fail an otherwise good install.
+        marker_line = f"Version marker not written ({exc}); installed ref {ref}"
+    else:
+        marker_line = f"Version marker: {marker} (ref {ref})"
+
     click.echo(f"Installed skill '{DEVELOPER_SKILL_NAME}' to {destination}")
     click.echo(f"Included {file_count} files from {DEVELOPER_SKILL_PATH}, including subdirectories.")
+    click.echo(marker_line)
     click.echo("Compatible agents will pick it up on their next session in that scope.")
 
 # ============================================================================
@@ -2644,10 +2774,28 @@ def sync(chat_id, local_dir, path, prefer, dry_run, profile, api_url):
 
 @cli.group(name='chatdb')
 def chatdb():
-    """ChatDB commands: read and write a chat's Live App data store."""
+    """ChatDB commands: read and write a chat's Live App data store.
+
+    By default each command targets the chat's own ChatDB. Pass --collection NAME
+    and/or --collection-id N to target a DB Collection attached to the chat instead.
+    """
     pass
 
 
+def _chatdb_target_options(f):
+    """Apply the --collection/--collection-id DB Collection target options to a chatdb command."""
+    f = click.option('--collection-id', 'collection_id', default=None, type=click.IntRange(min=1),
+                     help="Target an attached DB Collection by ID (unambiguous when names repeat)")(f)
+    f = click.option('--collection', 'collection_name', default=None,
+                     help="Target an attached DB Collection by name instead of the chat's own ChatDB")(f)
+    return f
+
+
+def _chatdb_target(collection_name, collection_id):
+    """The DB Collection target fields; empty (the chat's own ChatDB) when neither is set."""
+    return _clean_payload({'collection_name': collection_name, 'collection_id': collection_id}, {})
+
+
 @chatdb.command(name='init')
 @click.argument('chat_id')
 @_connection_options
@@ -2669,8 +2817,10 @@ def chatdb_init(chat_id, profile, api_url):
 @click.option('--offset', default=None, type=int, help='Row offset')
 @click.option('--page', default=None, type=int, help='Page number')
 @click.option('--page-size', default=None, type=int, help='Results per page')
+@_chatdb_target_options
 @_connection_options
-def chatdb_list(chat_id, entity_names, filters, limit, offset, page, page_size, profile, api_url):
+def chatdb_list(chat_id, entity_names, filters, limit, offset, page, page_size,
+                collection_name, collection_id, profile, api_url):
     """List entities in a chat's ChatDB store."""
     api_url, token = _resolve_connection(profile, api_url)
     filters = _parse_json_option(filters, '--filters')
@@ -2678,6 +2828,7 @@ def chatdb_list(chat_id, entity_names, filters, limit, offset, page, page_size,
         'entity_names': list(entity_names) or None, 'filters': filters,
         'limit': limit, 'offset': offset, 'page': page, 'page_size': page_size,
     }, {})
+    payload.update(_chatdb_target(collection_name, collection_id))
     response = _api_request('POST', f"{api_url}/api/v1/chats/{chat_id}/chatdb/list", token,
                             ok_status=(200, 201), json=payload)
     click.echo(json.dumps(response.json(), indent=2))
@@ -2686,11 +2837,13 @@ def chatdb_list(chat_id, entity_names, filters, limit, offset, page, page_size,
 @chatdb.command(name='get')
 @click.argument('chat_id')
 @click.argument('entity_id')
+@_chatdb_target_options
 @_connection_options
-def chatdb_get(chat_id, entity_id, profile, api_url):
+def chatdb_get(chat_id, entity_id, collection_name, collection_id, profile, api_url):
     """Get one ChatDB entity by its ID."""
     api_url, token = _resolve_connection(profile, api_url)
-    response = _api_request('GET', f"{api_url}/api/v1/chats/{chat_id}/chatdb/entities/{entity_id}", token)
+    response = _api_request('GET', f"{api_url}/api/v1/chats/{chat_id}/chatdb/entities/{entity_id}", token,
+                            params=_chatdb_target(collection_name, collection_id) or None)
     click.echo(json.dumps(response.json(), indent=2))
 
 
@@ -2699,8 +2852,9 @@ def chatdb_get(chat_id, entity_id, profile, api_url):
 @click.option('--entity', 'entity_name', required=True, help='Entity name (collection/table)')
 @click.option('--data', default=None, help='A single entity as a JSON object')
 @click.option('--items', default=None, help='Multiple entities as a JSON array (bulk insert)')
+@_chatdb_target_options
 @_connection_options
-def chatdb_add(chat_id, entity_name, data, items, profile, api_url):
+def chatdb_add(chat_id, entity_name, data, items, collection_name, collection_id, profile, api_url):
     """Add one entity (--data) or many (--items) to a ChatDB entity."""
     api_url, token = _resolve_connection(profile, api_url)
     payload = _clean_payload({
@@ -2708,6 +2862,7 @@ def chatdb_add(chat_id, entity_name, data, items, profile, api_url):
         'data': _parse_json_option(data, '--data'),
         'items': _parse_json_option(items, '--items'),
     }, {})
+    payload.update(_chatdb_target(collection_name, collection_id))
     response = _api_request('POST', f"{api_url}/api/v1/chats/{chat_id}/chatdb/entities", token,
                             ok_status=(200, 201), json=payload)
     click.echo(json.dumps(response.json(), indent=2))
@@ -2722,8 +2877,10 @@ def chatdb_add(chat_id, entity_name, data, items, profile, api_url):
 @click.option('--items', default=None, help='Bulk updates as a JSON array')
 @click.option('--if-unchanged-since', default=None,
               help='Only update if the row is unchanged since this timestamp (optimistic concurrency)')
+@_chatdb_target_options
 @_connection_options
-def chatdb_update(chat_id, entity_id, data, merge, items, if_unchanged_since, profile, api_url):
+def chatdb_update(chat_id, entity_id, data, merge, items, if_unchanged_since,
+                  collection_name, collection_id, profile, api_url):
     """Update ChatDB entities (by --entity-id, or in bulk via --items)."""
     api_url, token = _resolve_connection(profile, api_url)
     payload = _clean_payload({
@@ -2734,6 +2891,7 @@ def chatdb_update(chat_id, entity_id, data, merge, items, if_unchanged_since, pr
     if not payload:
         click.echo("Error: Nothing to update. Provide --entity-id/--data or --items.")
         sys.exit(1)
+    payload.update(_chatdb_target(collection_name, collection_id))
     response = _api_request('PATCH', f"{api_url}/api/v1/chats/{chat_id}/chatdb/entities", token,
                             json=payload)
     click.echo(json.dumps(response.json(), indent=2))
@@ -2744,8 +2902,9 @@ def chatdb_update(chat_id, entity_id, data, merge, items, if_unchanged_since, pr
 @click.option('--entity-id', default=None, type=int, help='ID of a single entity to delete')
 @click.option('--ids', default=None, help='Comma-separated entity IDs to delete')
 @click.confirmation_option('--yes', prompt='Delete the specified ChatDB entities? This cannot be undone.')
+@_chatdb_target_options
 @_connection_options
-def chatdb_delete(chat_id, entity_id, ids, profile, api_url):
+def chatdb_delete(chat_id, entity_id, ids, collection_name, collection_id, profile, api_url):
     """Delete ChatDB entities by --entity-id or a list of --ids."""
     api_url, token = _resolve_connection(profile, api_url)
     id_list = None
@@ -2759,6 +2918,7 @@ def chatdb_delete(chat_id, entity_id, ids, profile, api_url):
     if not payload:
         click.echo("Error: Provide --entity-id or --ids.")
         sys.exit(1)
+    payload.update(_chatdb_target(collection_name, collection_id))
     _api_request('DELETE', f"{api_url}/api/v1/chats/{chat_id}/chatdb/entities", token,
                  ok_status=(200, 204), json=payload)
     click.echo(f"Deleted ChatDB entities from chat {chat_id}")
@@ -2793,7 +2953,7 @@ def collections_list(page, page_size, search, profile, api_url):
 @click.option('--name', required=True, help='Collection name')
 @click.option('--description', default=None, help='Collection description')
 @click.option('--type', 'collection_type', default=None,
-              type=click.Choice(['collection', 'skill', 'external_source']),
+              type=click.Choice(['collection', 'skill', 'external_source', 'db']),
               help='Collection type (server default: collection)')
 @click.option('--public/--private', 'public', default=None, help='Make the collection public (server default: private)')
 @_connection_options(profile_short=False)
@@ -2825,7 +2985,7 @@ def collection_get(collection_id, profile, api_url):
 @click.option('--name', default=None, help='Collection name')
 @click.option('--description', default=None, help='Collection description')
 @click.option('--type', 'collection_type', default=None,
-              type=click.Choice(['collection', 'skill', 'external_source']),
+              type=click.Choice(['collection', 'skill', 'external_source', 'db']),
               help='Collection type')
 @click.option('--public/--private', 'public', default=None, help='Make the collection public or private')
 @click.option('--indexed/--not-indexed', 'indexed', default=None, help='Enable or disable indexing')
@@ -3128,7 +3288,11 @@ def _build_task_payload(**kwargs):
 
 @cli.group()
 def task():
-    """Task management commands."""
+    """Task management commands.
+
+    Evaluations and simulations of a task live under `pt eval`
+    (add/run/results, simulate/simulations) — they are not subcommands here.
+    """
     pass
 
 
@@ -4789,8 +4953,8 @@ def eval_delete(task_id, evaluation_data_id, profile, api_url):
               help='When evaluations run: manual/daily/weekly/monthly')
 @click.option('--evaluator-agent-id', 'default_evaluator_agent_id', default=None, type=int,
               help='Default grading agent')
-@click.option('--pass-threshold', 'evaluation_pass_threshold', default=None, type=float,
-              help='Pass threshold (0-1)')
+@click.option('--pass-threshold', 'evaluation_pass_threshold', default=None, type=click.IntRange(1, 100),
+              help='Pass threshold as a percentage, 1-100 (e.g. 80)')
 @click.option('--message-delay-ms', 'evaluation_message_delay_ms', default=None, type=int,
               help='Delay between messages during a run')
 @_connection_options

{primethink_cli-1.5.0 → primethink_cli-1.6.0}/primethink_agent_tools/tools.py

@@ -696,7 +696,7 @@ async def create_collection(
     config: RunnableConfig,
     name: Annotated[str, Field(description="Collection name")],
     description: Annotated[Optional[str], Field(description="Collection description")] = None,
-    collection_type: Annotated[Optional[str], Field(description="collection/skill/external_source (server default: collection)")] = None,
+    collection_type: Annotated[Optional[str], Field(description="collection/skill/external_source/db (server default: collection)")] = None,
     public: Annotated[Optional[bool], Field(description="Make the collection public (server default: private)")] = None,
 ) -> str:
     """Create a PrimeThink collection."""
@@ -722,7 +722,7 @@ async def update_collection(
     collection_id: Annotated[str, Field(description="Collection ID")],
     name: Annotated[Optional[str], Field(description="Collection name")] = None,
     description: Annotated[Optional[str], Field(description="Collection description")] = None,
-    collection_type: Annotated[Optional[str], Field(description="collection/skill/external_source")] = None,
+    collection_type: Annotated[Optional[str], Field(description="collection/skill/external_source/db")] = None,
     public: Annotated[Optional[bool], Field(description="Make the collection public")] = None,
     indexed: Annotated[Optional[bool], Field(description="Enable or disable indexing")] = None,
     ocr_instructions: Annotated[Optional[str], Field(description="OCR instructions for document processing")] = None,
@@ -1452,7 +1452,7 @@ async def set_task_evaluation_settings(
     evaluation_active: Annotated[Optional[bool], Field(description="Enable/disable evaluation")] = None,
     evaluation_run_time: Annotated[Optional[str], Field(description="manual/daily/weekly/monthly")] = None,
     default_evaluator_agent_id: Annotated[Optional[int], Field(description="Default grading agent")] = None,
-    evaluation_pass_threshold: Annotated[Optional[float], Field(description="Pass threshold (0-1)")] = None,
+    evaluation_pass_threshold: Annotated[Optional[int], Field(ge=1, le=100, description="Pass threshold as a percentage, 1-100 (e.g. 80)")] = None,
     evaluation_message_delay_ms: Annotated[Optional[int], Field(description="Delay between messages")] = None,
 ) -> str:
     """Update a task's evaluation settings (the plan configuration)."""