@kammcs/buildit-mcp 0.0.0-stage → 0.1.0

package/dist/api/generated/operations.js

@@ -0,0 +1,1559 @@
+/**
+ * The agent API's operations, scopes and error codes, as the contract declares them.
+ *
+ * GENERATED by scripts/generate.ts from openapi/openapi.json (agent API
+ * 1.1.0). Do not edit: change the contract, then run
+ * `npm run generate`.
+ */
+import * as S from './schemas.js';
+/** The contract's API version. */
+export const API_VERSION = '1.1.0';
+/** Token scopes, in the contract's order. */
+export const SCOPES = [
+    'projects:read',
+    'projects:write',
+    'projects:delete',
+    'projects:admin',
+    'pages:read',
+    'pages:write',
+    'chat:read',
+];
+/** What each scope directly implies (implications are transitive). */
+export const SCOPE_IMPLIES = {
+    'projects:read': [],
+    'projects:write': ['projects:read'],
+    'projects:delete': ['projects:write'],
+    'projects:admin': ['projects:write'],
+    'pages:read': [],
+    'pages:write': ['pages:read'],
+    'chat:read': [],
+};
+/** The API's error codes and their HTTP statuses. v1 may add codes. */
+export const ERROR_STATUS = {
+    bad_request: 400,
+    token_invalid: 401,
+    token_expired: 401,
+    token_revoked: 401,
+    token_suspended: 401,
+    agent_access_off: 403,
+    projects_off: 403,
+    scope_missing: 403,
+    outside_limits: 403,
+    forbidden: 403,
+    archived: 403,
+    not_found: 404,
+    method_not_allowed: 405,
+    conflict: 409,
+    idempotency_conflict: 409,
+    plan_used: 409,
+    plan_stale: 409,
+    plan_expired: 410,
+    body_too_large: 413,
+    validation: 422,
+    image_layout_invalid: 422,
+    ambiguous: 422,
+    transition_not_allowed: 422,
+    field_required: 422,
+    bulk_too_large: 422,
+    limit_reached: 422,
+    rate_limited: 429,
+    internal: 500,
+    unavailable: 503,
+    release_archived: 409,
+    release_not_released: 409,
+};
+/** Each error code's stable next step, as the contract words it. The API sends it as the error's hint; this copy serves when an older API doesn't. */
+export const ERROR_HINTS = {
+    bad_request: 'Send a JSON body with Content-Type: application/json, and check the path and query.',
+    token_invalid: 'Check the Authorization header: Bearer, then the whole buildit_pat_ token.',
+    token_expired: 'Ask the user to create a new token in buildIt.Social (Settings → Agent tokens).',
+    token_revoked: 'Ask the user to create a new token in buildIt.Social (Settings → Agent tokens), if they still have access.',
+    token_suspended: "Ask an org admin to reactivate the user's membership; the token then works again.",
+    agent_access_off: 'Ask an org owner or admin to turn on Agent access (Settings → the org → Integrations); tokens then work again.',
+    projects_off: "Projects isn't available in this org: use pages or chat instead.",
+    scope_missing: "Ask the user for a token with details.scope; retrying with this token won't help.",
+    outside_limits: 'Call get_me to see the projects and channels this token may reach.',
+    forbidden: "Ask a project admin (or the user, in the app) to do it; retrying won't help.",
+    archived: "Ask the user to restore it in the app first; archived things can't be changed.",
+    not_found: 'Look the reference up (search_items, list_projects, describe_project), then retry.',
+    method_not_allowed: 'Use one of the methods in details.allowed.',
+    conflict: 'Read it again, reapply your change to what you read, and send the new version.',
+    idempotency_conflict: 'Send a new random uuid as idempotency_key.',
+    plan_used: 'The change is done; create a new plan only if more is needed.',
+    plan_stale: 'Create the plan again, show the human the new preview, then apply it.',
+    plan_expired: 'Create the plan again, show the new preview, and apply it within 10 minutes.',
+    body_too_large: 'Send less: shorten or split the content to fit details.max_bytes.',
+    validation: 'Fix each field in details.fields, then retry.',
+    image_layout_invalid: 'Fix the image titles in details.fields: use the layout words exactly, or leave the title out.',
+    ambiguous: 'Retry with the id, key or email of one of details.candidates.',
+    transition_not_allowed: "Move to one of details.allowed (details.moves has each move's rules), or in steps.",
+    field_required: 'Set the fields in details.fields in the same call, then retry.',
+    bulk_too_large: 'Split the change into plans of at most 50 items.',
+    limit_reached: 'Archive or remove something of that kind first.',
+    rate_limited: 'Retry after the number of seconds in details.retry_after (also in the Retry-After header).',
+    internal: 'Retry once; if it fails again, report the X-Request-Id.',
+    unavailable: 'Retry in a minute.',
+    release_archived: 'Restore the release with restore_release, then retry.',
+    release_not_released: 'Leave released_on out, or release it with release_version, which takes released_on.',
+};
+/** Every scope each plan action needs, all of them (the operations whose scope is 'plan_action' check them). */
+export const PLAN_SCOPES = {
+    delete_item: ['projects:delete'],
+    move_item: ['projects:delete'],
+    bulk_update: ['projects:delete'],
+    archive_status: ['projects:delete', 'projects:admin'],
+    workflow_change: ['projects:admin'],
+    work_type_change: ['projects:admin'],
+    field_change: ['projects:admin'],
+    label_change: ['projects:admin'],
+};
+/** Every operation of the contract, by operationId. */
+export const OPERATIONS = {
+    add_comment: {
+        method: 'POST',
+        path: '/v1/items/{key}/comments',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'idempotency_conflict',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.AddCommentResponseSchema,
+    },
+    add_link: {
+        method: 'POST',
+        path: '/v1/items/{key}/links',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.AddLinkResponseSchema,
+    },
+    add_release_items: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/items',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseItemsResponseSchema,
+    },
+    add_sprint_items: {
+        method: 'POST',
+        path: '/v1/projects/{key}/sprints/{sprint}/items',
+        pathParams: ['key', 'sprint'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.SprintItemsResponseSchema,
+    },
+    apply_plan: {
+        method: 'POST',
+        path: '/v1/plans/{handle}/apply',
+        pathParams: ['handle'],
+        arrayQueryParams: [],
+        scope: 'plan_action',
+        requiredScopes: [],
+        hints: { read_only: false, destructive: true, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'plan_used',
+            'plan_stale',
+            'plan_expired',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'transition_not_allowed',
+            'field_required',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ApplyPlanResponseSchema,
+    },
+    archive_release: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/archive',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+    complete_sprint: {
+        method: 'POST',
+        path: '/v1/projects/{key}/sprints/{sprint}/complete',
+        pathParams: ['key', 'sprint'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.CompleteSprintResponseSchema,
+    },
+    create_channel: {
+        method: 'POST',
+        path: '/v1/channels',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'projects:admin',
+        requiredScopes: ['projects:admin'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'not_found',
+            'idempotency_conflict',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.CreateChannelResponseSchema,
+    },
+    create_item: {
+        method: 'POST',
+        path: '/v1/items',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'idempotency_conflict',
+            'body_too_large',
+            'validation',
+            'image_layout_invalid',
+            'ambiguous',
+            'transition_not_allowed',
+            'field_required',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.CreateItemResponseSchema,
+    },
+    create_page: {
+        method: 'POST',
+        path: '/v1/channels/{channel}/pages',
+        pathParams: ['channel'],
+        arrayQueryParams: [],
+        scope: 'pages:write',
+        requiredScopes: ['pages:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'idempotency_conflict',
+            'body_too_large',
+            'validation',
+            'image_layout_invalid',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.CreatePageResponseSchema,
+    },
+    create_plan: {
+        method: 'POST',
+        path: '/v1/plans',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'plan_action',
+        requiredScopes: [],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'transition_not_allowed',
+            'bulk_too_large',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [201],
+        discovery: false,
+        response: S.CreatePlanResponseSchema,
+    },
+    create_project: {
+        method: 'POST',
+        path: '/v1/projects',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'projects:admin',
+        requiredScopes: ['projects:admin'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'idempotency_conflict',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200, 201],
+        discovery: false,
+        response: S.CreateProjectResponseSchema,
+    },
+    create_release: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [201],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+    create_sprint: {
+        method: 'POST',
+        path: '/v1/projects/{key}/sprints',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [201],
+        discovery: false,
+        response: S.SprintResponseSchema,
+    },
+    describe_project: {
+        method: 'GET',
+        path: '/v1/projects/{key}',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.DescribeProjectResponseSchema,
+    },
+    generate_release_notes: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/notes',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write', 'pages:write'],
+        hints: { read_only: false, destructive: true, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseNotesResponseSchema,
+    },
+    get_item: {
+        method: 'GET',
+        path: '/v1/items/{key}',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.GetItemResponseSchema,
+    },
+    get_item_history: {
+        method: 'GET',
+        path: '/v1/items/{key}/history',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ItemHistoryResponseSchema,
+    },
+    get_me: {
+        method: 'GET',
+        path: '/v1/me',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: null,
+        requiredScopes: [],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: true,
+        response: S.MeResponseSchema,
+    },
+    get_meta: {
+        method: 'GET',
+        path: '/v1/meta',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: null,
+        requiredScopes: [],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: true,
+        response: S.MetaResponseSchema,
+    },
+    get_page: {
+        method: 'GET',
+        path: '/v1/pages/{id}',
+        pathParams: ['id'],
+        arrayQueryParams: [],
+        scope: 'pages:read',
+        requiredScopes: ['pages:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.PageResponseSchema,
+    },
+    get_thread: {
+        method: 'GET',
+        path: '/v1/messages/{id}/thread',
+        pathParams: ['id'],
+        arrayQueryParams: [],
+        scope: 'chat:read',
+        requiredScopes: ['chat:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ThreadResponseSchema,
+    },
+    get_workflow: {
+        method: 'GET',
+        path: '/v1/projects/{key}/workflows/{workflow}',
+        pathParams: ['key', 'workflow'],
+        arrayQueryParams: [],
+        scope: 'projects:admin',
+        requiredScopes: ['projects:admin'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.GetWorkflowResponseSchema,
+    },
+    list_channel_messages: {
+        method: 'GET',
+        path: '/v1/channels/{channel}/messages',
+        pathParams: ['channel'],
+        arrayQueryParams: [],
+        scope: 'chat:read',
+        requiredScopes: ['chat:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListChannelMessagesResponseSchema,
+    },
+    list_channels: {
+        method: 'GET',
+        path: '/v1/channels',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'chat:read',
+        requiredScopes: ['chat:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListChannelsResponseSchema,
+    },
+    list_comments: {
+        method: 'GET',
+        path: '/v1/items/{key}/comments',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListCommentsResponseSchema,
+    },
+    list_pages: {
+        method: 'GET',
+        path: '/v1/channels/{channel}/pages',
+        pathParams: ['channel'],
+        arrayQueryParams: [],
+        scope: 'pages:read',
+        requiredScopes: ['pages:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListPagesResponseSchema,
+    },
+    list_project_members: {
+        method: 'GET',
+        path: '/v1/projects/{key}/members',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListProjectMembersResponseSchema,
+    },
+    list_projects: {
+        method: 'GET',
+        path: '/v1/projects',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListProjectsResponseSchema,
+    },
+    list_releases: {
+        method: 'GET',
+        path: '/v1/projects/{key}/releases',
+        pathParams: ['key'],
+        arrayQueryParams: ['status'],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListReleasesResponseSchema,
+    },
+    list_sprints: {
+        method: 'GET',
+        path: '/v1/projects/{key}/sprints',
+        pathParams: ['key'],
+        arrayQueryParams: ['state'],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListSprintsResponseSchema,
+    },
+    list_work_types: {
+        method: 'GET',
+        path: '/v1/work-types',
+        pathParams: [],
+        arrayQueryParams: [],
+        scope: 'projects:admin',
+        requiredScopes: ['projects:admin'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'validation',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ListWorkTypesResponseSchema,
+    },
+    rank_item: {
+        method: 'POST',
+        path: '/v1/items/{key}/rank',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.RankItemResponseSchema,
+    },
+    release_version: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/release',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+    remove_link: {
+        method: 'DELETE',
+        path: '/v1/items/{key}/links/{id}',
+        pathParams: ['key', 'id'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: true, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.RemoveLinkResponseSchema,
+    },
+    remove_release_items: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/items/remove',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseItemsResponseSchema,
+    },
+    remove_sprint_items: {
+        method: 'POST',
+        path: '/v1/projects/{key}/sprints/{sprint}/items/remove',
+        pathParams: ['key', 'sprint'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.SprintItemsResponseSchema,
+    },
+    reopen_release: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/reopen',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+            'release_archived',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+    restore_release: {
+        method: 'POST',
+        path: '/v1/projects/{key}/releases/{release}/restore',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+    search_items: {
+        method: 'GET',
+        path: '/v1/items',
+        pathParams: [],
+        arrayQueryParams: [
+            'project',
+            'type',
+            'status',
+            'category',
+            'priority',
+            'assignee',
+            'label',
+            'sort',
+        ],
+        scope: 'projects:read',
+        requiredScopes: ['projects:read'],
+        hints: { read_only: true, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'not_found',
+            'validation',
+            'ambiguous',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: false,
+        statuses: [200],
+        discovery: false,
+        response: S.SearchItemsResponseSchema,
+    },
+    start_sprint: {
+        method: 'POST',
+        path: '/v1/projects/{key}/sprints/{sprint}/start',
+        pathParams: ['key', 'sprint'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: false, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.StartSprintResponseSchema,
+    },
+    transition_item: {
+        method: 'POST',
+        path: '/v1/items/{key}/transition',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'conflict',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'transition_not_allowed',
+            'field_required',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.TransitionItemResponseSchema,
+    },
+    update_item: {
+        method: 'PATCH',
+        path: '/v1/items/{key}',
+        pathParams: ['key'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'conflict',
+            'body_too_large',
+            'validation',
+            'image_layout_invalid',
+            'ambiguous',
+            'transition_not_allowed',
+            'field_required',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ItemWriteResponseSchema,
+    },
+    update_page: {
+        method: 'PATCH',
+        path: '/v1/pages/{id}',
+        pathParams: ['id'],
+        arrayQueryParams: [],
+        scope: 'pages:write',
+        requiredScopes: ['pages:write'],
+        hints: { read_only: false, destructive: true, idempotent: true, needs_projects: false },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'conflict',
+            'body_too_large',
+            'validation',
+            'image_layout_invalid',
+            'rate_limited',
+            'internal',
+            'unavailable',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.PageResponseSchema,
+    },
+    update_release: {
+        method: 'PATCH',
+        path: '/v1/projects/{key}/releases/{release}',
+        pathParams: ['key', 'release'],
+        arrayQueryParams: [],
+        scope: 'projects:write',
+        requiredScopes: ['projects:write'],
+        hints: { read_only: false, destructive: false, idempotent: true, needs_projects: true },
+        errors: [
+            'bad_request',
+            'token_invalid',
+            'token_expired',
+            'token_revoked',
+            'token_suspended',
+            'agent_access_off',
+            'projects_off',
+            'scope_missing',
+            'outside_limits',
+            'forbidden',
+            'archived',
+            'not_found',
+            'body_too_large',
+            'validation',
+            'ambiguous',
+            'limit_reached',
+            'rate_limited',
+            'internal',
+            'unavailable',
+            'release_archived',
+            'release_not_released',
+        ],
+        hasBody: true,
+        statuses: [200],
+        discovery: false,
+        response: S.ReleaseResponseSchema,
+    },
+};