@lumoauth/api-client 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (95) hide show
  1. package/.openapi-generator/FILES +6 -0
  2. package/README.md +6 -2
  3. package/api/aauth-api.ts +5 -5
  4. package/api/admin-mcp-api.ts +5 -5
  5. package/api/agents-api.ts +5 -5
  6. package/api/mcp-api.ts +130 -0
  7. package/api/well-known-api.ts +10 -10
  8. package/dist/api/aauth-api.d.ts +5 -5
  9. package/dist/api/aauth-api.js +4 -4
  10. package/dist/api/admin-mcp-api.d.ts +5 -5
  11. package/dist/api/admin-mcp-api.js +4 -4
  12. package/dist/api/agents-api.d.ts +5 -5
  13. package/dist/api/agents-api.js +4 -4
  14. package/dist/api/mcp-api.d.ts +73 -0
  15. package/dist/api/mcp-api.js +82 -0
  16. package/dist/api/well-known-api.d.ts +10 -10
  17. package/dist/api/well-known-api.js +8 -8
  18. package/dist/esm/api/aauth-api.d.ts +5 -5
  19. package/dist/esm/api/aauth-api.js +4 -4
  20. package/dist/esm/api/admin-mcp-api.d.ts +5 -5
  21. package/dist/esm/api/admin-mcp-api.js +4 -4
  22. package/dist/esm/api/agents-api.d.ts +5 -5
  23. package/dist/esm/api/agents-api.js +4 -4
  24. package/dist/esm/api/mcp-api.d.ts +73 -0
  25. package/dist/esm/api/mcp-api.js +83 -1
  26. package/dist/esm/api/well-known-api.d.ts +10 -10
  27. package/dist/esm/api/well-known-api.js +8 -8
  28. package/dist/esm/models/admin-agents-generate-token-request.d.ts +7 -1
  29. package/dist/esm/models/admin-agents-generate-token-response-data.d.ts +12 -0
  30. package/dist/esm/models/attest-response.d.ts +2 -1
  31. package/dist/esm/models/attest-response.js +1 -0
  32. package/dist/esm/models/authorize-mcp-request.d.ts +1 -1
  33. package/dist/esm/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  34. package/dist/esm/models/index.d.ts +3 -0
  35. package/dist/esm/models/index.js +3 -0
  36. package/dist/esm/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  37. package/dist/esm/models/mcp-server-tool-authorize-request-subject.js +22 -0
  38. package/dist/esm/models/mcp-server-tool-authorize-request.d.ts +31 -0
  39. package/dist/esm/models/mcp-server-tool-authorize-request.js +14 -0
  40. package/dist/esm/models/mcp-server-tool-authorize-response.d.ts +36 -0
  41. package/dist/esm/models/mcp-server-tool-authorize-response.js +14 -0
  42. package/dist/esm/models/mcp-server.d.ts +18 -0
  43. package/dist/esm/models/open-id-configuration.d.ts +1 -1
  44. package/dist/esm/models/protected-resource-metadata.d.ts +1 -1
  45. package/dist/esm/models/single-server-metadata.d.ts +1 -1
  46. package/dist/models/admin-agents-generate-token-request.d.ts +7 -1
  47. package/dist/models/admin-agents-generate-token-response-data.d.ts +12 -0
  48. package/dist/models/attest-response.d.ts +2 -1
  49. package/dist/models/attest-response.js +1 -0
  50. package/dist/models/authorize-mcp-request.d.ts +1 -1
  51. package/dist/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  52. package/dist/models/index.d.ts +3 -0
  53. package/dist/models/index.js +3 -0
  54. package/dist/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  55. package/dist/models/mcp-server-tool-authorize-request-subject.js +25 -0
  56. package/dist/models/mcp-server-tool-authorize-request.d.ts +31 -0
  57. package/dist/models/mcp-server-tool-authorize-request.js +15 -0
  58. package/dist/models/mcp-server-tool-authorize-response.d.ts +36 -0
  59. package/dist/models/mcp-server-tool-authorize-response.js +15 -0
  60. package/dist/models/mcp-server.d.ts +18 -0
  61. package/dist/models/open-id-configuration.d.ts +1 -1
  62. package/dist/models/protected-resource-metadata.d.ts +1 -1
  63. package/dist/models/single-server-metadata.d.ts +1 -1
  64. package/docs/AAuthApi.md +1 -1
  65. package/docs/AdminAgentsApi.md +1 -1
  66. package/docs/AdminAgentsGenerateTokenRequest.md +3 -1
  67. package/docs/AdminAgentsGenerateTokenResponseData.md +4 -0
  68. package/docs/AdminMcpApi.md +1 -1
  69. package/docs/AgentsApi.md +4 -3
  70. package/docs/AuthorizeMcpRequest.md +1 -1
  71. package/docs/GetProtectedResourceMetadataRoot200Response.md +1 -1
  72. package/docs/GetProtectedResourceMetadataRootResponse1ResourcesItem.md +1 -1
  73. package/docs/McpApi.md +64 -0
  74. package/docs/McpServer.md +6 -0
  75. package/docs/McpServerToolAuthorizeRequest.md +22 -0
  76. package/docs/McpServerToolAuthorizeRequestSubject.md +22 -0
  77. package/docs/McpServerToolAuthorizeResponse.md +24 -0
  78. package/docs/OpenIdConfiguration.md +1 -1
  79. package/docs/ProtectedResourceMetadata.md +1 -1
  80. package/docs/SingleServerMetadata.md +1 -1
  81. package/docs/WellKnownApi.md +2 -2
  82. package/models/admin-agents-generate-token-request.ts +7 -1
  83. package/models/admin-agents-generate-token-response-data.ts +12 -0
  84. package/models/attest-response.ts +2 -1
  85. package/models/authorize-mcp-request.ts +1 -1
  86. package/models/get-protected-resource-metadata-root-response1-resources-item.ts +1 -1
  87. package/models/index.ts +3 -0
  88. package/models/mcp-server-tool-authorize-request-subject.ts +46 -0
  89. package/models/mcp-server-tool-authorize-request.ts +39 -0
  90. package/models/mcp-server-tool-authorize-response.ts +42 -0
  91. package/models/mcp-server.ts +18 -0
  92. package/models/open-id-configuration.ts +1 -1
  93. package/models/protected-resource-metadata.ts +1 -1
  94. package/models/single-server-metadata.ts +1 -1
  95. package/package.json +1 -1
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | The MCP server\'s resource identifier. | [default to undefined]
9
- **authorization_servers** | **Array<string>** | This organization\'s authorization server metadata URL. | [default to undefined]
9
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414), the same value as `issuer` in its discovery documents. Clients read the authorization server metadata from {issuer}/.well-known/openid-configuration. | [default to undefined]
10
10
  **bearer_methods_supported** | **Array<string>** | | [default to undefined]
