@zackbart/connecta 0.34.0 → 0.34.1

package/dist/providers/linear/index.js

@@ -26,246 +26,431 @@ const UPSERT = "An upsert: supplying a record id overwrites that record in place
  * caller gets and the verdict a check reads can never disagree. It is a
  * superset: Linear's hosted `tools/list` varies by plan and enabled features,
  * so a name this workspace never returns costs nothing, while an unlisted new
- * one fails closed. The genuine creates — the `create_*_label` and attachment
- * tools — are plain writes rather than destructive.
+ * one without an explicit read annotation fails closed. The genuine creates —
+ * the `create_*_label` and attachment tools — are plain writes rather than
+ * destructive.
  */
 const LINEAR_CLASSIFICATION = {
     tools: {
         // Issues
         list_issues: {
+            schemaDigest: "sha256:294b644db541de9f1f4cec011164fe7cec29153aa12d5d94d0748fe35fe973d4",
             "verdict": "read",
             "reason": "Reads existing Linear list issues data without changing workspace state.",
         },
         get_issue: {
+            schemaDigest: "sha256:33b204248ae63119751ed4cbade909b05cfbd9aa241cd39e4cec5690d062688e",
             "verdict": "read",
             "reason": "Reads existing Linear get issue data without changing workspace state.",
         },
         list_issue_statuses: {
+            schemaDigest: "sha256:8a740e800811796eab16dee1c22db5d8e3c971bebf3ccec7d7d2ee36157f4316",
             "verdict": "read",
             "reason": "Reads existing Linear list issue statuses data without changing workspace state.",
         },
         get_issue_status: {
+            schemaDigest: "sha256:ea4e287dc5fc9b930b790430ca02f221a75444d789a252d87aff838767ce4f05",
             "verdict": "read",
             "reason": "Reads existing Linear get issue status data without changing workspace state.",
         },
         list_issue_labels: {
+            schemaDigest: "sha256:5eb361d26464fcaef257499c150bf9cb9349308d03ef31c119e826752cbc998e",
             "verdict": "read",
             "reason": "Reads existing Linear list issue labels data without changing workspace state.",
         },
-        save_issue: { verdict: "destructive", reason: UPSERT },
+        save_issue: {
+            schemaDigest: "sha256:23a22fd38cd3234f3a112c460daf04779034e54e45ed00ca27232574f3d60547",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        save_issue_label: {
+            schemaDigest: "sha256:a39c5e1194b33f1a07139c6c2219a991a818f7027b26aef059959bc67248d528",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        retire_issue_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Retires an existing issue label or group, including child labels, so it cannot be applied to new records.",
+        },
+        restore_issue_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Restores an existing issue label or group and every child label, including children retired separately.",
+        },
         create_issue_label: {
+            schemaDigest: "sha256:92a9bbefc33410795f6c23ae609b1cb61d6168b36b5b60f4563090e468c7f53c",
             "verdict": "write",
             "reason": "Creates Linear state through create_issue_label; the reviewed operation only appends.",
         },
         // Projects
         list_projects: {
+            schemaDigest: "sha256:3cadc9d39d1372e89bf671ae44b88aee4d7bc0d23af24979e2401facedd0253f",
             "verdict": "read",
             "reason": "Reads existing Linear list projects data without changing workspace state.",
         },
         get_project: {
+            schemaDigest: "sha256:e752476aabfdf9d25b03a57f682f6fcb187b10d823a3c6371abe49f7dda8a6e0",
             "verdict": "read",
             "reason": "Reads existing Linear get project data without changing workspace state.",
         },
         list_project_labels: {
+            schemaDigest: "sha256:5eb361d26464fcaef257499c150bf9cb9349308d03ef31c119e826752cbc998e",
             "verdict": "read",
             "reason": "Reads existing Linear list project labels data without changing workspace state.",
         },
-        save_project: { verdict: "destructive", reason: UPSERT },
+        save_project: {
+            schemaDigest: "sha256:2531c09aba662f0793dad42fa43d32708fe68047479cf2c00b32f368e1014413",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        save_project_label: {
+            schemaDigest: "sha256:703b141f537e40c693fd6cf5e6fc8ba97359830f943e022f4b32414562e72719",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        retire_project_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Retires an existing project label or group, including child labels, so it cannot be applied to new records.",
+        },
+        restore_project_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Restores an existing project label or group and every child label, including children retired separately.",
+        },
         // Milestones
         list_milestones: {
+            schemaDigest: "sha256:97e2d99f903538f1a99d7aef71bb8215dc99279e4395310c14a1c5c67852444a",
             "verdict": "read",
             "reason": "Reads existing Linear list milestones data without changing workspace state.",
         },
         get_milestone: {
+            schemaDigest: "sha256:5631cd5fdcd020ad3b57ee65dc92ec32a8be0df06136a7bcb1a83e5fb333df71",
             "verdict": "read",
             "reason": "Reads existing Linear get milestone data without changing workspace state.",
         },
-        save_milestone: { verdict: "destructive", reason: UPSERT },
+        save_milestone: {
+            schemaDigest: "sha256:d55f3018b2e8693c950e71751a6769f056f85cc51f351c1df26674f45eda4974",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
         // Initiatives
         list_initiatives: {
+            schemaDigest: "sha256:7d4bf3b546207ae0e41e215dc1f115ae05c61125b3299335a290e42498a63704",
             "verdict": "read",
             "reason": "Reads existing Linear list initiatives data without changing workspace state.",
         },
         get_initiative: {
+            schemaDigest: "sha256:dda5376b85019b51df65b94ed0baed0bf2715d59567ff6169bbcf67c6794ba81",
             "verdict": "read",
             "reason": "Reads existing Linear get initiative data without changing workspace state.",
         },
         list_initiative_labels: {
+            schemaDigest: "sha256:8c844c2f031db6e3c2665dac47e3ea8b006330b4bcc6df4b6479055e57ee057d",
             "verdict": "read",
             "reason": "Reads existing Linear list initiative labels data without changing workspace state.",
         },
-        save_initiative: { verdict: "destructive", reason: UPSERT },
+        save_initiative: {
+            schemaDigest: "sha256:65a4b02ead7630b12db3d9811192fb2595b8a34c79e1146a19318d640bf8b104",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        save_initiative_label: {
+            schemaDigest: "sha256:23a42a87a9420428381a719b5a64d4514c5edd97bddb885517ade6306d36bbe0",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        retire_initiative_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Retires an existing initiative label or group, including child labels, so it cannot be applied to new records.",
+        },
+        restore_initiative_label: {
+            schemaDigest: "sha256:d9f254b2c134123d14a9b91ed0df063d45aa99d85f2ccdaf90ac57aa3c50a3de",
+            verdict: "destructive",
+            reason: "Restores an existing initiative label or group and every child label, including children retired separately.",
+        },
         create_initiative_label: {
+            schemaDigest: "sha256:442e098c4e81e46071f13f9359dd296acd1cb03eee0c71d68fc7a329cc503277",
             "verdict": "write",
             "reason": "Creates Linear state through create_initiative_label; the reviewed operation only appends.",
         },
+        // Saved views
+        list_custom_views: {
+            schemaDigest: "sha256:ec3cbc000f325d82c0b4949acf6995cf4c11d4b4084c84037ee5aa5801eea92d",
+            verdict: "read",
+            reason: "Lists accessible saved view metadata without changing views or their matching records.",
+        },
         // Cycles
         list_cycles: {
+            schemaDigest: "sha256:39d0ade50e1bbe3e68f366b12b9ce001d4ab39dda416e061cc670c402963237f",
             "verdict": "read",
             "reason": "Reads existing Linear list cycles data without changing workspace state.",
         },
         // Comments
         list_comments: {
+            schemaDigest: "sha256:cd004335be5c0e9dfcd7997be16527cbaaf1eafddfa1ff0c367d904fb4c7372b",
             "verdict": "read",
             "reason": "Reads existing Linear list comments data without changing workspace state.",
         },
-        save_comment: { verdict: "destructive", reason: UPSERT },
+        save_comment: {
+            schemaDigest: "sha256:795f5d486218ccfe5d2d3480d8624feecb0af92cbff80804c3030a994aa343aa",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
         delete_comment: {
+            schemaDigest: "sha256:2c78afdc6b2a0e16421b88ad51e84fcc86f64ae7b551eae01a2f3c8437ebbb2b",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through delete_comment.",
         },
         // Documents
         list_documents: {
+            schemaDigest: "sha256:0c34f1ad0045ed166a200790b80cc274357f8dd916bade75267ce17ad3a0cd70",
             "verdict": "read",
             "reason": "Reads existing Linear list documents data without changing workspace state.",
         },
         get_document: {
+            schemaDigest: "sha256:3cb4635f04b8a5b10b6973a579123b0ff38b9942a4e5c019140c94c67bd23c29",
             "verdict": "read",
             "reason": "Reads existing Linear get document data without changing workspace state.",
         },
-        save_document: { verdict: "destructive", reason: UPSERT },
+        save_document: {
+            schemaDigest: "sha256:a1022c0e1a427aca42a5032acc1fe798eb41a6b503a9b8f2b0b1842bcc42b77a",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        // Inbox
+        get_notifications: {
+            schemaDigest: "sha256:eae99e7b6395842bd0aa3008dc4b8b75c12be444bca1111f68352127db852750",
+            verdict: "read",
+            reason: "Lists the authenticated user's inbox notifications without marking or snoozing them.",
+        },
+        mark_notification: {
+            schemaDigest: "sha256:96190ee9b29c980c1df2bf741ec1eebc49eed9a87f6db74d89bfa87b800b7fac",
+            verdict: "write",
+            reason: "Changes read/unread or snooze state in the authenticated user's inbox; the reviewed operation removes no workspace record.",
+        },
         // Teams and users
         list_teams: {
+            schemaDigest: "sha256:35496fcc47293f7976a418f5babd99f063465c9b614606b1feb0ab13879a4048",
             "verdict": "read",
             "reason": "Reads existing Linear list teams data without changing workspace state.",
         },
-        get_team: { "verdict": "read", "reason": "Reads existing Linear get team data without changing workspace state." },
+        get_team: {
+            schemaDigest: "sha256:4e62e3954a183e2256921cd40450335d3fcd6b4ba52354854a4257efabebf256",
+            "verdict": "read",
+            "reason": "Reads existing Linear get team data without changing workspace state.",
+        },
         list_users: {
+            schemaDigest: "sha256:2ce638c3be81ff50ac7a4f2c929cce39a62a011aad006ba9a26569a45ad095e5",
             "verdict": "read",
             "reason": "Reads existing Linear list users data without changing workspace state.",
         },
-        get_user: { "verdict": "read", "reason": "Reads existing Linear get user data without changing workspace state." },
+        get_user: {
+            schemaDigest: "sha256:5046c1d7d44be9142585a2fbd71785fb6f5832b99d723763251913e1a4ccc6f9",
+            "verdict": "read",
+            "reason": "Reads existing Linear get user data without changing workspace state.",
+        },
         get_workspace: {
+            schemaDigest: "sha256:caa1215d2278f303733e5fcb008a09853e2bc0e4d5545416a1f40eb4e3ba29fe",
             "verdict": "read",
             "reason": "Reads existing Linear get workspace data without changing workspace state.",
         },
+        get_triage_responsibility: {
+            schemaDigest: "sha256:8ee4f3c9799a763001089d1a56691020fac5bf9866b80bdbc21495702051737b",
+            verdict: "read",
+            reason: "Reads a team's current triage responsibility and upcoming rotation shifts without changing assignments.",
+        },
         // Templates
         list_templates: {
+            schemaDigest: "sha256:387aea405fd7d1ebd9b44228865f55dcc03cdbf1ff82dfe6a6766994177b3531",
             "verdict": "read",
             "reason": "Reads existing Linear list templates data without changing workspace state.",
         },
         get_template: {
+            schemaDigest: "sha256:b5feb94b620c9466a87c0feb232e19223e73abb1965579208c1aa47e6ef2b082",
             "verdict": "read",
             "reason": "Reads existing Linear get template data without changing workspace state.",
         },
         // Status updates
         get_status_updates: {
+            schemaDigest: "sha256:af40904370cffcca265f1a05bff133d561c7009f6960a84096025cf8163663f3",
             "verdict": "read",
             "reason": "Reads existing Linear get status updates data without changing workspace state.",
         },
-        save_status_update: { verdict: "destructive", reason: UPSERT },
+        save_status_update: {
+            schemaDigest: "sha256:5078fdc9f3ea4ee104d05def28e45949083d4f2ff6f2435bd6b856abccbece75",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
         delete_status_update: {
+            schemaDigest: "sha256:5e4e4cdac2d818bdc2a572947a11a28b251797e59affea97aa3b853f5439bf7f",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through delete_status_update.",
         },
         // Releases
         list_release_pipelines: {
+            schemaDigest: "sha256:7a20220ffbd895f834a0bd85ab6a444fbe7d71ee5b1d5dcbf8c109c7451984e0",
             "verdict": "read",
             "reason": "Reads existing Linear list release pipelines data without changing workspace state.",
         },
         list_releases: {
+            schemaDigest: "sha256:c9c6fa51eb980c3304a37f64e2a73f6e2e03e252330fcdb4ab9fc2e995c949cc",
             "verdict": "read",
             "reason": "Reads existing Linear list releases data without changing workspace state.",
         },
         get_release: {
+            schemaDigest: "sha256:6adeb4b4a0cb4888cfb45bf0a0d047f6de516dc05b7067912f5ba77025155fdb",
             "verdict": "read",
             "reason": "Reads existing Linear get release data without changing workspace state.",
         },
         list_release_notes: {
+            schemaDigest: "sha256:b0f1da15034143f29d44d949ea08bdfec2509ef196175a7a8ee5db11b655b06a",
             "verdict": "read",
             "reason": "Reads existing Linear list release notes data without changing workspace state.",
         },
         get_release_note: {
+            schemaDigest: "sha256:d28c0187ad65bca21b32451f8ab1d4a1c1a26efb485b9d4395e9b3d41555f532",
             "verdict": "read",
             "reason": "Reads existing Linear get release note data without changing workspace state.",
         },
-        save_release: { verdict: "destructive", reason: UPSERT },
-        save_release_note: { verdict: "destructive", reason: UPSERT },
+        save_release: {
+            schemaDigest: "sha256:97db7fa9246750a0533d07ed73d633fadc3fe2f27f2bf95deb6ea86bbcb2bc4b",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
+        save_release_note: {
+            schemaDigest: "sha256:933c46faa3bb1edb4e9cc89299ab7dbcdaafab4bee6615aa43d538703fe4dab7",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
         // Code review
         list_diffs: {
+            schemaDigest: "sha256:1eccf293d83cd2d962e6f840cd42dac43eaee1a15cbf7ea6b78bd6b55fe94313",
             "verdict": "read",
             "reason": "Reads existing Linear list diffs data without changing workspace state.",
         },
-        get_diff: { "verdict": "read", "reason": "Reads existing Linear get diff data without changing workspace state." },
+        get_diff: {
+            schemaDigest: "sha256:692aaf3e4a1adb0b82e38bf01574b6615747f48619e295f0377255cf2fd3dbaa",
+            "verdict": "read",
+            "reason": "Reads existing Linear get diff data without changing workspace state.",
+        },
         get_diff_threads: {
+            schemaDigest: "sha256:98b66ecda18665bf883e70169c472802105fc113c0f39d3e25da76824b3e3457",
             "verdict": "read",
             "reason": "Reads existing Linear get diff threads data without changing workspace state.",
         },
-        save_diff_comment: { verdict: "destructive", reason: UPSERT },
+        save_diff_comment: {
+            schemaDigest: "sha256:29a06cce756a5f3a6987693129a260659cad50083f7400723fb0b8bc9dd2b8bb",
+            verdict: "destructive",
+            reason: UPSERT,
+        },
         resolve_diff_thread: {
+            schemaDigest: "sha256:e493a5e74c1fd7e7bf104dbed8032c721c15209991aa12686c7f46b82a49ab2e",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through resolve_diff_thread.",
         },
         delete_diff_comment: {
+            schemaDigest: "sha256:88db600198790b6c99b6e9397d26649f49d48b0deaa758dc64e6f8b516d817c7",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through delete_diff_comment.",
         },
         submit_diff_review: {
+            schemaDigest: "sha256:97aa13f00d23db8d16191104dae0ddd2a3dd1c047415bf770474be0180320acf",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through submit_diff_review.",
         },
-        merge_diff: { "verdict": "destructive", "reason": "Changes or removes existing Linear state through merge_diff." },
+        update_diff: {
+            schemaDigest: "sha256:8e5b77961d3d344b99a68cb82901d3764f6fb4c700f42c3c2fc59ea12a490f27",
+            verdict: "destructive",
+            reason: "Changes an existing diff's metadata, review requests, issue links or status; combined updates can partially succeed.",
+        },
+        merge_diff: {
+            schemaDigest: "sha256:e809bf0416c3cfb99794448eb66f69f83bbd7a451604faec7f622f47025f17fc",
+            "verdict": "destructive",
+            "reason": "Changes or removes existing Linear state through merge_diff.",
+        },
         // Attachments
         get_attachment: {
+            schemaDigest: "sha256:158ac0e0add99d9a9109a4f3549266be8f2d1eb5fa0832c861a4c56c20708a3b",
             "verdict": "read",
             "reason": "Reads existing Linear get attachment data without changing workspace state.",
         },
         prepare_attachment_upload: {
+            schemaDigest: "sha256:641559612992b1f6c1cd69fec3c66b898c12d2a21bc58973589be81fc2612c9c",
             verdict: "write",
             reason: "Mints an upload URL: a side effect, but it changes no existing record.",
         },
         create_attachment_from_upload: {
+            schemaDigest: "sha256:10818ba9327b9b70816512fd557ed3b4b85776f47cf8ca498f0d3ba17953dc2a",
             "verdict": "write",
             "reason": "Creates Linear state through create_attachment_from_upload; the reviewed operation only appends.",
         },
         create_attachment: {
+            schemaDigest: "sha256:0a4e4d5f6b62b5fbfd52d466d8b3167005e3574f3d00cf92e2fbfbbe769d8a1e",
             "verdict": "write",
             "reason": "Creates Linear state through create_attachment; the reviewed operation only appends.",
         },
         delete_attachment: {
+            schemaDigest: "sha256:ef21d1c1a7d09827b3c44bdefe18fc2dec28af468d19d2060f97df0a0f76bd0e",
             "verdict": "destructive",
             "reason": "Changes or removes existing Linear state through delete_attachment.",
         },
         // Explicit issue access.
         share_issue: {
+            schemaDigest: "sha256:f41410b4cf5effc62a03ad26bcf76ba792a1f7bea52a78da9183b5279b4a0433",
             verdict: "destructive",
             reason: "Changes who can see an existing issue.",
         },
         unshare_issue: {
+            schemaDigest: "sha256:f41410b4cf5effc62a03ad26bcf76ba792a1f7bea52a78da9183b5279b4a0433",
             verdict: "destructive",
             reason: "Changes who can see an existing issue.",
         },
         // Agent skills
         list_agent_skills: {
+            schemaDigest: "sha256:38fc34a53e932314e0bf6abc6493bca1256d37a951befceb95c1fe13bfa46ebd",
             "verdict": "read",
             "reason": "Reads existing Linear list agent skills data without changing workspace state.",
         },
         get_agent_skill: {
+            schemaDigest: "sha256:deb4296f3f7612ffb1af1e6ec75976acdc04ba12aff6c129a92b5a87e7a9ee09",
             "verdict": "read",
             "reason": "Reads existing Linear get agent skill data without changing workspace state.",
         },
         // Documentation search
         search_documentation: {
+            schemaDigest: "sha256:c2b89b06275e7b0cb63b73af749ae88b694446066058584e65c9208e33339efa",
             "verdict": "read",
             "reason": "Reads existing Linear search documentation data without changing workspace state.",
         },
         // Customer requests (plan-gated)
         list_customers: {
             "verdict": "read",
+            optional: true,
             "reason": "Reads existing Linear list customers data without changing workspace state.",
         },
-        save_customer: { verdict: "destructive", reason: UPSERT },
+        list_customer_needs: {
+            verdict: "read",
+            optional: true,
+            reason: "Lists customer requests for an issue, project or initiative; announced in Linear's 2026-10-08 changelog and plan-gated in hosted catalogs.",
+        },
+        save_customer: { verdict: "destructive", optional: true, reason: UPSERT },
         delete_customer: {
             "verdict": "destructive",
+            optional: true,
             "reason": "Changes or removes existing Linear state through delete_customer.",
         },
-        save_customer_need: { verdict: "destructive", reason: UPSERT },
+        save_customer_need: { verdict: "destructive", optional: true, reason: UPSERT },
         delete_customer_need: {
             "verdict": "destructive",
+            optional: true,
             "reason": "Changes or removes existing Linear state through delete_customer_need.",
         },
         // Markdown helper.
         extract_images: {
+            schemaDigest: "sha256:1d7273f64621448fd901fb4ac94ee3b29a4c4a833f0b27083775bd685f8a401c",
             verdict: "read",
             reason: "Reads images out of content it is handed and touches no workspace state; the hosted server ships it annotated readOnlyHint: true and idempotentHint: true.",
         },
@@ -302,7 +487,7 @@ export const linear = defineProvider({
         // the summary without the description.
         const accessNote = access === "read-only"
             ? "Read-only connection: bound to Linear's read-only endpoint, whose token is scope-limited downstream, so every write fails at Linear regardless of arguments. Route writes to a connector configured for read-write access."
-            : "Read-write connection: treat every `save_`, `create_`, `delete_`, `resolve_`, `submit_`, and `merge_` operation as a write. Connecta classifies the maintained writes explicitly, and a read-only endpoint refuses them. Unknown tools without an explicit, uncontradicted read annotation fail closed.";
+            : "Read-write connection: treat every `save_`, `create_`, `delete_`, `retire_`, `restore_`, `mark_`, `update_`, `resolve_`, `submit_`, `share_`, `unshare_`, `prepare_`, and `merge_` operation as a write. Connecta classifies the maintained writes explicitly, and a read-only endpoint refuses them. Unknown tools without an explicit, uncontradicted read annotation fail closed.";
         return remoteMcp(id, {
             url: LINEAR_MCP_ENDPOINTS[access],
             ...provider.connectorOptions,

package/dist/providers/linear/skill.generated.js

@@ -1,8 +1,8 @@
 // Generated by scripts/generate-providers.mjs; do not edit.
 export const skill = {
-    "content": "- Issue arguments use `state`, not `status`. Resolve team-specific states through `list_issue_statuses` and use the value format required by the live input schema.\n- Resolve identity before acting. `list_teams`, `list_users`, `list_projects`, `list_issue_statuses`, and `list_issue_labels` return the ids that create and update arguments expect; do not guess a team, status, label, or assignee id.\n- Issues carry a human identifier like `ENG-123` — team key, dash, number — alongside a UUID. Use the identifier the request gave you and resolve it with `get_issue` or `list_issues` when a tool wants an id; never fabricate an identifier or renumber one.\n- `save_*` tools are upserts: omit the record id to create, supply it to update in place. Read the record first when you mean to update, and send only the fields you intend to change — an upsert overwrites what you restate.\n- Labels are the exception to that naming: `create_issue_label` and `create_initiative_label` only ever create.\n- Projects, milestones, and initiatives nest: initiatives contain projects, projects contain milestones and issues, and cycles are per-team time boxes. Scope a search by team or project rather than listing the workspace and filtering afterwards.\n- List tools paginate with a cursor. Thread the returned cursor for the next page instead of raising the page size, and reduce pages inside `execute_code` before returning them.\n- This workspace's catalog is not the whole product. Customer requests, releases, and code review are plan- and feature-gated, so search the catalog for what this connector actually exposes rather than assuming a tool exists.\n- Linear meters the underlying API per user per hour, shared with everything else that credential does. Reuse discovery results within a run and avoid speculative fan-out.\n- An `auth_required` failure means this connector's Linear authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged.",
+    "content": "- Issue arguments use `state`, not `status`. Resolve team-specific states through `list_issue_statuses` and use the value format required by the live input schema.\n- Resolve identity before acting. `list_teams`, `list_users`, `list_projects`, `list_issue_statuses`, and `list_issue_labels` return the ids that create and update arguments expect; do not guess a team, status, label, or assignee id.\n- Issues carry a human identifier like `ENG-123` — team key, dash, number — alongside a UUID. Use the identifier the request gave you and resolve it with `get_issue` or `list_issues` when a tool wants an id; never fabricate an identifier or renumber one.\n- `save_*` tools are upserts: omit the record id to create, supply it to update in place. Read the record first when you mean to update, and send only the fields you intend to change — an upsert overwrites what you restate.\n- Prefer `save_issue_label`, `save_project_label`, and `save_initiative_label` for label upserts. The deprecated `create_issue_label` and `create_initiative_label` remain create-only writes. Resolve existing labels with the corresponding `list_*_labels`; when updating issue or project labels, `teamId` disambiguates a name and cannot move the label to another team.\n- `retire_*_label` prevents new uses while preserving labels on existing records. Retiring a group retires its children; restoring a group restores every child, including children retired separately. Check the group and child scope before either lifecycle write.\n- `get_notifications` only reads the authenticated user's inbox. `mark_notification` writes read/unread or snooze state; resolve notification ids from that inbox before marking.\n- Read `get_diff` before `update_diff` and send only intended changes. Combined updates can partially succeed: inspect the result and reread before deciding whether any remaining change needs another call; never blindly replay the whole write. Use `merge_diff` to merge and `submit_diff_review` to approve or request changes.\n- Projects, milestones, and initiatives nest: initiatives contain projects, projects contain milestones and issues, and cycles are per-team time boxes. Scope a search by team or project rather than listing the workspace and filtering afterwards.\n- List tools paginate with a cursor. Thread the returned cursor for the next page instead of raising the page size, and reduce pages inside `execute_code` before returning them.\n- This workspace's catalog is not the whole product. Customer requests, releases, and code review are plan- and feature-gated, so search the catalog for what this connector actually exposes rather than assuming a tool exists.\n- Linear meters the underlying API per user per hour, shared with everything else that credential does. Reuse discovery results within a run and avoid speculative fan-out.\n- An `auth_required` failure means this connector's Linear authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged.",
     "instructionsHeading": "Workspace instructions",
     "fragments": {
-        "content": "- Issue arguments use `state`, not `status`. Resolve team-specific states through `list_issue_statuses` and use the value format required by the live input schema.\n- Resolve identity before acting. `list_teams`, `list_users`, `list_projects`, `list_issue_statuses`, and `list_issue_labels` return the ids that create and update arguments expect; do not guess a team, status, label, or assignee id.\n- Issues carry a human identifier like `ENG-123` — team key, dash, number — alongside a UUID. Use the identifier the request gave you and resolve it with `get_issue` or `list_issues` when a tool wants an id; never fabricate an identifier or renumber one.\n- `save_*` tools are upserts: omit the record id to create, supply it to update in place. Read the record first when you mean to update, and send only the fields you intend to change — an upsert overwrites what you restate.\n- Labels are the exception to that naming: `create_issue_label` and `create_initiative_label` only ever create.\n- Projects, milestones, and initiatives nest: initiatives contain projects, projects contain milestones and issues, and cycles are per-team time boxes. Scope a search by team or project rather than listing the workspace and filtering afterwards.\n- List tools paginate with a cursor. Thread the returned cursor for the next page instead of raising the page size, and reduce pages inside `execute_code` before returning them.\n- This workspace's catalog is not the whole product. Customer requests, releases, and code review are plan- and feature-gated, so search the catalog for what this connector actually exposes rather than assuming a tool exists.\n- Linear meters the underlying API per user per hour, shared with everything else that credential does. Reuse discovery results within a run and avoid speculative fan-out.\n- An `auth_required` failure means this connector's Linear authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged."
+        "content": "- Issue arguments use `state`, not `status`. Resolve team-specific states through `list_issue_statuses` and use the value format required by the live input schema.\n- Resolve identity before acting. `list_teams`, `list_users`, `list_projects`, `list_issue_statuses`, and `list_issue_labels` return the ids that create and update arguments expect; do not guess a team, status, label, or assignee id.\n- Issues carry a human identifier like `ENG-123` — team key, dash, number — alongside a UUID. Use the identifier the request gave you and resolve it with `get_issue` or `list_issues` when a tool wants an id; never fabricate an identifier or renumber one.\n- `save_*` tools are upserts: omit the record id to create, supply it to update in place. Read the record first when you mean to update, and send only the fields you intend to change — an upsert overwrites what you restate.\n- Prefer `save_issue_label`, `save_project_label`, and `save_initiative_label` for label upserts. The deprecated `create_issue_label` and `create_initiative_label` remain create-only writes. Resolve existing labels with the corresponding `list_*_labels`; when updating issue or project labels, `teamId` disambiguates a name and cannot move the label to another team.\n- `retire_*_label` prevents new uses while preserving labels on existing records. Retiring a group retires its children; restoring a group restores every child, including children retired separately. Check the group and child scope before either lifecycle write.\n- `get_notifications` only reads the authenticated user's inbox. `mark_notification` writes read/unread or snooze state; resolve notification ids from that inbox before marking.\n- Read `get_diff` before `update_diff` and send only intended changes. Combined updates can partially succeed: inspect the result and reread before deciding whether any remaining change needs another call; never blindly replay the whole write. Use `merge_diff` to merge and `submit_diff_review` to approve or request changes.\n- Projects, milestones, and initiatives nest: initiatives contain projects, projects contain milestones and issues, and cycles are per-team time boxes. Scope a search by team or project rather than listing the workspace and filtering afterwards.\n- List tools paginate with a cursor. Thread the returned cursor for the next page instead of raising the page size, and reduce pages inside `execute_code` before returning them.\n- This workspace's catalog is not the whole product. Customer requests, releases, and code review are plan- and feature-gated, so search the catalog for what this connector actually exposes rather than assuming a tool exists.\n- Linear meters the underlying API per user per hour, shared with everything else that credential does. Reuse discovery results within a run and avoid speculative fan-out.\n- An `auth_required` failure means this connector's Linear authorization is missing or expired: run `authorize_connector` for this connector id, then retry the same call unchanged."
     }
 };

package/dist/providers/mixpanel/index.d.ts

@@ -22,6 +22,8 @@ interface MixpanelCommonOptions {
     instructions?: string;
     /** Connector-specific inline result limit; omit to inherit the deployment. */
     maxResultBytes?: number;
+    /** Serve only read-classified tools on every endpoint. Defaults to false. */
+    readOnly?: boolean;
     /**
      * Optional per-runtime policy. API mode defaults to 60 calls/hour and five
      * concurrent calls across all tools and projects. MCP mode has no default:

package/dist/providers/mixpanel/index.js

@@ -12,10 +12,10 @@ export const MIXPANEL_MCP_ENDPOINTS = {
     in: "https://mcp-in.mixpanel.com/mcp",
 };
 /**
- * Reviewed in #705's provider audit against https://docs.mixpanel.com/docs/mcp.
- * Retains the release-reviewed inventory, including names absent from today's
- * public reference. Live annotations were not reverified without credentials.
- * Schema digests retain the 2026-08-30 live US review (#395, #512).
+ * Reviewed against https://docs.mixpanel.com/docs/mcp and the 2026-10-19 live
+ * US describe schemas (#343, #703). Eleven of the 64 previously pinned tools
+ * changed since the 2026-08-30 review (#395, #512); unchanged pins are retained.
+ * Get-Audit-Log is documented beta-only: no live schema digest is claimed.
  */
 const MIXPANEL_CLASSIFICATION = {
     tools: {
@@ -47,7 +47,7 @@ const MIXPANEL_CLASSIFICATION = {
         "Get-Dashboard": {
             "verdict": "read",
             "reason": "Retrieves Mixpanel dashboard information without changing vendor state.",
-            "schemaDigest": "sha256:56659fa3277723b75e24f3b4ca142ac9cd62120fb97e6c9252c221d00cdf8509",
+            "schemaDigest": "sha256:0af78ab95566a20eeba08af6922f2017d98503e2b14dcbe8d7e2ac54eef870d7",
         },
         "Get-Business-Context": {
             "verdict": "read",
@@ -64,10 +64,14 @@ const MIXPANEL_CLASSIFICATION = {
             "reason": "Retrieves Mixpanel organizations information without changing vendor state.",
             "schemaDigest": "sha256:e4c23f123dde073e00038d92ebd53f45157c83a4d3a2ff686ab1b66c859f4a11",
         },
+        "Get-Audit-Log": {
+            "verdict": "read",
+            "reason": "Queries existing organization audit history; limited-access beta requiring organization admin or owner access.",
+        },
         "Get-Events": {
             "verdict": "read",
             "reason": "Retrieves Mixpanel events information without changing vendor state.",
-            "schemaDigest": "sha256:d206fe30ab47d64bf6090bffdb4d119a80cfc2a35963bbe7fd52d56060090ded",
+            "schemaDigest": "sha256:09d7874b0c60cf790944b8998ee943f200912eac4349dfa80d0f2ae82a7a7998",
         },
         "List-Properties": {
             "verdict": "read",
@@ -112,7 +116,7 @@ const MIXPANEL_CLASSIFICATION = {
         "List-Cohorts": {
             "verdict": "read",
             "reason": "Retrieves Mixpanel cohorts information without changing vendor state.",
-            "schemaDigest": "sha256:fd04778d60a027cfd777b40f36fbb037ba070661e149b2fce35a14865cada2db",
+            "schemaDigest": "sha256:505ff07f668186b670bcce28aa339076140b85896eb4f64afad78d963018297a",
         },
         "Describe-Cohort-Schema": {
             "verdict": "read",
@@ -127,7 +131,7 @@ const MIXPANEL_CLASSIFICATION = {
         "Get-Metric": {
             "verdict": "read",
             "reason": "Retrieves Mixpanel metric information without changing vendor state.",
-            "schemaDigest": "sha256:eef10dd9ca25a63a63775565cbc4f2261b289dec526aa33df0f318eefbc96c46",
+            "schemaDigest": "sha256:451e867abd1162f25bec96f76cb1b1d1d84eb33c04fe4d804e729810d93d26d7",
         },
         "List-Metrics": {
             "verdict": "read",
@@ -145,9 +149,9 @@ const MIXPANEL_CLASSIFICATION = {
             "schemaDigest": "sha256:26a3f3e0b4e52135d74335dd769103303071fc48c15b1df40efd2dfa5a353848",
         },
         "Get-Experiment": {
-            "verdict": "read",
-            "reason": "Retrieves Mixpanel experiment information without changing vendor state.",
-            "schemaDigest": "sha256:ab685aa985aa2ec36d9cbeb1b3c1ef298b020e552e8fdce12e75abbeb4706f2b",
+            "verdict": "destructive",
+            "reason": "Optional compute flags persist refreshed result caches and may auto-conclude an experiment; the full tool can modify existing state.",
+            "schemaDigest": "sha256:aebe329b5c5f3a9a465d40f12af1d6336d1304cc949c291eea752a5dd532e6fa",
         },
         "Get-Experiment-Setup-Guidance": {
             "verdict": "read",
@@ -197,12 +201,12 @@ const MIXPANEL_CLASSIFICATION = {
         "Create-Dashboard": {
             "verdict": "write",
             "reason": "Create Dashboard creates or appends Mixpanel state; it has side effects.",
-            "schemaDigest": "sha256:bd3b6e5134d27dafb04ccdf04d19e54dd23e6e2dc16989e418006e484268037b",
+            "schemaDigest": "sha256:59fbe58cc8b69b31adfa7015e541d495abc566f56b1320e10ad77288ff9facf0",
         },
         "Update-Dashboard": {
             "verdict": "destructive",
             "reason": "Update Dashboard changes existing Mixpanel state or removes it.",
-            "schemaDigest": "sha256:2cc179ba75eda476ba7488f01503d947f023a4460aa98c4806ef0ab10c3b3ce8",
+            "schemaDigest": "sha256:6f2f11e94a13667848bdcb30531a7ff478a8c53460a5e0859f8241b64d0008da",
         },
         "Duplicate-Dashboard": {
             "verdict": "write",
@@ -307,22 +311,22 @@ const MIXPANEL_CLASSIFICATION = {
         "Create-Metric": {
             "verdict": "write",
             "reason": "Create Metric creates or appends Mixpanel state; it has side effects.",
-            "schemaDigest": "sha256:315766d0c197d87bb44aedd16732f6e69fbfc93661d1fcfc177cadc1751f26ce",
+            "schemaDigest": "sha256:c10bc660e0664a9aba6450a45b50fb1fbea6a4fac809fd5390616416f72e04d6",
         },
         "Update-Metric": {
             "verdict": "destructive",
             "reason": "Update Metric changes existing Mixpanel state or removes it.",
-            "schemaDigest": "sha256:739bb6abdab19282afd4a6644a96183daabe9098a5322c44a77b840608a5ee9d",
+            "schemaDigest": "sha256:ca03823ea995d0ae53807a60b1dd0d47f1667b28cfd24cdab52a9fc66f0c2834",
         },
         "Create-Experiment": {
             "verdict": "write",
             "reason": "Create Experiment creates or appends Mixpanel state; it has side effects.",
-            "schemaDigest": "sha256:1cfc2edeb2ac2d329a531d2095671a0653ab5b94b9e233b34268ff29a48c5ac5",
+            "schemaDigest": "sha256:ce64eafec7f2490fa3c76030c75340bf5dd282a9d0bfb0c5353bcdc3b50f602d",
         },
         "Update-Experiment": {
             "verdict": "destructive",
             "reason": "Update Experiment changes existing Mixpanel state or removes it.",
-            "schemaDigest": "sha256:3ea3902555c146f45127fc563b36ffb7ff04b7594765dac9ae98cc09dc432808",
+            "schemaDigest": "sha256:27c0e2b58fbb1468dda938c4112560e9481f58bc4ddafd4a94bad56666c5b12c",
         },
         "Create-Feature-Flag": {
             "verdict": "write",