@lumoauth/api-client 1.0.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 (151) hide show
  1. package/.openapi-generator/FILES +16 -0
  2. package/.openapi-generator-ignore +1 -1
  3. package/README.md +12 -2
  4. package/api/aauth-api.ts +5 -5
  5. package/api/admin-mcp-api.ts +5 -5
  6. package/api/admin-oauth-clients-api.ts +118 -0
  7. package/api/agents-api.ts +5 -5
  8. package/api/authorization-api.ts +5 -26
  9. package/api/mcp-api.ts +130 -0
  10. package/api/well-known-api.ts +10 -10
  11. package/dist/api/aauth-api.d.ts +5 -5
  12. package/dist/api/aauth-api.js +4 -4
  13. package/dist/api/admin-mcp-api.d.ts +5 -5
  14. package/dist/api/admin-mcp-api.js +4 -4
  15. package/dist/api/admin-oauth-clients-api.d.ts +65 -0
  16. package/dist/api/admin-oauth-clients-api.js +77 -0
  17. package/dist/api/agents-api.d.ts +5 -5
  18. package/dist/api/agents-api.js +4 -4
  19. package/dist/api/authorization-api.d.ts +5 -5
  20. package/dist/api/authorization-api.js +4 -18
  21. package/dist/api/mcp-api.d.ts +73 -0
  22. package/dist/api/mcp-api.js +82 -0
  23. package/dist/api/well-known-api.d.ts +10 -10
  24. package/dist/api/well-known-api.js +8 -8
  25. package/dist/esm/api/aauth-api.d.ts +5 -5
  26. package/dist/esm/api/aauth-api.js +4 -4
  27. package/dist/esm/api/admin-mcp-api.d.ts +5 -5
  28. package/dist/esm/api/admin-mcp-api.js +4 -4
  29. package/dist/esm/api/admin-oauth-clients-api.d.ts +65 -0
  30. package/dist/esm/api/admin-oauth-clients-api.js +78 -1
  31. package/dist/esm/api/agents-api.d.ts +5 -5
  32. package/dist/esm/api/agents-api.js +4 -4
  33. package/dist/esm/api/authorization-api.d.ts +5 -5
  34. package/dist/esm/api/authorization-api.js +4 -18
  35. package/dist/esm/api/mcp-api.d.ts +73 -0
  36. package/dist/esm/api/mcp-api.js +83 -1
  37. package/dist/esm/api/well-known-api.d.ts +10 -10
  38. package/dist/esm/api/well-known-api.js +8 -8
  39. package/dist/esm/models/admin-agents-generate-token-request.d.ts +7 -1
  40. package/dist/esm/models/admin-agents-generate-token-response-data.d.ts +12 -0
  41. package/dist/esm/models/admin-clients-cimd-check-request.d.ts +30 -0
  42. package/dist/esm/models/admin-clients-cimd-check-request.js +14 -0
  43. package/dist/esm/models/admin-clients-cimd-check-response.d.ts +25 -0
  44. package/dist/esm/models/admin-clients-cimd-check-response.js +14 -0
  45. package/dist/esm/models/attest-response.d.ts +2 -1
  46. package/dist/esm/models/attest-response.js +1 -0
  47. package/dist/esm/models/authentication-settings.d.ts +1 -1
  48. package/dist/esm/models/authorization-server-metadata.d.ts +1 -1
  49. package/dist/esm/models/authorize-mcp-request.d.ts +1 -1
  50. package/dist/esm/models/cimd-check-result-effective.d.ts +112 -0
  51. package/dist/esm/models/cimd-check-result-effective.js +31 -0
  52. package/dist/esm/models/cimd-check-result-shadow-client.d.ts +30 -0
  53. package/dist/esm/models/cimd-check-result-shadow-client.js +14 -0
  54. package/dist/esm/models/cimd-check-result.d.ts +76 -0
  55. package/dist/esm/models/cimd-check-result.js +14 -0
  56. package/dist/esm/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  57. package/dist/esm/models/index.d.ts +8 -0
  58. package/dist/esm/models/index.js +8 -0
  59. package/dist/esm/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  60. package/dist/esm/models/mcp-server-tool-authorize-request-subject.js +22 -0
  61. package/dist/esm/models/mcp-server-tool-authorize-request.d.ts +31 -0
  62. package/dist/esm/models/mcp-server-tool-authorize-request.js +14 -0
  63. package/dist/esm/models/mcp-server-tool-authorize-response.d.ts +36 -0
  64. package/dist/esm/models/mcp-server-tool-authorize-response.js +14 -0
  65. package/dist/esm/models/mcp-server.d.ts +18 -0
  66. package/dist/esm/models/open-id-configuration.d.ts +2 -2
  67. package/dist/esm/models/protected-resource-metadata.d.ts +1 -1
  68. package/dist/esm/models/push-enrollment-started.d.ts +7 -1
  69. package/dist/esm/models/single-server-metadata.d.ts +1 -1
  70. package/dist/models/admin-agents-generate-token-request.d.ts +7 -1
  71. package/dist/models/admin-agents-generate-token-response-data.d.ts +12 -0
  72. package/dist/models/admin-clients-cimd-check-request.d.ts +30 -0
  73. package/dist/models/admin-clients-cimd-check-request.js +15 -0
  74. package/dist/models/admin-clients-cimd-check-response.d.ts +25 -0
  75. package/dist/models/admin-clients-cimd-check-response.js +15 -0
  76. package/dist/models/attest-response.d.ts +2 -1
  77. package/dist/models/attest-response.js +1 -0
  78. package/dist/models/authentication-settings.d.ts +1 -1
  79. package/dist/models/authorization-server-metadata.d.ts +1 -1
  80. package/dist/models/authorize-mcp-request.d.ts +1 -1
  81. package/dist/models/cimd-check-result-effective.d.ts +112 -0
  82. package/dist/models/cimd-check-result-effective.js +34 -0
  83. package/dist/models/cimd-check-result-shadow-client.d.ts +30 -0
  84. package/dist/models/cimd-check-result-shadow-client.js +15 -0
  85. package/dist/models/cimd-check-result.d.ts +76 -0
  86. package/dist/models/cimd-check-result.js +15 -0
  87. package/dist/models/get-protected-resource-metadata-root-response1-resources-item.d.ts +1 -1
  88. package/dist/models/index.d.ts +8 -0
  89. package/dist/models/index.js +8 -0
  90. package/dist/models/mcp-server-tool-authorize-request-subject.d.ts +38 -0
  91. package/dist/models/mcp-server-tool-authorize-request-subject.js +25 -0
  92. package/dist/models/mcp-server-tool-authorize-request.d.ts +31 -0
  93. package/dist/models/mcp-server-tool-authorize-request.js +15 -0
  94. package/dist/models/mcp-server-tool-authorize-response.d.ts +36 -0
  95. package/dist/models/mcp-server-tool-authorize-response.js +15 -0
  96. package/dist/models/mcp-server.d.ts +18 -0
  97. package/dist/models/open-id-configuration.d.ts +2 -2
  98. package/dist/models/protected-resource-metadata.d.ts +1 -1
  99. package/dist/models/push-enrollment-started.d.ts +7 -1
  100. package/dist/models/single-server-metadata.d.ts +1 -1
  101. package/docs/AAuthApi.md +1 -1
  102. package/docs/AdminAgentsApi.md +1 -1
  103. package/docs/AdminAgentsGenerateTokenRequest.md +3 -1
  104. package/docs/AdminAgentsGenerateTokenResponseData.md +4 -0
  105. package/docs/AdminClientsCimdCheckRequest.md +22 -0
  106. package/docs/AdminClientsCimdCheckResponse.md +20 -0
  107. package/docs/AdminMcpApi.md +1 -1
  108. package/docs/AdminOAuthClientsApi.md +57 -0
  109. package/docs/AgentsApi.md +4 -3
  110. package/docs/AuthenticationSettings.md +1 -1
  111. package/docs/AuthorizationApi.md +8 -8
  112. package/docs/AuthorizationServerMetadata.md +1 -1
  113. package/docs/AuthorizeMcpRequest.md +1 -1
  114. package/docs/CimdCheckResult.md +37 -0
  115. package/docs/CimdCheckResultEffective.md +45 -0
  116. package/docs/CimdCheckResultShadowClient.md +23 -0
  117. package/docs/EnrollAuthenticator201Response.md +3 -1
  118. package/docs/GetProtectedResourceMetadataRoot200Response.md +1 -1
  119. package/docs/GetProtectedResourceMetadataRootResponse1ResourcesItem.md +1 -1
  120. package/docs/McpApi.md +64 -0
  121. package/docs/McpServer.md +6 -0
  122. package/docs/McpServerToolAuthorizeRequest.md +22 -0
  123. package/docs/McpServerToolAuthorizeRequestSubject.md +22 -0
  124. package/docs/McpServerToolAuthorizeResponse.md +24 -0
  125. package/docs/OpenIdConfiguration.md +2 -2
  126. package/docs/ProtectedResourceMetadata.md +1 -1
  127. package/docs/PushEnrollmentStarted.md +3 -1
  128. package/docs/SingleServerMetadata.md +1 -1
  129. package/docs/WellKnownApi.md +4 -4
  130. package/models/admin-agents-generate-token-request.ts +7 -1
  131. package/models/admin-agents-generate-token-response-data.ts +12 -0
  132. package/models/admin-clients-cimd-check-request.ts +36 -0
  133. package/models/admin-clients-cimd-check-response.ts +33 -0
  134. package/models/attest-response.ts +2 -1
  135. package/models/authentication-settings.ts +1 -1
  136. package/models/authorization-server-metadata.ts +1 -1
  137. package/models/authorize-mcp-request.ts +1 -1
  138. package/models/cimd-check-result-effective.ts +120 -0
  139. package/models/cimd-check-result-shadow-client.ts +36 -0
  140. package/models/cimd-check-result.ts +84 -0
  141. package/models/get-protected-resource-metadata-root-response1-resources-item.ts +1 -1
  142. package/models/index.ts +8 -0
  143. package/models/mcp-server-tool-authorize-request-subject.ts +46 -0
  144. package/models/mcp-server-tool-authorize-request.ts +39 -0
  145. package/models/mcp-server-tool-authorize-response.ts +42 -0
  146. package/models/mcp-server.ts +18 -0
  147. package/models/open-id-configuration.ts +2 -2
  148. package/models/protected-resource-metadata.ts +1 -1
  149. package/models/push-enrollment-started.ts +7 -1
  150. package/models/single-server-metadata.ts +1 -1
  151. package/package.json +1 -1