11
11
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | Present (true) only when the server accepts DPoP-bound tokens exclusively. | [optional] [default to undefined]
@@ -6,7 +6,7 @@
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
8
  **resource** | **string** | | [default to undefined]
9
- **authorization_servers** | **Array<string>** | | [default to undefined]
9
+ **authorization_servers** | **Array<string>** | The organization\'s issuer identifier (RFC 8414). | [default to undefined]
10
10
  **bearer_methods_supported** | **Array<string>** | | [default to undefined]
11
11
  **scopes_supported** | **Array<string>** | | [optional] [default to undefined]
12
12
  **dpop_bound_access_tokens_required** | **boolean** | | [optional] [default to undefined]
@@ -12,7 +12,7 @@ All URIs are relative to *https://app.lumoauth.dev*
12
12
  # **getAuthorizationServerMetadata**
13
13
  > AuthorizationServerMetadata getAuthorizationServerMetadata()
14
14
 
15
- Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active.
15
+ Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active. RFC 8414 clients read it from /.well-known/oauth-authorization-server/orgs/{orgId}/api/v1 (the issuer\'s path-inserted location) and, on a verified custom domain, from /.well-known/oauth-authorization-server.
16
16
 
17
17
  ### Example
18
18
 
@@ -116,7 +116,7 @@ No authorization required
116
116
  # **getOpenidConfiguration**
117
117
  > OpenIdConfiguration getOpenidConfiguration()
118
118
 
119
- Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active.
119
+ Public, CORS-enabled and cacheable (Cache-Control: public, max-age=3600). Endpoint URLs are rewritten to the organization\'s custom domain when one is active. The same document is served at the RFC 8414 location /.well-known/openid-configuration/orgs/{orgId}/api/v1 and, on a verified custom domain (whose issuer is the bare domain), at /.well-known/openid-configuration.
120
120
 
121
121
  ### Example
122
122
 
@@ -21,7 +21,7 @@
21
21
  */
22
22
  export interface AdminAgentsGenerateTokenRequest {
23
23
  /**
24
- * Token lifetime in seconds. Default 3600, at most 2592000 (30 days).
24
+ * Token lifetime in seconds. Default 3600, minimum 60, at most 86400 (24 hours). Above 3600 only together with `resource`: a long-lived token is always bound to one MCP server, never to the organization API.
25
25
  * @type {number}
26
26
  * @memberof AdminAgentsGenerateTokenRequest
27
27
  */
@@ -32,5 +32,11 @@ export interface AdminAgentsGenerateTokenRequest {
32
32
  * @memberof AdminAgentsGenerateTokenRequest
33
33
  */
34
34
  'scopes'?: Array<string>;
35
+ /**
36
+ * Optional resource URI of an active MCP server of this organization. The token is then audience-bound to that server (and no longer works on the LumoAuth API) and lives at most the server\'s token lifetime. Servers that require DPoP are refused with 400.
37
+ * @type {string}
38
+ * @memberof AdminAgentsGenerateTokenRequest
39
+ */
40
+ 'resource'?: string;
35
41
  }
36
42
 
@@ -38,11 +38,23 @@ export interface AdminAgentsGenerateTokenResponseData {
38
38
  * @memberof AdminAgentsGenerateTokenResponseData
39
39
  */
40
40
  'expiresIn'?: number;
41
+ /**
42
+ * The token id. Written to the agent.token_issued audit event; the kill switch and a capability reduction deny-list it.
43
+ * @type {string}
44
+ * @memberof AdminAgentsGenerateTokenResponseData
45
+ */
46
+ 'jti'?: string;
41
47
  /**
42
48
  *
43
49
  * @type {Array<string>}
44
50
  * @memberof AdminAgentsGenerateTokenResponseData
45
51
  */
46
52
  'scopes'?: Array<string>;
53
+ /**
54
+ * The MCP server the token is bound to, when `resource` was sent.
55
+ * @type {string}
56
+ * @memberof AdminAgentsGenerateTokenResponseData
57
+ */
58
+ 'resource'?: string | null;
47
59
  }
48
60
 
@@ -60,7 +60,8 @@ export interface AttestResponse {
60
60
  * @enum {string}
61
61
  */
62
62
  export enum AttestResponseTokenType {
63
- BEARER = 'Bearer'
63
+ BEARER = 'Bearer',
64
+ DPO_P = 'DPoP'
64
65
  }
65
66
 
66
67
 
@@ -21,7 +21,7 @@
21
21
  */
22
22
  export interface AuthorizeMcpRequest {
23
23
  /**
24
- *
24
+ * Id of an active MCP server registered in this organization.
25
25
  * @type {string}
26
26
  * @memberof AuthorizeMcpRequest
27
27
  */
@@ -33,7 +33,7 @@ export interface GetProtectedResourceMetadataRootResponse1ResourcesItem {
33
33
  */
34
34
  'resource_metadata_url': string;
35
35
  /**
36
- *
36
+ * The organization\'s issuer identifier (RFC 8414).
37
37
  * @type {Array<string>}
38
38
  * @memberof GetProtectedResourceMetadataRootResponse1ResourcesItem
39
39
  */
package/models/index.ts CHANGED
@@ -288,6 +288,9 @@ export * from './mark-user-verified-response';
288
288
  export * from './mcp-server';
289
289
  export * from './mcp-server-posture';
290
290
  export * from './mcp-server-posture-checks-inner';
291
+ export * from './mcp-server-tool-authorize-request';
292
+ export * from './mcp-server-tool-authorize-request-subject';
293
+ export * from './mcp-server-tool-authorize-response';
291
294
  export * from './message-response';
292
295
  export * from './mfa-authenticator';
293
296
  export * from './mfa-authenticator-last-used-context';
@@ -0,0 +1,46 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * LumoAuth API
5
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ * Contact: sdk@lumoauth.dev
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ *
19
+ * @export
20
+ * @interface McpServerToolAuthorizeRequestSubject
21
+ */
22
+ export interface McpServerToolAuthorizeRequestSubject {
23
+ /**
24
+ *
25
+ * @type {string}
26
+ * @memberof McpServerToolAuthorizeRequestSubject
27
+ */
28
+ 'type': McpServerToolAuthorizeRequestSubjectType;
29
+ /**
30
+ * User UUID, or agent id (agt_…). For an MCP token, the user id is `sub`; for an agent token `sub` is `agent_<id>`.
31
+ * @type {string}
32
+ * @memberof McpServerToolAuthorizeRequestSubject
33
+ */
34
+ 'id': string;
35
+ }
36
+
37
+ /**
38
+ * @export
39
+ * @enum {string}
40
+ */
41
+ export enum McpServerToolAuthorizeRequestSubjectType {
42
+ USER = 'user',
43
+ AGENT = 'agent'
44
+ }
45
+
46
+
@@ -0,0 +1,39 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * LumoAuth API
5
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ * Contact: sdk@lumoauth.dev
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+ // May contain unused imports in some cases
17
+ // @ts-ignore
18
+ import type { McpServerToolAuthorizeRequestSubject } from './mcp-server-tool-authorize-request-subject';
19
+
20
+ /**
21
+ *
22
+ * @export
23
+ * @interface McpServerToolAuthorizeRequest
24
+ */
25
+ export interface McpServerToolAuthorizeRequest {
26
+ /**
27
+ *
28
+ * @type {McpServerToolAuthorizeRequestSubject}
29
+ * @memberof McpServerToolAuthorizeRequest
30
+ */
31
+ 'subject': McpServerToolAuthorizeRequestSubject;
32
+ /**
33
+ *
34
+ * @type {string}
35
+ * @memberof McpServerToolAuthorizeRequest
36
+ */
37
+ 'tool': string;
38
+ }
39
+
@@ -0,0 +1,42 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * LumoAuth API
5
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
6
+ *
7
+ * The version of the OpenAPI document: 1.0.0
8
+ * Contact: sdk@lumoauth.dev
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+
17
+ /**
18
+ *
19
+ * @export
20
+ * @interface McpServerToolAuthorizeResponse
21
+ */
22
+ export interface McpServerToolAuthorizeResponse {
23
+ /**
24
+ *
25
+ * @type {boolean}
26
+ * @memberof McpServerToolAuthorizeResponse
27
+ */
28
+ 'allowed'?: boolean;
29
+ /**
30
+ *
31
+ * @type {object}
32
+ * @memberof McpServerToolAuthorizeResponse
33
+ */
34
+ 'subject'?: object;
35
+ /**
36
+ *
37
+ * @type {object}
38
+ * @memberof McpServerToolAuthorizeResponse
39
+ */
40
+ 'resource'?: object;
41
+ }
42
+
@@ -65,6 +65,12 @@ export interface McpServer {
65
65
  * @memberof McpServer
66
66
  */
67
67
  'transport'?: string;
68
+ /**
69
+ * True for http_sse, deprecated in MCP 2026-07-28; migrate to http_streamable.
70
+ * @type {boolean}
71
+ * @memberof McpServer
72
+ */
73
+ 'transport_deprecated'?: boolean;
68
74
  /**
69
75
  *
70
76
  * @type {string}
@@ -89,12 +95,24 @@ export interface McpServer {
89
95
  * @memberof McpServer
90
96
  */
91
97
  'scope_descriptions'?: { [key: string]: string; };
98
+ /**
99
+ * Subset of scopes_supported advertised in the 401 challenge and in protected resource metadata. Empty = the whole vocabulary.
100
+ * @type {Array<string>}
101
+ * @memberof McpServer
102
+ */
103
+ 'basic_scopes'?: Array<string>;
92
104
  /**
93
105
  *
94
106
  * @type {Array<string>}
95
107
  * @memberof McpServer
96
108
  */
97
109
  'allowed_client_ids'?: Array<string>;
110
+ /**
111
+ * The MCP server\'s own OAuth clients allowed to call the per-tool authorization endpoint.
112
+ * @type {Array<string>}
113
+ * @memberof McpServer
114
+ */
115
+ 'tool_authorizer_client_ids'?: Array<string>;
98
116
  /**
99
117
  *
100
118
  * @type {boolean}
@@ -171,7 +171,7 @@ export interface OpenIdConfiguration {
171
171
  */
172
172
  'ui_locales_supported'?: Array<string>;
173
173
  /**
174
- * The four MFA tier ACR values, unless overridden in organization settings.
174
+ * The four MFA tier ACR values plus the single-factor urn:lumoauth:acr:pwd (any signed-in session), unless overridden in organization settings.
175
175
  * @type {Array<string>}
176
176
  * @memberof OpenIdConfiguration
177
177
  */
@@ -29,7 +29,7 @@ export interface ProtectedResourceMetadata {
29
29
  */
30
30
  'resource': string;
31
31
  /**
32
- * This organization\'s authorization server metadata URL.
32
+ * The organization\'s issuer identifier (RFC 8414), the same value as `issuer` in its discovery documents. Clients read the authorization server metadata from {issuer}/.well-known/openid-configuration.
33
33
  * @type {Array<string>}
34
34
  * @memberof ProtectedResourceMetadata
35
35
  */
@@ -29,7 +29,7 @@ export interface SingleServerMetadata {
29
29
  */
30
30
  'resource': string;
31
31
  /**
32
- *
32
+ * The organization\'s issuer identifier (RFC 8414).
33
33
  * @type {Array<string>}
34
34
  * @memberof SingleServerMetadata
35
35
  */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lumoauth/api-client",
3
- "version": "1.1.0",
3
+ "version": "1.2.0",
4
4
  "description": "OpenAPI client for @lumoauth/api-client",
5
5
  "author": "OpenAPI-Generator Contributors",
6
6
  "repository": {