Update to Wordsmith

{
  "description": "Review a contract in Wordsmith against one of the organisation's playbooks or against checks built from the user's instructions, read the findings, and produce a tracked-changes redline. Use when the user asks to review, check or mark up a contract, NDA, agreement or other legal document with Wordsmith.",
  "included_files": [],
  "name": "contract-review",
  "skill_md_contents": "---\nname: contract-review\ndescription: Review a contract in Wordsmith against one of the organisation's playbooks or against checks built from the user's instructions, read the findings, and produce a tracked-changes redline. Use when the user asks to review, check or mark up a contract, NDA, agreement or other legal document with Wordsmith.\n---\n\n# Contract review with Wordsmith\n\nThis workflow takes a contract from the conversation to a reviewed set of findings and a Word redline. A\nreview runs in Wordsmith for a few minutes, so it starts and finishes in separate tool calls.\n\n## 1. Get the contract into Wordsmith\n\nEvery Wordsmith tool works on a Wordsmith file id.\n\n- **An attachment in the conversation, a public https link, or text:** call `add_file`. Set exactly one of\n  `file`, `url` or `text`. It returns the file's `id`.\n- **A file on the user's machine, when the host can run shell commands:** call `create_file_upload` with\n  `file_name`, `content_type` and `content_length`. Run the `curl_command` it returns, with `<path>`\n  replaced by the file's path. Then call `complete_file_upload` with the `upload_id` to get the file's `id`.\n\nA review accepts DOCX and PDF files, up to 10 reviewed together.\n\n## 2. Choose what to review against\n\n- **A playbook:** the organisation's saved positions for a contract type. Call\n  `find_resources` with `kind=\"playbook\"` and a `query` such as `\"NDA\"` to find its id.\n- **Instructions:** if no playbook fits, the review builds its checks from written instructions, such as\n  \"check the limitation of liability, governing law and termination for convenience\".\n\nNote which side the user acts for, as the document names it (for example \"the Supplier\"). The review\nreads the contract from that party's position.\n\n## 3. Start the review\n\nCall `review_document` with:\n\n- `type`: `\"playbook\"` with `playbook_id`, or `\"instructions\"` with `instructions`\n- `file_ids`: the ids from step 1\n- `party`: the side the user acts for\n\nThe call waits up to `wait_seconds` (at most 20). If the result has an `operation_id` and a running status,\ncall `get_operation` with it until the status is final. The finished result carries the `review_id`.\n\n## 4. Read the findings\n\nCall `get_review` with the `review_id`. It returns the review's status, its finding counts, the\n`redline_file_id` of the full redline, and a page of findings. Each finding has an explanation, the cited\ncontract text and any proposed amendment.\n\n- `finding_status` defaults to `\"issue\"`. Use `\"all\"` to include passed checks.\n- `severity` filters issues to `\"major\"`, `\"minor\"` or `\"info\"`, the words the Wordsmith app uses.\n- Pass the returned `cursor` to read the next page.\n\n## 5. Produce a redline\n\nThe review's own redline, with every proposed amendment, is the `redline_file_id` from `get_review`.\n\nFor a redline with only some amendments, call `update_review` with `action=\"generate_redline\"`, the\n`review_id` and the chosen `finding_ids`. It returns a new `file_id`: a tracked-changes DOCX, or a ZIP of\nDOCX files when the review covered several documents. If it returns an `operation_id`, finish it with\n`get_operation`.\n\nTo give the user the document, call `read_file` with the file id and `include=[\"download_url\"]`. The link\nworks without sign-in and expires after 5 minutes.\n\n## Example\n\nA user attaches a supplier's NDA and asks for a review against the company NDA playbook, acting for the\ncustomer:\n\n1. `add_file(file=<attachment>)` returns `id: \"f_123\"`.\n2. `find_resources(kind=\"playbook\", query=\"NDA\")` returns the playbook `pb_456`.\n3. `review_document(type=\"playbook\", playbook_id=\"pb_456\", file_ids=[\"f_123\"], party=\"the Customer\")`\n   returns an `operation_id`; `get_operation` returns `review_id: \"rv_789\"`.\n4. `get_review(review_id=\"rv_789\", severity=\"major\")` lists the major issues.\n5. `update_review(review_id=\"rv_789\", action=\"generate_redline\", finding_ids=[...])` returns the\n   redline's `file_id`.\n"
}