@@ -0,0 +1,76 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { CimdCheckResultEffective } from './cimd-check-result-effective';
13
+ import type { CimdCheckResultShadowClient } from './cimd-check-result-shadow-client';
14
+ /**
15
+ * Result of POST /admin/clients/cimd/check — how the authorization server sees a Client ID Metadata Document.
16
+ * @export
17
+ * @interface CimdCheckResult
18
+ */
19
+ export interface CimdCheckResult {
20
+ /**
21
+ * true when the document is valid and would be accepted (subject to `enabled`).
22
+ * @type {boolean}
23
+ * @memberof CimdCheckResult
24
+ */
25
+ 'ok'?: boolean;
26
+ /**
27
+ *
28
+ * @type {string}
29
+ * @memberof CimdCheckResult
30
+ */
31
+ 'client_id'?: string;
32
+ /**
33
+ * Whether CIMD is currently on for this organization (switch + plan).
34
+ * @type {boolean}
35
+ * @memberof CimdCheckResult
36
+ */
37
+ 'enabled'?: boolean;
38
+ /**
39
+ * Stable failure code when ok is false (client_id_mismatch, invalid_redirect_uri, domain_not_allowed, http_status_404, …).
40
+ * @type {string}
41
+ * @memberof CimdCheckResult
42
+ */
43
+ 'reason'?: string | null;
44
+ /**
45
+ * Developer-facing explanation of `reason`.
46
+ * @type {string}
47
+ * @memberof CimdCheckResult
48
+ */
49
+ 'message'?: string | null;
50
+ /**
51
+ *
52
+ * @type {Array<string>}
53
+ * @memberof CimdCheckResult
54
+ */
55
+ 'warnings'?: Array<string>;
56
+ /**
57
+ * The metadata document as fetched.
58
+ * @type {{ [key: string]: any; }}
59
+ * @memberof CimdCheckResult
60
+ */
61
+ 'document'?: {
62
+ [key: string]: any;
63
+ } | null;
64
+ /**
65
+ *
66
+ * @type {CimdCheckResultEffective}
67
+ * @memberof CimdCheckResult
68
+ */
69
+ 'effective'?: CimdCheckResultEffective | null;
70
+ /**
71
+ *
72
+ * @type {CimdCheckResultShadowClient}
73
+ * @memberof CimdCheckResult
74
+ */
75
+ 'shadow_client'?: CimdCheckResultShadowClient | null;
76
+ }
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -28,7 +28,7 @@ export interface GetProtectedResourceMetadataRootResponse1ResourcesItem {
28
28
  */
29
29
  'resource_metadata_url': string;
30
30
  /**
31
- *
31
+ * The organization\'s issuer identifier (RFC 8414).
32
32
  * @type {Array<string>}
33
33
  * @memberof GetProtectedResourceMetadataRootResponse1ResourcesItem
34
34
  */
@@ -54,6 +54,8 @@ export * from './admin-audit-logs-stats-response';
54
54
  export * from './admin-audit-logs-stats-response-data';
55
55
  export * from './admin-audit-logs-stats-response-data-period';
56
56
  export * from './admin-client-tokens-revoke-all-response';
57
+ export * from './admin-clients-cimd-check-request';
58
+ export * from './admin-clients-cimd-check-response';
57
59
  export * from './admin-email-templates-list-response';
58
60
  export * from './admin-email-templates-preview-response';
59
61
  export * from './admin-email-templates-variables-response';
@@ -186,6 +188,9 @@ export * from './check-permission-response';
186
188
  export * from './check-permissions-bulk-response';
187
189
  export * from './check-relation-response';
188
190
  export * from './check-relation-scoped-response';
191
+ export * from './cimd-check-result';
192
+ export * from './cimd-check-result-effective';
193
+ export * from './cimd-check-result-shadow-client';
189
194
  export * from './complete-task-response';
190
195
  export * from './create-approval-request';
191
196
  export * from './create-approval-response';
@@ -283,6 +288,9 @@ export * from './mark-user-verified-response';
283
288
  export * from './mcp-server';
284
289
  export * from './mcp-server-posture';
285
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';
286
294
  export * from './message-response';
287
295
  export * from './mfa-authenticator';
288
296
  export * from './mfa-authenticator-last-used-context';
@@ -70,6 +70,8 @@ __exportStar(require("./admin-audit-logs-stats-response"), exports);
70
70
  __exportStar(require("./admin-audit-logs-stats-response-data"), exports);
71
71
  __exportStar(require("./admin-audit-logs-stats-response-data-period"), exports);
72
72
  __exportStar(require("./admin-client-tokens-revoke-all-response"), exports);
73
+ __exportStar(require("./admin-clients-cimd-check-request"), exports);
74
+ __exportStar(require("./admin-clients-cimd-check-response"), exports);
73
75
  __exportStar(require("./admin-email-templates-list-response"), exports);
74
76
  __exportStar(require("./admin-email-templates-preview-response"), exports);
75
77
  __exportStar(require("./admin-email-templates-variables-response"), exports);
@@ -202,6 +204,9 @@ __exportStar(require("./check-permission-response"), exports);
202
204
  __exportStar(require("./check-permissions-bulk-response"), exports);
203
205
  __exportStar(require("./check-relation-response"), exports);
204
206
  __exportStar(require("./check-relation-scoped-response"), exports);
207
+ __exportStar(require("./cimd-check-result"), exports);
208
+ __exportStar(require("./cimd-check-result-effective"), exports);
209
+ __exportStar(require("./cimd-check-result-shadow-client"), exports);
205
210
  __exportStar(require("./complete-task-response"), exports);
206
211
  __exportStar(require("./create-approval-request"), exports);
207
212
  __exportStar(require("./create-approval-response"), exports);
@@ -299,6 +304,9 @@ __exportStar(require("./mark-user-verified-response"), exports);
299
304
  __exportStar(require("./mcp-server"), exports);
300
305
  __exportStar(require("./mcp-server-posture"), exports);
301
306
  __exportStar(require("./mcp-server-posture-checks-inner"), exports);
307
+ __exportStar(require("./mcp-server-tool-authorize-request"), exports);
308
+ __exportStar(require("./mcp-server-tool-authorize-request-subject"), exports);
309
+ __exportStar(require("./mcp-server-tool-authorize-response"), exports);
302
310
  __exportStar(require("./message-response"), exports);
303
311
  __exportStar(require("./mfa-authenticator"), exports);
304
312
  __exportStar(require("./mfa-authenticator-last-used-context"), exports);
@@ -0,0 +1,38 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface McpServerToolAuthorizeRequestSubject
16
+ */
17
+ export interface McpServerToolAuthorizeRequestSubject {
18
+ /**
19
+ *
20
+ * @type {string}
21
+ * @memberof McpServerToolAuthorizeRequestSubject
22
+ */
23
+ 'type': McpServerToolAuthorizeRequestSubjectType;
24
+ /**
25
+ * User UUID, or agent id (agt_…). For an MCP token, the user id is `sub`; for an agent token `sub` is `agent_<id>`.
26
+ * @type {string}
27
+ * @memberof McpServerToolAuthorizeRequestSubject
28
+ */
29
+ 'id': string;
30
+ }
31
+ /**
32
+ * @export
33
+ * @enum {string}
34
+ */
35
+ export declare enum McpServerToolAuthorizeRequestSubjectType {
36
+ USER = "user",
37
+ AGENT = "agent"
38
+ }
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.McpServerToolAuthorizeRequestSubjectType = void 0;
17
+ /**
18
+ * @export
19
+ * @enum {string}
20
+ */
21
+ var McpServerToolAuthorizeRequestSubjectType;
22
+ (function (McpServerToolAuthorizeRequestSubjectType) {
23
+ McpServerToolAuthorizeRequestSubjectType["USER"] = "user";
24
+ McpServerToolAuthorizeRequestSubjectType["AGENT"] = "agent";
25
+ })(McpServerToolAuthorizeRequestSubjectType || (exports.McpServerToolAuthorizeRequestSubjectType = McpServerToolAuthorizeRequestSubjectType = {}));
@@ -0,0 +1,31 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { McpServerToolAuthorizeRequestSubject } from './mcp-server-tool-authorize-request-subject';
13
+ /**
14
+ *
15
+ * @export
16
+ * @interface McpServerToolAuthorizeRequest
17
+ */
18
+ export interface McpServerToolAuthorizeRequest {
19
+ /**
20
+ *
21
+ * @type {McpServerToolAuthorizeRequestSubject}
22
+ * @memberof McpServerToolAuthorizeRequest
23
+ */
24
+ 'subject': McpServerToolAuthorizeRequestSubject;
25
+ /**
26
+ *
27
+ * @type {string}
28
+ * @memberof McpServerToolAuthorizeRequest
29
+ */
30
+ 'tool': string;
31
+ }
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,36 @@
1
+ /**
2
+ * LumoAuth API
3
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
4
+ *
5
+ * The version of the OpenAPI document: 1.0.0
6
+ * Contact: sdk@lumoauth.dev
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface McpServerToolAuthorizeResponse
16
+ */
17
+ export interface McpServerToolAuthorizeResponse {
18
+ /**
19
+ *
20
+ * @type {boolean}
21
+ * @memberof McpServerToolAuthorizeResponse
22
+ */
23
+ 'allowed'?: boolean;
24
+ /**
25
+ *
26
+ * @type {object}
27
+ * @memberof McpServerToolAuthorizeResponse
28
+ */
29
+ 'subject'?: object;
30
+ /**
31
+ *
32
+ * @type {object}
33
+ * @memberof McpServerToolAuthorizeResponse
34
+ */
35
+ 'resource'?: object;
36
+ }
@@ -0,0 +1,15 @@
1
+ "use strict";
2
+ /* tslint:disable */
3
+ /* eslint-disable */
4
+ /**
5
+ * LumoAuth API
6
+ * LumoAuth REST API — authentication, authorization, agent registry, MCP server authorization, and tenant administration. Multi-tenant: most paths are scoped under `/orgs/{orgId}/api/v1/...`.
7
+ *
8
+ * The version of the OpenAPI document: 1.0.0
9
+ * Contact: sdk@lumoauth.dev
10
+ *
11
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
12
+ * https://openapi-generator.tech
13
+ * Do not edit the class manually.
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -58,6 +58,12 @@ export interface McpServer {
58
58
  * @memberof McpServer
59
59
  */
60
60
  'transport'?: string;
61
+ /**
62
+ * True for http_sse, deprecated in MCP 2026-07-28; migrate to http_streamable.
63
+ * @type {boolean}
64
+ * @memberof McpServer
65
+ */
66
+ 'transport_deprecated'?: boolean;
61
67
  /**
62
68
  *
63
69
  * @type {string}
@@ -84,12 +90,24 @@ export interface McpServer {
84
90
  'scope_descriptions'?: {
85
91
  [key: string]: string;
86
92
  };
93
+ /**
94
+ * Subset of scopes_supported advertised in the 401 challenge and in protected resource metadata. Empty = the whole vocabulary.
95
+ * @type {Array<string>}
96
+ * @memberof McpServer
97
+ */
98
+ 'basic_scopes'?: Array<string>;
87
99
  /**
88
100
  *
89
101
  * @type {Array<string>}
90
102
  * @memberof McpServer
91
103
  */
92
104
  'allowed_client_ids'?: Array<string>;
105
+ /**
106
+ * The MCP server\'s own OAuth clients allowed to call the per-tool authorization endpoint.
107
+ * @type {Array<string>}
108
+ * @memberof McpServer
109
+ */
110
+ 'tool_authorizer_client_ids'?: Array<string>;
93
111
  /**
94
112
  *
95
113
  * @type {boolean}
@@ -166,7 +166,7 @@ export interface OpenIdConfiguration {
166
166
  */
167
167
  'ui_locales_supported'?: Array<string>;
168
168
  /**
169
- * The four MFA tier ACR values, unless overridden in organization settings.
169
+ * The four MFA tier ACR values plus the single-factor urn:lumoauth:acr:pwd (any signed-in session), unless overridden in organization settings.
170
170
  * @type {Array<string>}
171
171
  * @memberof OpenIdConfiguration
172
172
  */
@@ -304,7 +304,7 @@ export interface OpenIdConfiguration {
304
304
  */
305
305
  'entity_profiles_supported'?: Array<string>;
306
306
  /**
307
- * Only when CIMD is enabled for the organization.
307
+ * Present (true) unless the organization switched Client ID Metadata Documents off.
308
308
  * @type {boolean}
309
309
  * @memberof OpenIdConfiguration
310
310
  */
@@ -23,7 +23,7 @@ export interface ProtectedResourceMetadata {
23
23
  */
24
24
  'resource': string;
25
25
  /**
26
- * This organization\'s authorization server metadata URL.
26
+ * 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.
27
27
  * @type {Array<string>}
28
28
  * @memberof ProtectedResourceMetadata
29
29
  */
@@ -34,11 +34,17 @@ export interface PushEnrollmentStarted {
34
34
  */
35
35
  'qr_data_uri'?: string;
36
36
  /**
37
- *
37
+ * https://<server>/push-auth/enroll?d=… — an Android App Link / iOS Universal Link that opens the authenticator app on a phone (falls back to a help page without it).
38
38
  * @type {string}
39
39
  * @memberof PushEnrollmentStarted
40
40
  */
41
41
  'deep_link'?: string;
42
+ /**
43
+ * Same link as an intent:// URL pinned to the Android app package, for pages served from this host (Chrome keeps same-site App Links in the browser). Null when the deployment has not configured the package.
44
+ * @type {string}
45
+ * @memberof PushEnrollmentStarted
46
+ */
47
+ 'deep_link_android'?: string | null;
42
48
  /**
43
49
  *
44
50
  * @type {string}
@@ -23,7 +23,7 @@ export interface SingleServerMetadata {
23
23
  */
24
24
  'resource': string;
25
25
  /**
26
- *
26
+ * The organization\'s issuer identifier (RFC 8414).
27
27
  * @type {Array<string>}
28
28
  * @memberof SingleServerMetadata
29
29
  */
package/docs/AAuthApi.md CHANGED
@@ -492,7 +492,7 @@ No authorization required
492
492
  # **issueAgentToken**
493
493
  > IssueAgentTokenResponse issueAgentToken(issueAgentTokenRequest)
494
494
 
495
- Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @target-uri, content-type, content-digest, authorization
495
+ Per Section 9: The agent token endpoint is the auth server\'s endpoint agents use to request auth tokens. Required HTTP signature covering: @method, @authority, @path, signature-key (plus @query when the URL has one), content-digest, content-type, authorization
496
496
 
497
497
  ### Example
498
498
 
@@ -469,7 +469,7 @@ const { status, data } = await apiInstance.adminAgentsGenerateToken(
469
469
  | Status code | Description | Response headers |
470
470
  |-------------|-------------|------------------|
471
471
  |**200** | A generated agent token. The token value is returned ONCE. | - |
472
- |**400** | Inactive agent, or requested scopes outside the agent\&#39;s capabilities. | - |
472
+ |**400** | Inactive agent, requested scopes outside the agent\&#39;s capabilities, a resource that is not an active MCP server of this organization, or expiresIn above 3600 without a resource. | - |
473
473
  |**401** | Authentication required. | - |
474
474
  |**403** | Admin privileges required. | - |
475
475
  |**404** | Tenant or agent not found. | - |
@@ -5,8 +5,9 @@
5
5
 
6
6
  Name | Type | Description | Notes
7
7
  ------------ | ------------- | ------------- | -------------
8
- **expiresIn** | **number** | Token lifetime in seconds. Default 3600, at most 2592000 (30 days). | [optional] [default to undefined]
8
+ **expiresIn** | **number** | Token lifetime in seconds. Default 3600, minimum 60, at most 86400 (24 hours). Above 3600 only together with &#x60;resource&#x60;: a long-lived token is always bound to one MCP server, never to the organization API. | [optional] [default to undefined]
9
9
  **scopes** | **Array&lt;string&gt;** | Optional subset of the agent\&#39;s capabilities to carry in the token. Omit for all of them; a scope the agent does not have is rejected with 400. | [optional] [default to undefined]
10
+ **resource** | **string** | 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\&#39;s token lifetime. Servers that require DPoP are refused with 400. | [optional] [default to undefined]
10
11
 
11
12
  ## Example
12
13
 
@@ -16,6 +17,7 @@ import { AdminAgentsGenerateTokenRequest } from '@lumoauth/api-client';
16
17
  const instance: AdminAgentsGenerateTokenRequest = {
17
18
  expiresIn,
18
19
  scopes,
20
+ resource,
19
21
  };
20
22
  ```
21
23
 
@@ -8,7 +8,9 @@ Name | Type | Description | Notes
8
8
  **accessToken** | **string** | | [optional] [default to undefined]
9
9
  **tokenType** | **string** | | [optional] [default to undefined]
10
10
  **expiresIn** | **number** | | [optional] [default to undefined]
11
+ **jti** | **string** | The token id. Written to the agent.token_issued audit event; the kill switch and a capability reduction deny-list it. | [optional] [default to undefined]
11
12
  **scopes** | **Array&lt;string&gt;** | | [optional] [default to undefined]
13
+ **resource** | **string** | The MCP server the token is bound to, when &#x60;resource&#x60; was sent. | [optional] [default to undefined]
12
14
 
13
15
  ## Example
14
16
 
@@ -19,7 +21,9 @@ const instance: AdminAgentsGenerateTokenResponseData = {
19
21
  accessToken,
20
22
  tokenType,
21
23
  expiresIn,
24
+ jti,
22
25
  scopes,
26
+ resource,
23
27
  };
24
28
  ```
25
29
 
@@ -0,0 +1,22 @@
1
+ # AdminClientsCimdCheckRequest
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **client_id** | **string** | The Client Identifier URL (https, with a path). | [default to undefined]
9
+ **refresh** | **boolean** | Ignore the cached document and fetch it again. | [optional] [default to false]
10
+
11
+ ## Example
12
+
13
+ ```typescript
14
+ import { AdminClientsCimdCheckRequest } from '@lumoauth/api-client';
15
+
16
+ const instance: AdminClientsCimdCheckRequest = {
17
+ client_id,
18
+ refresh,
19
+ };
20
+ ```
21
+
22
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -0,0 +1,20 @@
1
+ # AdminClientsCimdCheckResponse
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **data** | [**CimdCheckResult**](CimdCheckResult.md) | | [optional] [default to undefined]
9
+
10
+ ## Example
11
+
12
+ ```typescript
13
+ import { AdminClientsCimdCheckResponse } from '@lumoauth/api-client';
14
+
15
+ const instance: AdminClientsCimdCheckResponse = {
16
+ data,
17
+ };
18
+ ```
19
+
20
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
@@ -12,7 +12,7 @@ All URIs are relative to *https://app.lumoauth.dev*
12
12
  # **adminMcpServersCreate**
13
13
  > AdminMcpServersCreateResponse adminMcpServersCreate()
14
14
 
15
- Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI; must be http(s)://, no fragment endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string transport (optional) — defaults to \"http_streamable\" auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — clamped to [60, 86400] allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
15
+ Body: name (required) — display name resource_uri (required) — RFC 8707 canonical URI: https:// (http:// only for loopback), no fragment, no user info, not a LumoAuth host, unique per organization after normalisation (same rules as the portal) endpoint_url (optional) — actual MCP endpoint description (optional) scopes_supported (optional) — array OR space/comma-separated string; omnibus scopes, offline_access and admin/scim scopes are refused (422) basic_scopes (optional) — subset of scopes_supported advertised in the 401 challenge and Protected Resource Metadata; no wildcards transport (optional) — defaults to \"http_streamable\" (\"http_sse\" is deprecated in MCP 2026-07-28) auth_mode (optional) — defaults to \"oauth\" token_lifetime (optional, default 3600) — 60..86400, else 422 tool_authorizer_client_ids (optional) — the MCP server\'s own OAuth clients that may call the per-tool authorization endpoint allowed_client_ids (optional) — array of this organization\'s OAuth client ids; unknown ids are a 422 (never persisted as policy) require_pkce (optional, default true) require_resource_param (optional, default true) require_dpop (optional, default false) — RFC 9449 sender-constrained tokens only
16
16
 
17
17
  ### Example
18
18
 
@@ -4,6 +4,7 @@ All URIs are relative to *https://app.lumoauth.dev*
4
4
 
5
5
  |Method | HTTP request | Description|
6
6
  |------------- | ------------- | -------------|
7
+ |[**adminClientsCimdCheck**](#adminclientscimdcheck) | **POST** /orgs/{orgId}/api/v1/admin/clients/cimd/check | Check a Client ID Metadata Document|
7
8
  |[**createClient**](#createclient) | **POST** /orgs/{orgId}/api/v1/admin/clients | Create an OAuth client|
8
9
  |[**deleteClient**](#deleteclient) | **DELETE** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Delete an OAuth client|
9
10
  |[**disableClient**](#disableclient) | **POST** /orgs/{orgId}/api/v1/admin/clients/{clientId}/disable | Disable an OAuth client|
@@ -16,6 +17,62 @@ All URIs are relative to *https://app.lumoauth.dev*
16
17
  |[**setClientScopes**](#setclientscopes) | **PUT** /orgs/{orgId}/api/v1/admin/clients/{clientId}/scopes | Replace the scopes granted to an OAuth client|
17
18
  |[**updateClient**](#updateclient) | **PUT** /orgs/{orgId}/api/v1/admin/clients/{clientId} | Replace an OAuth client|
18
19
 
20
+ # **adminClientsCimdCheck**
21
+ > AdminClientsCimdCheckResponse adminClientsCimdCheck(adminClientsCimdCheckRequest)
22
+
23
+ Fetches and validates the metadata document at `client_id` exactly as the authorization server does (SSRF guard, domain allow-list, size and content-type limits, schema rules) and returns the effective client: redirect URIs, grant types and scopes after the organization policy is applied, plus what the document asked for that was dropped. Works even while CIMD is switched off for the organization (`enabled: false`), so a document can be validated before the switch is flipped. Nothing is registered or stored. `refresh: true` discards the cached copy first.
24
+
25
+ ### Example
26
+
27
+ ```typescript
28
+ import {
29
+ AdminOAuthClientsApi,
30
+ Configuration,
31
+ AdminClientsCimdCheckRequest
32
+ } from '@lumoauth/api-client';
33
+
34
+ const configuration = new Configuration();
35
+ const apiInstance = new AdminOAuthClientsApi(configuration);
36
+
37
+ let orgId: string; // (default to undefined)
38
+ let adminClientsCimdCheckRequest: AdminClientsCimdCheckRequest; //
39
+
40
+ const { status, data } = await apiInstance.adminClientsCimdCheck(
41
+ orgId,
42
+ adminClientsCimdCheckRequest
43
+ );
44
+ ```
45
+
46
+ ### Parameters
47
+
48
+ |Name | Type | Description | Notes|
49
+ |------------- | ------------- | ------------- | -------------|
50
+ | **adminClientsCimdCheckRequest** | **AdminClientsCimdCheckRequest**| | |
51
+ | **orgId** | [**string**] | | defaults to undefined|
52
+
53
+
54
+ ### Return type
55
+
56
+ **AdminClientsCimdCheckResponse**
57
+
58
+ ### Authorization
59
+
60
+ [ApiKeyAuth](../README.md#ApiKeyAuth), [BearerAuth](../README.md#BearerAuth)
61
+
62
+ ### HTTP request headers
63
+
64
+ - **Content-Type**: application/json
65
+ - **Accept**: application/json
66
+
67
+
68
+ ### HTTP response details
69
+ | Status code | Description | Response headers |
70
+ |-------------|-------------|------------------|
71
+ |**200** | Check result (ok&#x3D;false is still 200: the document was reachable for inspection but rejected) | - |
72
+ |**422** | validation_error: client_id missing | - |
73
+
74
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
75
+
19
76
  # **createClient**
20
77
  > CreateClientResponse createClient()
21
78
 
package/docs/AgentsApi.md CHANGED
@@ -125,7 +125,7 @@ const { status, data } = await apiInstance.attest(
125
125
  ### HTTP response details
126
126
  | Status code | Description | Response headers |
127
127
  |-------------|-------------|------------------|
128
- |**200** | Attestation accepted: a short-lived (15 minute) LumoAuth access token scoped to the agent\&#39;s capabilities. | - |
128
+ |**200** | Attestation accepted: a short-lived (15 minute) LumoAuth access token scoped to the agent\&#39;s capabilities, or to the subset named by the optional &#x60;scope&#x60; field of the request body. Sent with a &#x60;DPoP&#x60; header, the token is DPoP-bound (token_type DPoP, cnf.jkt). | - |
129
129
  |**400** | invalid_json or missing_attestation_token. | - |
130
130
  |**401** | attestation_rejected — generic for unknown agent, inactive agent / organization, or a token that failed verification. | - |
131
131
  |**403** | access_policy_denied — a conditional access policy refused the agent (reason code included). | - |
@@ -137,7 +137,7 @@ const { status, data } = await apiInstance.attest(
137
137
  # **authorizeMcp**
138
138
  > AuthorizeMcpResponse authorizeMcp(authorizeMcpRequest)
139
139
 
140
- The real request-path caller of {@see \\McpToolAuthorizationService::canInvoke()} — the piece that connects MCP authorization to agent identity. An MCP gateway/server asks \"may THIS agent invoke <server>/<tool>?\" and gets a Zanzibar-backed allow/deny (tool-level or server-wide grant). Denials and grants are both audited, closing the MCP-authorization audit blind spot. POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"invoices\", \"tool\": \"send_payment_reminder\" }
140
+ An AGENT asks about itself: \"may I invoke <server>/<tool>?\" — with its own credential, before it calls the tool. Zanzibar-backed allow/deny (tool-level or server-wide grant), audited either way. An MCP SERVER must not use this endpoint: it would have to forward the agent\'s token (MCP 2026-07-28 forbids token passthrough). Servers call POST /orgs/{orgId}/api/v1/mcp/servers/{serverId}/tools/authorize with their own client-credentials token instead ({@see \\McpAuthorizationController::authorizeTool()}). POST /orgs/{orgId}/api/v1/agents/me/mcp/authorize Body: { \"server_id\": \"mcp_0123…\", \"tool\": \"send_payment_reminder\" }
141
141
 
142
142
  ### Example
143
143
 
@@ -187,7 +187,8 @@ const { status, data } = await apiInstance.authorizeMcp(
187
187
  |-------------|-------------|------------------|
188
188
  |**200** | Allowed — the agent may invoke the tool. | - |
189
189
  |**403** | Denied — no matching per-tool or server-wide grant. | - |
190
- |**400** | server_id and tool are required, or contain forbidden characters. | - |
190
+ |**400** | server_id and tool are required, or contain forbidden characters, or are too long together. | - |
191
+ |**404** | unknown_server — server_id is not an active MCP server of this organization. | - |
191
192
 
192
193
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
193
194