Skip to main content
Glama

Manage a workspace

workspace
Destructive

Manage a workspace overlay. action = create | update. Hosted MCP is stateless, so checkout-local activate/deactivate actions are not exposed; promoting or archiving a workspace lives in the destructive tool.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
dataYesThe action-specific result returned by Stele.
actionYesThe action that produced this result.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / $schema
      Previous value: -"https://json-schema.org/draft/2020-12/schema"New value: +"http://json-schema.org/draft-07/schema#"
    • changedOutput schema / properties / data / additionalProperties
      Previous value: -{}New value: +true
  2. Changed2 schema fields changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "workspace action \"create\".",
      -    "properties": {
      -      "action": {
      -        "const": "create",
      -        "description": "Run the create action.",
      -        "type": "string"
      -      },
      -      "auto_activate_hint": {
      -        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      -        "type": "string"
      -      },
      -      "branches": {
      -        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "description": {
      -        "description": "(create/update only) One-line description of what this overlay is for.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "workspace action \"update\".",
      -    "properties": {
      -      "action": {
      -        "const": "update",
      -        "description": "Run the update action.",
      -        "type": "string"
      -      },
      -      "add_branches": {
      -        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "auto_activate_hint": {
      -        "description": "New plain-language auto-activation hint.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "New one-line description.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Change the workspace kind.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "New name.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "workspace": {
      -        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "workspace"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"create\".",
      +    "properties": {
      +      "action": {
      +        "const": "create",
      +        "description": "Run the create action.",
      +        "type": "string"
      +      },
      +      "auto_activate_hint": {
      +        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      +        "type": "string"
      +      },
      +      "branches": {
      +        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "description": {
      +        "description": "(create/update only) One-line description of what this overlay is for.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "members": {
      +        "description": "(create only, private) Other project members to add, as @handles or emails. The creator is always a member.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "name": {
      +        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "visibility": {
      +        "description": "(create/update) 'private' = only the workspace's members can read it; other project members cannot. Use 'private' ONLY when the user asked for a private workspace. Never choose it on their behalf. Default 'project'.",
      +        "enum": [
      +          "project",
      +          "private"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"update\".",
      +    "properties": {
      +      "action": {
      +        "const": "update",
      +        "description": "Run the update action.",
      +        "type": "string"
      +      },
      +      "add_branches": {
      +        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "auto_activate_hint": {
      +        "description": "New plain-language auto-activation hint.",
      +        "type": "string"
      +      },
      +      "confirm_public": {
      +        "description": "(update to project-visible, merge/cherry-pick of a PRIVATE workspace) Must be true; set it only after the user agreed to publish the items to the project.",
      +        "type": "boolean"
      +      },
      +      "description": {
      +        "description": "New one-line description.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Change the workspace kind.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "New name.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "visibility": {
      +        "description": "(update only) Make the workspace private or project-visible. Making it private hides its notes from everyone not added; making it project-visible shows them to the whole project and needs confirm_public: true. Both are the user's decision.",
      +        "enum": [
      +          "project",
      +          "private"
      +        ],
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"members\".",
      +    "properties": {
      +      "action": {
      +        "const": "members",
      +        "description": "Run the members action.",
      +        "type": "string"
      +      },
      +      "add": {
      +        "description": "(members only) Project members to add, as @handles or emails. Only a workspace owner can add. Add only the people the user named.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "remove": {
      +        "description": "(members only) Members to remove, as @handles or emails. An owner removes anyone; anyone may remove themselves. The last owner cannot leave.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "role": {
      +        "description": "(members only) Role for the people in `add`. Default member.",
      +        "enum": [
      +          "owner",
      +          "member"
      +        ],
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for members — the private workspace, by NAME or uuid.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"create_personal\".",
      +    "properties": {
      +      "action": {
      +        "const": "create_personal",
      +        "description": "Run the create_personal action.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "(create_personal only) One line on what you keep there.",
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / properties / action / enum
      Previous value: -[
      -  "create",
      -  "update"
      -]New value: +[
      +  "create",
      +  "update",
      +  "members",
      +  "create_personal"
      +]
  3. Changed2 schema fields changed
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedOutput schema / properties / data / additionalProperties
      Previous value: -trueNew value: +{}
  4. Changed1 schema field changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      -    "properties": {
      -      "action": {
      -        "const": "create",
      -        "type": "string"
      -      },
      -      "auto_activate_hint": {
      -        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      -        "type": "string"
      -      },
      -      "branches": {
      -        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "description": {
      -        "description": "(create/update only) One-line description of what this overlay is for.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      -    "properties": {
      -      "action": {
      -        "const": "update",
      -        "type": "string"
      -      },
      -      "add_branches": {
      -        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "auto_activate_hint": {
      -        "description": "New plain-language auto-activation hint.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "New one-line description.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Change the workspace kind.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "New name.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "workspace": {
      -        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "workspace"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"create\".",
      +    "properties": {
      +      "action": {
      +        "const": "create",
      +        "description": "Run the create action.",
      +        "type": "string"
      +      },
      +      "auto_activate_hint": {
      +        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      +        "type": "string"
      +      },
      +      "branches": {
      +        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "description": {
      +        "description": "(create/update only) One-line description of what this overlay is for.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "workspace action \"update\".",
      +    "properties": {
      +      "action": {
      +        "const": "update",
      +        "description": "Run the update action.",
      +        "type": "string"
      +      },
      +      "add_branches": {
      +        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "auto_activate_hint": {
      +        "description": "New plain-language auto-activation hint.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "New one-line description.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Change the workspace kind.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "New name.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed1 schema field changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      -    "properties": {
      -      "action": {
      -        "const": "create",
      -        "type": "string"
      -      },
      -      "auto_activate_hint": {
      -        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      -        "type": "string"
      -      },
      -      "branches": {
      -        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "description": {
      -        "description": "(create/update only) One-line description of what this overlay is for.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag on a public project. Only meaningful after a flag; the user decides whether the content can be public.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      -    "properties": {
      -      "action": {
      -        "const": "update",
      -        "type": "string"
      -      },
      -      "add_branches": {
      -        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "auto_activate_hint": {
      -        "description": "New plain-language auto-activation hint.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "New one-line description.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Change the workspace kind.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "New name.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "privacy_bypass": {
      -        "description": "true writes despite a privacy flag on a public project. Only meaningful after a flag; the user decides whether the content can be public.",
      -        "type": "boolean"
      -      },
      -      "privacy_false_positive": {
      -        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      -        "type": "boolean"
      -      },
      -      "privacy_judgement_id": {
      -        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      -        "type": "string"
      -      },
      -      "privacy_note": {
      -        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "workspace": {
      -        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "workspace"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      +    "properties": {
      +      "action": {
      +        "const": "create",
      +        "type": "string"
      +      },
      +      "auto_activate_hint": {
      +        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      +        "type": "string"
      +      },
      +      "branches": {
      +        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "description": {
      +        "description": "(create/update only) One-line description of what this overlay is for.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      +    "properties": {
      +      "action": {
      +        "const": "update",
      +        "type": "string"
      +      },
      +      "add_branches": {
      +        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "auto_activate_hint": {
      +        "description": "New plain-language auto-activation hint.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "New one-line description.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Change the workspace kind.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "New name.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag. Only meaningful after a flag; the user decides whether the content can be written.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed1 schema field changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      -    "properties": {
      -      "action": {
      -        "const": "create",
      -        "type": "string"
      -      },
      -      "auto_activate_hint": {
      -        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      -        "type": "string"
      -      },
      -      "branches": {
      -        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "description": {
      -        "description": "(create/update only) One-line description of what this overlay is for.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      -    "properties": {
      -      "action": {
      -        "const": "update",
      -        "type": "string"
      -      },
      -      "add_branches": {
      -        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "auto_activate_hint": {
      -        "description": "New plain-language auto-activation hint.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "New one-line description.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Change the workspace kind.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "New name.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "workspace": {
      -        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "workspace"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      +    "properties": {
      +      "action": {
      +        "const": "create",
      +        "type": "string"
      +      },
      +      "auto_activate_hint": {
      +        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      +        "type": "string"
      +      },
      +      "branches": {
      +        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "description": {
      +        "description": "(create/update only) One-line description of what this overlay is for.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag on a public project. Only meaningful after a flag; the user decides whether the content can be public.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      +    "properties": {
      +      "action": {
      +        "const": "update",
      +        "type": "string"
      +      },
      +      "add_branches": {
      +        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "auto_activate_hint": {
      +        "description": "New plain-language auto-activation hint.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "New one-line description.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Change the workspace kind.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "New name.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "privacy_bypass": {
      +        "description": "true writes despite a privacy flag on a public project. Only meaningful after a flag; the user decides whether the content can be public.",
      +        "type": "boolean"
      +      },
      +      "privacy_false_positive": {
      +        "description": "With privacy_bypass: true reports the privacy flag as wrong.",
      +        "type": "boolean"
      +      },
      +      "privacy_judgement_id": {
      +        "description": "With privacy_bypass: the judgement_id the privacy flag returned.",
      +        "type": "string"
      +      },
      +      "privacy_note": {
      +        "description": "With privacy_bypass: an optional short reason, kept with the bypass.",
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  }
      +]
  7. Changed1 schema field changed
    • changedInput schema / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "description": "workspace action \"create\".",
      -    "properties": {
      -      "action": {
      -        "const": "create",
      -        "description": "Run the create action.",
      -        "type": "string"
      -      },
      -      "auto_activate_hint": {
      -        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      -        "type": "string"
      -      },
      -      "branches": {
      -        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "description": {
      -        "description": "(create/update only) One-line description of what this overlay is for.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "name",
      -      "kind"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "description": "workspace action \"update\".",
      -    "properties": {
      -      "action": {
      -        "const": "update",
      -        "description": "Run the update action.",
      -        "type": "string"
      -      },
      -      "add_branches": {
      -        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "auto_activate_hint": {
      -        "description": "New plain-language auto-activation hint.",
      -        "type": "string"
      -      },
      -      "description": {
      -        "description": "New one-line description.",
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Change the workspace kind.",
      -        "enum": [
      -          "permanent",
      -          "experimental"
      -        ],
      -        "type": "string"
      -      },
      -      "name": {
      -        "description": "New name.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "project_slug": {
      -        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "workspace": {
      -        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "project_slug",
      -      "workspace"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"create\": Create a named workspace — a scoped overlay on the project's trunk (shared truth). Knowledge written while it's active scopes to it; collaborators off that workspace never see it. permanent = a domain/team overlay that never graduates (promote per-item); experimental = ephemeral, expected to merge or be archived. Prefer OFFERING before creating unless the user asked. Does NOT activate it — call workspace(action=\"activate\") to scope this session to it.",
      +    "properties": {
      +      "action": {
      +        "const": "create",
      +        "type": "string"
      +      },
      +      "auto_activate_hint": {
      +        "description": "(create/update only) Plain-language 'when should this auto-activate' hint, read by the agent at session start. Globs/paths welcome; no rules DSL.",
      +        "type": "string"
      +      },
      +      "branches": {
      +        "description": "(create only) Branch associations (0..N). Exact match auto-activates; a glob is offered. Omit for a pure domain overlay with no branch.",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "description": {
      +        "description": "(create/update only) One-line description of what this overlay is for.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "REQUIRED for create — permanent = standing domain/team overlay (never graduates); experimental = ephemeral, expected to merge or be archived.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "REQUIRED for create — workspace name, shown in scope tags (e.g. \"Billing\").",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "name",
      +      "kind"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "description": "action=\"update\": Update a workspace's editable fields (name, kind, description, auto-activation hint) and/or ADD branch associations. Only the fields you pass change. Does NOT promote knowledge or change scope — merge/archive have dedicated tools.",
      +    "properties": {
      +      "action": {
      +        "const": "update",
      +        "type": "string"
      +      },
      +      "add_branches": {
      +        "description": "(update only) Branch associations to ADD (existing ones are kept).",
      +        "items": {
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "auto_activate_hint": {
      +        "description": "New plain-language auto-activation hint.",
      +        "type": "string"
      +      },
      +      "description": {
      +        "description": "New one-line description.",
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Change the workspace kind.",
      +        "enum": [
      +          "permanent",
      +          "experimental"
      +        ],
      +        "type": "string"
      +      },
      +      "name": {
      +        "description": "New name.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "project_slug": {
      +        "description": "Project slug, e.g. \"acme-app\" — list(what=\"projects\") returns yours.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "workspace": {
      +        "description": "REQUIRED for update/activate/deactivate — the workspace to act on — its NAME (e.g. \"Billing\") or its uuid. NOT a short-id (workspaces aren't nodes).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "project_slug",
      +      "workspace"
      +    ],
      +    "type": "object"
      +  }
      +]
  8. First observed

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, destructiveHint=true and openWorldHint=true. The description adds genuinely non-derivable context: the hosted server is stateless, so activate/deactivate do not exist here, and promote/archive live elsewhere. It stops short of mentioning privacy-bypass/confirm_public flows, but those are documented in the schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Short and front-loaded: purpose, action list, then the stateless constraint and sibling routing. The second sentence earns its place, but the incorrect action list is wasted — and harmful — text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a four-variant mutating tool the schema and output schema carry most of the load, and the description usefully frames the hosting constraint. The wrong action enumeration leaves a skimming agent with an incomplete mental model of the tool's surface, which is the one gap that matters here.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline would be 3 on schema alone. However, the description's only parameter statement — "action = create | update" — actively misinforms by omitting two of the four valid actions, which is worse than adding nothing.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Manage a workspace overlay" is a generic verb+resource, and the action enumeration "action = create | update" is factually incomplete: the schema defines four actions (create, update, members, create_personal). It does route the agent away from `destructive` for promote/archive, which helps differentiate, but an agent reading only the description would not know `members` or `create_personal` exist.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly states what is not available in the hosted stateless MCP (checkout-local activate/deactivate) and names the alternative tool (`destructive`) for promoting or archiving. That is real when/when-not guidance; it just doesn't cover when to choose members vs. create_personal vs. create.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.