@dual-os/cli 0.0.0-stage → 0.11.0-next.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 (254) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +15 -2
  3. package/dist/_virtual/_rolldown/runtime.js +13 -0
  4. package/dist/auth/credentials.d.ts +17 -0
  5. package/dist/auth/credentials.d.ts.map +1 -0
  6. package/dist/auth/credentials.js +57 -0
  7. package/dist/auth/credentials.js.map +1 -0
  8. package/dist/auth/destination.d.ts +22 -0
  9. package/dist/auth/destination.d.ts.map +1 -0
  10. package/dist/auth/destination.js +49 -0
  11. package/dist/auth/destination.js.map +1 -0
  12. package/dist/auth/http.d.ts +12 -0
  13. package/dist/auth/http.d.ts.map +1 -0
  14. package/dist/auth/http.js +34 -0
  15. package/dist/auth/http.js.map +1 -0
  16. package/dist/auth/login.d.ts +22 -0
  17. package/dist/auth/login.d.ts.map +1 -0
  18. package/dist/auth/login.js +98 -0
  19. package/dist/auth/login.js.map +1 -0
  20. package/dist/auth/protocol.d.ts +26 -0
  21. package/dist/auth/protocol.d.ts.map +1 -0
  22. package/dist/auth/protocol.js +31 -0
  23. package/dist/auth/protocol.js.map +1 -0
  24. package/dist/baseline.d.ts +18 -0
  25. package/dist/baseline.d.ts.map +1 -0
  26. package/dist/baseline.js +22 -0
  27. package/dist/baseline.js.map +1 -0
  28. package/dist/bin.d.ts +1 -0
  29. package/dist/bin.js +7 -0
  30. package/dist/bin.js.map +1 -0
  31. package/dist/cli.d.ts +19 -0
  32. package/dist/cli.d.ts.map +1 -0
  33. package/dist/cli.js +492 -0
  34. package/dist/cli.js.map +1 -0
  35. package/dist/create/choices.d.ts +58 -0
  36. package/dist/create/choices.d.ts.map +1 -0
  37. package/dist/create/choices.js +121 -0
  38. package/dist/create/choices.js.map +1 -0
  39. package/dist/create/deployment.d.ts +48 -0
  40. package/dist/create/deployment.d.ts.map +1 -0
  41. package/dist/create/deployment.js +66 -0
  42. package/dist/create/deployment.js.map +1 -0
  43. package/dist/create/scaffold.d.ts +57 -0
  44. package/dist/create/scaffold.d.ts.map +1 -0
  45. package/dist/create/scaffold.js +198 -0
  46. package/dist/create/scaffold.js.map +1 -0
  47. package/dist/create/source-reference.d.ts +39 -0
  48. package/dist/create/source-reference.d.ts.map +1 -0
  49. package/dist/create/source-reference.js +185 -0
  50. package/dist/create/source-reference.js.map +1 -0
  51. package/dist/create/template.d.ts +116 -0
  52. package/dist/create/template.d.ts.map +1 -0
  53. package/dist/create/template.js +211 -0
  54. package/dist/create/template.js.map +1 -0
  55. package/dist/diagnostics.d.ts +6 -0
  56. package/dist/diagnostics.d.ts.map +1 -0
  57. package/dist/diagnostics.js +18 -0
  58. package/dist/diagnostics.js.map +1 -0
  59. package/dist/help.d.ts +16 -0
  60. package/dist/help.d.ts.map +1 -0
  61. package/dist/help.js +73 -0
  62. package/dist/help.js.map +1 -0
  63. package/dist/openapi/bundle.d.ts +18 -0
  64. package/dist/openapi/bundle.d.ts.map +1 -0
  65. package/dist/openapi/bundle.js +201 -0
  66. package/dist/openapi/bundle.js.map +1 -0
  67. package/dist/openapi/discovery.d.ts +30 -0
  68. package/dist/openapi/discovery.d.ts.map +1 -0
  69. package/dist/openapi/discovery.js +325 -0
  70. package/dist/openapi/discovery.js.map +1 -0
  71. package/dist/openapi/emit.d.ts +52 -0
  72. package/dist/openapi/emit.d.ts.map +1 -0
  73. package/dist/openapi/emit.js +596 -0
  74. package/dist/openapi/emit.js.map +1 -0
  75. package/dist/openapi/graphql.d.ts +102 -0
  76. package/dist/openapi/graphql.d.ts.map +1 -0
  77. package/dist/openapi/graphql.js +294 -0
  78. package/dist/openapi/graphql.js.map +1 -0
  79. package/dist/openapi/identity.d.ts +88 -0
  80. package/dist/openapi/identity.d.ts.map +1 -0
  81. package/dist/openapi/identity.js +98 -0
  82. package/dist/openapi/identity.js.map +1 -0
  83. package/dist/openapi/mcp.d.ts +21 -0
  84. package/dist/openapi/mcp.d.ts.map +1 -0
  85. package/dist/openapi/mcp.js +133 -0
  86. package/dist/openapi/mcp.js.map +1 -0
  87. package/dist/openapi/operations.d.ts +165 -0
  88. package/dist/openapi/operations.d.ts.map +1 -0
  89. package/dist/openapi/operations.js +361 -0
  90. package/dist/openapi/operations.js.map +1 -0
  91. package/dist/openapi/overlay.d.ts +23 -0
  92. package/dist/openapi/overlay.d.ts.map +1 -0
  93. package/dist/openapi/overlay.js +115 -0
  94. package/dist/openapi/overlay.js.map +1 -0
  95. package/dist/openapi/plugin.d.ts +83 -0
  96. package/dist/openapi/plugin.d.ts.map +1 -0
  97. package/dist/openapi/plugin.js +468 -0
  98. package/dist/openapi/plugin.js.map +1 -0
  99. package/dist/openapi/polymorphism.d.ts +21 -0
  100. package/dist/openapi/polymorphism.d.ts.map +1 -0
  101. package/dist/openapi/polymorphism.js +96 -0
  102. package/dist/openapi/polymorphism.js.map +1 -0
  103. package/dist/openapi/postman.d.ts +21 -0
  104. package/dist/openapi/postman.d.ts.map +1 -0
  105. package/dist/openapi/postman.js +286 -0
  106. package/dist/openapi/postman.js.map +1 -0
  107. package/dist/openapi/schema.d.ts +178 -0
  108. package/dist/openapi/schema.d.ts.map +1 -0
  109. package/dist/openapi/schema.js +1234 -0
  110. package/dist/openapi/schema.js.map +1 -0
  111. package/dist/openapi/select.d.ts +22 -0
  112. package/dist/openapi/select.d.ts.map +1 -0
  113. package/dist/openapi/select.js +79 -0
  114. package/dist/openapi/select.js.map +1 -0
  115. package/dist/openapi/spec.d.ts +147 -0
  116. package/dist/openapi/spec.d.ts.map +1 -0
  117. package/dist/openapi/spec.js +263 -0
  118. package/dist/openapi/spec.js.map +1 -0
  119. package/dist/openapi/swagger.d.ts +166 -0
  120. package/dist/openapi/swagger.d.ts.map +1 -0
  121. package/dist/openapi/swagger.js +298 -0
  122. package/dist/openapi/swagger.js.map +1 -0
  123. package/dist/openapi/versions.d.ts +52 -0
  124. package/dist/openapi/versions.d.ts.map +1 -0
  125. package/dist/openapi/versions.js +120 -0
  126. package/dist/openapi/versions.js.map +1 -0
  127. package/dist/plugin/archive.d.ts +27 -0
  128. package/dist/plugin/archive.d.ts.map +1 -0
  129. package/dist/plugin/archive.js +170 -0
  130. package/dist/plugin/archive.js.map +1 -0
  131. package/dist/plugin/bundle.d.ts +27 -0
  132. package/dist/plugin/bundle.d.ts.map +1 -0
  133. package/dist/plugin/bundle.js +328 -0
  134. package/dist/plugin/bundle.js.map +1 -0
  135. package/dist/plugin/init.d.ts +18 -0
  136. package/dist/plugin/init.d.ts.map +1 -0
  137. package/dist/plugin/init.js +121 -0
  138. package/dist/plugin/init.js.map +1 -0
  139. package/dist/plugin/inspection.d.ts +24 -0
  140. package/dist/plugin/inspection.d.ts.map +1 -0
  141. package/dist/plugin/inspection.js +24 -0
  142. package/dist/plugin/inspection.js.map +1 -0
  143. package/dist/plugin/package.d.ts +26 -0
  144. package/dist/plugin/package.d.ts.map +1 -0
  145. package/dist/plugin/package.js +73 -0
  146. package/dist/plugin/package.js.map +1 -0
  147. package/dist/plugin/publication.d.ts +29 -0
  148. package/dist/plugin/publication.d.ts.map +1 -0
  149. package/dist/plugin/publication.js +65 -0
  150. package/dist/plugin/publication.js.map +1 -0
  151. package/dist/plugin/validation.d.ts +15 -0
  152. package/dist/plugin/validation.d.ts.map +1 -0
  153. package/dist/plugin/validation.js +119 -0
  154. package/dist/plugin/validation.js.map +1 -0
  155. package/dist/release/archives.d.ts +33 -0
  156. package/dist/release/archives.d.ts.map +1 -0
  157. package/dist/release/archives.js +81 -0
  158. package/dist/release/archives.js.map +1 -0
  159. package/dist/release/release-manifest.d.ts +182 -0
  160. package/dist/release/release-manifest.d.ts.map +1 -0
  161. package/dist/release/release-manifest.js +79 -0
  162. package/dist/release/release-manifest.js.map +1 -0
  163. package/dist/release/releases.d.ts +36 -0
  164. package/dist/release/releases.d.ts.map +1 -0
  165. package/dist/release/releases.js +122 -0
  166. package/dist/release/releases.js.map +1 -0
  167. package/dist/skills.d.ts +35 -0
  168. package/dist/skills.d.ts.map +1 -0
  169. package/dist/skills.js +257 -0
  170. package/dist/skills.js.map +1 -0
  171. package/package.json +73 -4
  172. package/skills/dual-fde/SKILL.md +38 -0
  173. package/skills/dual-fde/references/access.md +62 -0
  174. package/skills/dual-fde/references/author-plugins.md +54 -0
  175. package/skills/dual-fde/references/cli.md +97 -0
  176. package/skills/dual-fde/references/manage-plugins.md +78 -0
  177. package/skills/dual-fde/references/migrations-deployment.md +84 -0
  178. package/skills/dual-fde/references/openapi-plugins.md +47 -0
  179. package/skills/dual-fde/references/sdk-docs.md +56 -0
  180. package/skills/dual-fde/references/upgrades.md +115 -0
  181. package/skills/dual-fde/references/working-context.md +69 -0
  182. package/src/auth/credentials.ts +84 -0
  183. package/src/auth/destination.ts +83 -0
  184. package/src/auth/http.ts +39 -0
  185. package/src/auth/login.ts +177 -0
  186. package/src/auth/protocol.ts +37 -0
  187. package/src/baseline.ts +15 -0
  188. package/src/bin.ts +4 -0
  189. package/src/cli.ts +969 -0
  190. package/src/create/choices.ts +177 -0
  191. package/src/create/deployment.ts +96 -0
  192. package/src/create/scaffold.ts +334 -0
  193. package/src/create/source-reference.ts +212 -0
  194. package/src/create/template.ts +300 -0
  195. package/src/diagnostics.ts +8 -0
  196. package/src/help.ts +142 -0
  197. package/src/openapi/bundle.ts +290 -0
  198. package/src/openapi/discovery.ts +438 -0
  199. package/src/openapi/emit.ts +1031 -0
  200. package/src/openapi/graphql.ts +375 -0
  201. package/src/openapi/identity.ts +153 -0
  202. package/src/openapi/mcp.ts +165 -0
  203. package/src/openapi/operations.ts +781 -0
  204. package/src/openapi/overlay.ts +195 -0
  205. package/src/openapi/plugin.ts +856 -0
  206. package/src/openapi/polymorphism.ts +207 -0
  207. package/src/openapi/postman.ts +403 -0
  208. package/src/openapi/schema.ts +2138 -0
  209. package/src/openapi/select.ts +113 -0
  210. package/src/openapi/spec.ts +401 -0
  211. package/src/openapi/swagger.ts +422 -0
  212. package/src/openapi/versions.ts +174 -0
  213. package/src/plugin/archive.ts +244 -0
  214. package/src/plugin/bundle.ts +572 -0
  215. package/src/plugin/init.ts +178 -0
  216. package/src/plugin/inspection.ts +19 -0
  217. package/src/plugin/package.ts +140 -0
  218. package/src/plugin/publication.ts +128 -0
  219. package/src/plugin/validation.ts +213 -0
  220. package/src/release/archives.ts +133 -0
  221. package/src/release/release-manifest.ts +79 -0
  222. package/src/release/releases.ts +210 -0
  223. package/src/skills.ts +434 -0
  224. package/templates/compose/.env.compose.example.hbs +3 -0
  225. package/templates/compose/.env.host.example.hbs +4 -0
  226. package/templates/compose/Dockerfile.hbs +12 -0
  227. package/templates/compose/OPERATIONS.md.hbs +159 -0
  228. package/templates/compose/_dockerignore +14 -0
  229. package/templates/compose/compose.external.yaml +7 -0
  230. package/templates/compose/compose.host-linux.yaml +5 -0
  231. package/templates/compose/compose.host.yaml.hbs +15 -0
  232. package/templates/compose/compose.yaml.hbs +85 -0
  233. package/templates/compose/release.env.hbs +2 -0
  234. package/templates/default/.env.example.hbs +79 -0
  235. package/templates/default/README.md.hbs +150 -0
  236. package/templates/default/_gitignore +11 -0
  237. package/templates/default/packages/customer-plugin/src/Customer.ts.hbs +17 -0
  238. package/templates/default/packages/customer-plugin/tsconfig.json +15 -0
  239. package/templates/default/packages/execution-layer/src/App.ts.hbs +7 -0
  240. package/templates/default/packages/execution-layer/src/Host.ts.hbs +31 -0
  241. package/templates/default/packages/execution-layer/src/Telemetry.ts.hbs +23 -0
  242. package/templates/default/packages/execution-layer/src/api.ts.hbs +21 -0
  243. package/templates/default/packages/execution-layer/src/bootstrap.ts +22 -0
  244. package/templates/default/packages/execution-layer/src/migrate.ts +11 -0
  245. package/templates/default/packages/execution-layer/src/registry-check.ts +29 -0
  246. package/templates/default/packages/execution-layer/src/registry-sync.ts +14 -0
  247. package/templates/default/packages/execution-layer/src/worker.ts.hbs +16 -0
  248. package/templates/default/packages/execution-layer/test/app.host-test.ts.hbs +58 -0
  249. package/templates/default/packages/execution-layer/test/app.test.ts.hbs +16 -0
  250. package/templates/default/tsconfig.json +5 -0
  251. package/templates/default/vitest.config.ts +5 -0
  252. package/templates/default/vitest.host.config.ts +6 -0
  253. package/templates/opensandbox/OPEN-SANDBOX.md +25 -0
  254. package/templates/opensandbox/docker/agent-sandbox.Dockerfile +41 -0
@@ -0,0 +1,88 @@
1
+ import { Alias, Body, Parameter, Response } from "./operations.js";
2
+ import { Action } from "./schema.js";
3
+ import "./identity.js";
4
+ import { Option, Result, Schema } from "effect";
5
+ declare namespace identity_d_exports {
6
+ export { Ledger, identity_d_exports as OpenApiIdentity, resolve };
7
+ }
8
+ export type Ledger = typeof Ledger.Type;
9
+ export declare const Ledger: Schema.$Record<Schema.String, Schema.Struct<{
10
+ readonly aliases: Schema.NonEmptyArray<Schema.Struct<{
11
+ readonly method: Schema.String;
12
+ readonly operationId: Schema.String;
13
+ readonly path: Schema.String;
14
+ }>>;
15
+ readonly newIdentityFor: Schema.optionalKey<Schema.String>;
16
+ readonly source: Schema.String;
17
+ }>>;
18
+ export declare function resolve(actions: readonly (Action & {
19
+ readonly source: string;
20
+ })[], previous: Ledger, mappings: Record<string, string>): Result.Result<never, string> | Result.Result<{
21
+ actions: {
22
+ provider: string;
23
+ document: number;
24
+ source: string;
25
+ operation: {
26
+ pathSegments?: readonly string[];
27
+ preauthenticatedUpload?: boolean;
28
+ googleDownload?: boolean;
29
+ nextLink?: boolean;
30
+ alias?: Alias;
31
+ googleUpload?: {
32
+ readonly maxSize?: string;
33
+ readonly resumableUrl?: string;
34
+ };
35
+ graphql?: {
36
+ readonly document: string;
37
+ readonly endpoint: string;
38
+ readonly field: string;
39
+ };
40
+ mcp?: {
41
+ readonly endpoint: string;
42
+ readonly structured: boolean;
43
+ readonly tool: string;
44
+ };
45
+ operationId: string;
46
+ deprecated: boolean;
47
+ method: "delete" | "get" | "head" | "options" | "patch" | "post" | "put" | "trace";
48
+ path: string;
49
+ url: string;
50
+ actionName: string;
51
+ description: Option.Option<string>;
52
+ parameters: readonly Parameter[];
53
+ bodies: readonly Body[];
54
+ responses: readonly Response[];
55
+ actionId: string;
56
+ groupId: string;
57
+ };
58
+ }[];
59
+ ledger: {
60
+ [x: string]: {
61
+ readonly aliases: readonly [{
62
+ readonly method: string;
63
+ readonly operationId: string;
64
+ readonly path: string;
65
+ }, ...{
66
+ readonly method: string;
67
+ readonly operationId: string;
68
+ readonly path: string;
69
+ }[]];
70
+ readonly newIdentityFor?: string;
71
+ readonly source: string;
72
+ } | {
73
+ readonly newIdentityFor?: string;
74
+ readonly aliases: readonly [{
75
+ method: "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT" | "TRACE";
76
+ operationId: string;
77
+ path: string;
78
+ }, ...{
79
+ readonly method: string;
80
+ readonly operationId: string;
81
+ readonly path: string;
82
+ }[]];
83
+ readonly source: string;
84
+ };
85
+ };
86
+ }, never>;
87
+ export { identity_d_exports as OpenApiIdentity };
88
+ //# sourceMappingURL=identity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.d.ts","names":["OpenApiSchema.Action","_$__operations_ts0.Alias","_$__operations_ts0.Parameter","_$__operations_ts0.Body","_$__operations_ts0.Response"],"sources":["../../src/openapi/identity.ts"],"mappings":";;;;;;;YAkBY,gBAAgB,OAAO;qBACtB,QAAM,OAAA,QAAA,OAAA,QAAA,OAAA;;;;;;;;;wBAEH,QACd,mBAAmBA;WAAkC;MACrD,UAAU,QACV,UAAU,yBAAsB,OAAA,wBAAA,OAAA;;;;IAF6B;;;;;;M,QAE7BC"}
@@ -0,0 +1,98 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { hash } from "./schema.js";
3
+ import "./identity.js";
4
+ import { Array, HashSet, Option, Record, Result, Schema, String, pipe } from "effect";
5
+ // src/openapi/identity.ts
6
+ var identity_exports = /* @__PURE__ */ __exportAll({
7
+ Ledger: () => Ledger,
8
+ OpenApiIdentity: () => identity_exports,
9
+ resolve: () => resolve
10
+ });
11
+ const Alias = Schema.Struct({
12
+ method: Schema.String,
13
+ operationId: Schema.String,
14
+ path: Schema.String
15
+ });
16
+ const Entry = Schema.Struct({
17
+ aliases: Schema.NonEmptyArray(Alias),
18
+ newIdentityFor: Schema.optionalKey(Schema.String),
19
+ source: Schema.String
20
+ });
21
+ const Ledger = Schema.Record(Schema.String, Entry);
22
+ function resolve(actions, previous, mappings) {
23
+ const newIdentities = pipe(Record.toEntries(previous), Array.flatMap((entry) => entry[1].newIdentityFor === void 0 ? [] : [[entry[1].newIdentityFor, entry[0]]]), Record.fromEntries);
24
+ const aliases = Array.flatMap(Record.toEntries(previous), (entry) => Array.map(entry[1].aliases, (alias) => ({
25
+ alias,
26
+ canonical: entry[0],
27
+ source: entry[1].source
28
+ })));
29
+ const endpoints = Array.groupBy(aliases, (entry) => `${entry.source} ${entry.alias.method} ${entry.alias.path}`);
30
+ const operationIds = Array.groupBy(aliases, (entry) => `${entry.source} ${entry.alias.operationId}`);
31
+ function matchesOf(action) {
32
+ const operation = action.operation;
33
+ const source = `${action.provider}/${action.source}`;
34
+ const exact = endpoints[`${source} ${String.toUpperCase(operation.method)} ${operation.path}`] ?? [];
35
+ const renamed = String.isNonEmpty(operation.operationId) ? operationIds[`${source} ${operation.operationId}`] ?? [] : [];
36
+ return pipe(Array.isReadonlyArrayNonEmpty(exact) ? exact : renamed, Array.map((entry) => entry.canonical), Array.dedupe);
37
+ }
38
+ const claimed = HashSet.fromIterable(Array.flatMap(actions, (action) => {
39
+ const matches = matchesOf(action);
40
+ return matches.length === 1 ? matches : [];
41
+ }));
42
+ const resolved = Result.all(Array.map(actions, (action) => {
43
+ const operation = action.operation;
44
+ const source = `${action.provider}/${action.source}`;
45
+ const alias = {
46
+ method: String.toUpperCase(operation.method),
47
+ operationId: operation.operationId,
48
+ path: operation.path
49
+ };
50
+ const key = `${source} ${alias.method} ${alias.path}`;
51
+ const mapped = mappings[key];
52
+ const matches = matchesOf(action);
53
+ if (mapped !== void 0 && mapped !== "new" && previous[mapped]?.source !== source) return Result.fail(`Identity mapping ${key} must name an existing action in ${source}, or new`);
54
+ if (mapped === void 0 && matches.length > 1) return Result.fail(`Ambiguous identity for ${key}; set its identityMappings entry to the intended published action`);
55
+ const existing = mapped === "new" ? newIdentities[key] : mapped ?? Option.getOrUndefined(Array.head(matches));
56
+ const proposed = `${action.provider}/${operation.groupId}/${operation.actionId}`;
57
+ const canonical = existing ?? (Record.has(previous, proposed) && HashSet.has(claimed, proposed) ? `${proposed}-${hash(key)}` : proposed);
58
+ const parts = pipe(canonical, String.split("/"));
59
+ return Result.succeed({
60
+ action: {
61
+ ...action,
62
+ operation: {
63
+ ...operation,
64
+ actionId: Array.getUnsafe(parts, 2),
65
+ groupId: Array.getUnsafe(parts, 1)
66
+ }
67
+ },
68
+ alias,
69
+ canonical,
70
+ explicitNew: mapped === "new",
71
+ key,
72
+ source
73
+ });
74
+ }));
75
+ if (Result.isFailure(resolved)) return Result.fail(resolved.failure);
76
+ const entries = resolved.success;
77
+ const ids = HashSet.fromIterable(Array.map(entries, (entry) => entry.canonical));
78
+ if (HashSet.size(ids) !== entries.length) return Result.fail("Several source operations resolve to the same published action; supply distinct identityMappings");
79
+ const ledger = {
80
+ ...previous,
81
+ ...Record.fromEntries(Array.map(entries, (entry) => {
82
+ const previousAliases = previous[entry.canonical]?.aliases ?? [];
83
+ return [entry.canonical, {
84
+ ...previous[entry.canonical],
85
+ ...entry.explicitNew ? { newIdentityFor: entry.key } : {},
86
+ aliases: [entry.alias, ...Array.filter(previousAliases, (alias) => alias.method !== entry.alias.method || alias.path !== entry.alias.path || alias.operationId !== entry.alias.operationId)],
87
+ source: entry.source
88
+ }];
89
+ }))
90
+ };
91
+ return Result.succeed({
92
+ actions: Array.map(entries, (entry) => entry.action),
93
+ ledger
94
+ });
95
+ }
96
+ export { Ledger, identity_exports as OpenApiIdentity, resolve };
97
+
98
+ //# sourceMappingURL=identity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.js","names":["OpenApiSchema.hash"],"sources":["../../src/openapi/identity.ts"],"sourcesContent":["import { Array, HashSet, Option, Record, Result, Schema, String, pipe } from \"effect\";\n\nimport { OpenApiSchema } from \"./schema.ts\";\n\ntype Alias = typeof Alias.Type;\nconst Alias = Schema.Struct({\n method: Schema.String,\n operationId: Schema.String,\n path: Schema.String,\n});\n\ntype Entry = typeof Entry.Type;\nconst Entry = Schema.Struct({\n aliases: Schema.NonEmptyArray(Alias),\n newIdentityFor: Schema.optionalKey(Schema.String),\n source: Schema.String,\n});\n\nexport type Ledger = typeof Ledger.Type;\nexport const Ledger = Schema.Record(Schema.String, Entry);\n\nexport function resolve(\n actions: readonly (OpenApiSchema.Action & { readonly source: string })[],\n previous: Ledger,\n mappings: Record<string, string>,\n) {\n const newIdentities = pipe(\n Record.toEntries(previous),\n Array.flatMap(entry =>\n entry[1].newIdentityFor === undefined ? [] : [[entry[1].newIdentityFor, entry[0]] as const],\n ),\n Record.fromEntries,\n );\n const aliases = Array.flatMap(Record.toEntries(previous), entry =>\n Array.map(entry[1].aliases, alias => ({ alias, canonical: entry[0], source: entry[1].source })),\n );\n const endpoints = Array.groupBy(\n aliases,\n entry => `${entry.source} ${entry.alias.method} ${entry.alias.path}`,\n );\n const operationIds = Array.groupBy(\n aliases,\n entry => `${entry.source} ${entry.alias.operationId}`,\n );\n function matchesOf(action: OpenApiSchema.Action & { readonly source: string }) {\n const operation = action.operation;\n const source = `${action.provider}/${action.source}`;\n const exact =\n endpoints[`${source} ${String.toUpperCase(operation.method)} ${operation.path}`] ?? [];\n const renamed = String.isNonEmpty(operation.operationId)\n ? (operationIds[`${source} ${operation.operationId}`] ?? [])\n : [];\n return pipe(\n Array.isReadonlyArrayNonEmpty(exact) ? exact : renamed,\n Array.map(entry => entry.canonical),\n Array.dedupe,\n );\n }\n const claimed = HashSet.fromIterable(\n Array.flatMap(actions, action => {\n const matches = matchesOf(action);\n return matches.length === 1 ? matches : [];\n }),\n );\n const resolved = Result.all(\n Array.map(actions, action => {\n const operation = action.operation;\n const source = `${action.provider}/${action.source}`;\n const alias = {\n method: String.toUpperCase(operation.method),\n operationId: operation.operationId,\n path: operation.path,\n };\n const key = `${source} ${alias.method} ${alias.path}` as const;\n const mapped = mappings[key];\n const matches = matchesOf(action);\n if (mapped !== undefined && mapped !== \"new\" && previous[mapped]?.source !== source) {\n return Result.fail(\n `Identity mapping ${key} must name an existing action in ${source}, or new`,\n );\n }\n if (mapped === undefined && matches.length > 1) {\n return Result.fail(\n `Ambiguous identity for ${key}; set its identityMappings entry to the intended published action`,\n );\n }\n const existing =\n mapped === \"new\"\n ? newIdentities[key]\n : (mapped ?? Option.getOrUndefined(Array.head(matches)));\n const proposed = `${action.provider}/${operation.groupId}/${operation.actionId}`;\n // An operation whose endpoint moved keeps the action it names when that action lost its endpoint.\n const canonical =\n existing ??\n (Record.has(previous, proposed) && HashSet.has(claimed, proposed)\n ? `${proposed}-${OpenApiSchema.hash(key)}`\n : proposed);\n const parts = pipe(canonical, String.split(\"/\"));\n return Result.succeed({\n action: {\n ...action,\n operation: {\n ...operation,\n actionId: Array.getUnsafe(parts, 2),\n groupId: Array.getUnsafe(parts, 1),\n },\n },\n alias,\n canonical,\n explicitNew: mapped === \"new\",\n key,\n source,\n });\n }),\n );\n if (Result.isFailure(resolved)) return Result.fail(resolved.failure);\n const entries = resolved.success;\n const ids = HashSet.fromIterable(Array.map(entries, entry => entry.canonical));\n if (HashSet.size(ids) !== entries.length) {\n return Result.fail(\n \"Several source operations resolve to the same published action; supply distinct identityMappings\",\n );\n }\n const ledger = {\n ...previous,\n ...Record.fromEntries(\n Array.map(entries, entry => {\n const previousAliases = previous[entry.canonical]?.aliases ?? [];\n return [\n entry.canonical,\n {\n ...previous[entry.canonical],\n ...(entry.explicitNew ? { newIdentityFor: entry.key } : {}),\n aliases: [\n entry.alias,\n ...Array.filter(\n previousAliases,\n alias =>\n alias.method !== entry.alias.method ||\n alias.path !== entry.alias.path ||\n alias.operationId !== entry.alias.operationId,\n ),\n ],\n source: entry.source,\n },\n ] as const;\n }),\n ),\n };\n return Result.succeed({ actions: Array.map(entries, entry => entry.action), ledger });\n}\n\nexport * as OpenApiIdentity from \"./identity.ts\";\n"],"mappings":";;;;;;;;;;AAKA,MAAM,QAAQ,OAAO,OAAO;CAC1B,QAAQ,OAAO;CACf,aAAa,OAAO;CACpB,MAAM,OAAO;AACf,CAAC;AAGD,MAAM,QAAQ,OAAO,OAAO;CAC1B,SAAS,OAAO,cAAc,KAAK;CACnC,gBAAgB,OAAO,YAAY,OAAO,MAAM;CAChD,QAAQ,OAAO;AACjB,CAAC;AAGD,MAAa,SAAS,OAAO,OAAO,OAAO,QAAQ,KAAK;AAExD,SAAgB,QACd,SACA,UACA,UACA;CACA,MAAM,gBAAgB,KACpB,OAAO,UAAU,QAAQ,GACzB,MAAM,SAAQ,UACZ,MAAM,EAAE,CAAC,mBAAmB,KAAA,IAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,MAAM,EAAE,CAAU,CAC5F,GACA,OAAO,WACT;CACA,MAAM,UAAU,MAAM,QAAQ,OAAO,UAAU,QAAQ,IAAG,UACxD,MAAM,IAAI,MAAM,EAAE,CAAC,UAAS,WAAU;EAAE;EAAO,WAAW,MAAM;EAAI,QAAQ,MAAM,EAAE,CAAC;CAAO,EAAE,CAChG;CACA,MAAM,YAAY,MAAM,QACtB,UACA,UAAS,GAAG,MAAM,OAAO,GAAG,MAAM,MAAM,OAAO,GAAG,MAAM,MAAM,MAChE;CACA,MAAM,eAAe,MAAM,QACzB,UACA,UAAS,GAAG,MAAM,OAAO,GAAG,MAAM,MAAM,aAC1C;CACA,SAAS,UAAU,QAA4D;EAC7E,MAAM,YAAY,OAAO;EACzB,MAAM,SAAS,GAAG,OAAO,SAAS,GAAG,OAAO;EAC5C,MAAM,QACJ,UAAU,GAAG,OAAO,GAAG,OAAO,YAAY,UAAU,MAAM,EAAE,GAAG,UAAU,WAAW,CAAC;EACvF,MAAM,UAAU,OAAO,WAAW,UAAU,WAAW,IAClD,aAAa,GAAG,OAAO,GAAG,UAAU,kBAAkB,CAAC,IACxD,CAAC;EACL,OAAO,KACL,MAAM,wBAAwB,KAAK,IAAI,QAAQ,SAC/C,MAAM,KAAI,UAAS,MAAM,SAAS,GAClC,MAAM,MACR;CACF;CACA,MAAM,UAAU,QAAQ,aACtB,MAAM,QAAQ,UAAS,WAAU;EAC/B,MAAM,UAAU,UAAU,MAAM;EAChC,OAAO,QAAQ,WAAW,IAAI,UAAU,CAAC;CAC3C,CAAC,CACH;CACA,MAAM,WAAW,OAAO,IACtB,MAAM,IAAI,UAAS,WAAU;EAC3B,MAAM,YAAY,OAAO;EACzB,MAAM,SAAS,GAAG,OAAO,SAAS,GAAG,OAAO;EAC5C,MAAM,QAAQ;GACZ,QAAQ,OAAO,YAAY,UAAU,MAAM;GAC3C,aAAa,UAAU;GACvB,MAAM,UAAU;EAClB;EACA,MAAM,MAAM,GAAG,OAAO,GAAG,MAAM,OAAO,GAAG,MAAM;EAC/C,MAAM,SAAS,SAAS;EACxB,MAAM,UAAU,UAAU,MAAM;EAChC,IAAI,WAAW,KAAA,KAAa,WAAW,SAAS,SAAS,OAAO,EAAE,WAAW,QAC3E,OAAO,OAAO,KACZ,oBAAoB,IAAI,mCAAmC,OAAO,SACpE;EAEF,IAAI,WAAW,KAAA,KAAa,QAAQ,SAAS,GAC3C,OAAO,OAAO,KACZ,0BAA0B,IAAI,kEAChC;EAEF,MAAM,WACJ,WAAW,QACP,cAAc,OACb,UAAU,OAAO,eAAe,MAAM,KAAK,OAAO,CAAC;EAC1D,MAAM,WAAW,GAAG,OAAO,SAAS,GAAG,UAAU,QAAQ,GAAG,UAAU;EAEtE,MAAM,YACJ,aACC,OAAO,IAAI,UAAU,QAAQ,KAAK,QAAQ,IAAI,SAAS,QAAQ,IAC5D,GAAG,SAAS,GAAGA,KAAmB,GAAG,MACrC;EACN,MAAM,QAAQ,KAAK,WAAW,OAAO,MAAM,GAAG,CAAC;EAC/C,OAAO,OAAO,QAAQ;GACpB,QAAQ;IACN,GAAG;IACH,WAAW;KACT,GAAG;KACH,UAAU,MAAM,UAAU,OAAO,CAAC;KAClC,SAAS,MAAM,UAAU,OAAO,CAAC;IACnC;GACF;GACA;GACA;GACA,aAAa,WAAW;GACxB;GACA;EACF,CAAC;CACH,CAAC,CACH;CACA,IAAI,OAAO,UAAU,QAAQ,GAAG,OAAO,OAAO,KAAK,SAAS,OAAO;CACnE,MAAM,UAAU,SAAS;CACzB,MAAM,MAAM,QAAQ,aAAa,MAAM,IAAI,UAAS,UAAS,MAAM,SAAS,CAAC;CAC7E,IAAI,QAAQ,KAAK,GAAG,MAAM,QAAQ,QAChC,OAAO,OAAO,KACZ,kGACF;CAEF,MAAM,SAAS;EACb,GAAG;EACH,GAAG,OAAO,YACR,MAAM,IAAI,UAAS,UAAS;GAC1B,MAAM,kBAAkB,SAAS,MAAM,UAAU,EAAE,WAAW,CAAC;GAC/D,OAAO,CACL,MAAM,WACN;IACE,GAAG,SAAS,MAAM;IAClB,GAAI,MAAM,cAAc,EAAE,gBAAgB,MAAM,IAAI,IAAI,CAAC;IACzD,SAAS,CACP,MAAM,OACN,GAAG,MAAM,OACP,kBACA,UACE,MAAM,WAAW,MAAM,MAAM,UAC7B,MAAM,SAAS,MAAM,MAAM,QAC3B,MAAM,gBAAgB,MAAM,MAAM,WACtC,CACF;IACA,QAAQ,MAAM;GAChB,CACF;EACF,CAAC,CACH;CACF;CACA,OAAO,OAAO,QAAQ;EAAE,SAAS,MAAM,IAAI,UAAS,UAAS,MAAM,MAAM;EAAG;CAAO,CAAC;AACtF"}
@@ -0,0 +1,21 @@
1
+ import "./mcp.js";
2
+ import { Mcp } from "@dual-os/sdk/Mcp";
3
+ declare namespace mcp_d_exports {
4
+ export { mcp_d_exports as OpenApiMcp, toOpenApi };
5
+ }
6
+ export declare function toOpenApi(server: Mcp.Implementation, tools: Mcp.Tool[], endpoint: string): {
7
+ components: {
8
+ schemas: Record<string, unknown>;
9
+ };
10
+ info: {
11
+ title: string;
12
+ version: string;
13
+ };
14
+ openapi: string;
15
+ paths: Record<string, unknown>;
16
+ servers: {
17
+ url: string;
18
+ }[];
19
+ };
20
+ export { mcp_d_exports as OpenApiMcp };
21
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","names":[],"sources":["../../src/openapi/mcp.ts"],"mappings":";;;;;wBA4IgB,UAAU,QAAQ,IAAI,gBAAgB,OAAO,IAAI,QAAQ;;IAanE,SAAO;;;IAID;IAAoC"}
@@ -0,0 +1,133 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import "./mcp.js";
3
+ import { Array, HashSet, Option, Predicate, Record, String, pipe } from "effect";
4
+ // src/openapi/mcp.ts
5
+ var mcp_exports = /* @__PURE__ */ __exportAll({
6
+ OpenApiMcp: () => mcp_exports,
7
+ toOpenApi: () => toOpenApi
8
+ });
9
+ const content = {
10
+ properties: { content: {
11
+ items: {
12
+ properties: {
13
+ data: {
14
+ contentEncoding: "base64",
15
+ description: "The image or audio of the block",
16
+ type: "string"
17
+ },
18
+ mimeType: { type: "string" },
19
+ text: { type: "string" },
20
+ type: {
21
+ description: "text, image, audio, resource_link or resource",
22
+ type: "string"
23
+ },
24
+ uri: { type: "string" }
25
+ },
26
+ required: ["type"],
27
+ type: "object"
28
+ },
29
+ type: "array"
30
+ } },
31
+ required: ["content"],
32
+ type: "object"
33
+ };
34
+ function refersToRoot(value) {
35
+ if (Array.isArray(value)) return Array.some(value, refersToRoot);
36
+ if (!Predicate.isObject(value)) return false;
37
+ return value["$ref"] === "#" || Array.some(Record.values(value), refersToRoot);
38
+ }
39
+ /**
40
+ * Moves a tool schema's `$defs` into components under names no earlier tool took, and points its
41
+ * references there. A reference to the whole schema, `#`, makes the schema itself a component.
42
+ */
43
+ function hoisted(prefix, schema, taken) {
44
+ const definitions = Predicate.isObject(schema["$defs"]) ? schema["$defs"] : {};
45
+ function unique(reserved, name) {
46
+ return pipe(Array.makeBy(HashSet.size(reserved) + 1, (index) => index === 0 ? name : `${name}${index}`), Array.findFirst((candidate) => !HashSet.has(reserved, candidate)), Option.getOrElse(() => name));
47
+ }
48
+ const allocated = Array.reduce(Record.keys(definitions), {
49
+ names: Record.empty(),
50
+ reserved: taken
51
+ }, (done, name) => {
52
+ const unused = unique(done.reserved, `${prefix}${name}`);
53
+ return {
54
+ names: Record.set(done.names, name, unused),
55
+ reserved: HashSet.add(done.reserved, unused)
56
+ };
57
+ });
58
+ const names = allocated.names;
59
+ const rootName = unique(allocated.reserved, prefix);
60
+ function rewrite(value) {
61
+ if (Array.isArray(value)) return Array.map(value, rewrite);
62
+ if (!Predicate.isObject(value)) return value;
63
+ return Record.map(value, (entry, key) => {
64
+ if (key !== "$ref" || !Predicate.isString(entry)) return rewrite(entry);
65
+ if (entry === "#") return `#/components/schemas/${rootName}`;
66
+ const pointer = /^#\/\$defs\/([^/]+)(.*)$/u.exec(entry);
67
+ return pipe(Option.fromNullishOr(pointer?.[1]), Option.flatMap((name) => Record.get(names, name)), Option.match({
68
+ onNone: () => entry,
69
+ onSome: (name) => `#/components/schemas/${name}${pointer?.[2] ?? ""}`
70
+ }));
71
+ });
72
+ }
73
+ const own = Record.remove(schema, "$defs");
74
+ const hoistedDefinitions = Record.fromEntries(Array.map(Record.toEntries(definitions), (entry) => [Option.getOrElse(Record.get(names, entry[0]), () => entry[0]), rewrite(entry[1])]));
75
+ if (!refersToRoot(schema)) return {
76
+ definitions: hoistedDefinitions,
77
+ schema: rewrite(own)
78
+ };
79
+ return {
80
+ definitions: {
81
+ ...hoistedDefinitions,
82
+ [rootName]: rewrite(own)
83
+ },
84
+ schema: { $ref: `#/components/schemas/${rootName}` }
85
+ };
86
+ }
87
+ function convertTool(tool, endpoint, taken) {
88
+ const name = String.capitalize(tool.name);
89
+ const input = hoisted(`${name}Input`, tool.inputSchema, taken);
90
+ const output = tool.outputSchema === void 0 ? void 0 : hoisted(`${name}Output`, tool.outputSchema, HashSet.union(taken, HashSet.fromIterable(Record.keys(input.definitions))));
91
+ const required = tool.inputSchema["required"];
92
+ return {
93
+ definitions: {
94
+ ...input.definitions,
95
+ ...output?.definitions
96
+ },
97
+ path: [`/tools/${tool.name}`, { post: {
98
+ ...tool.description === void 0 ? {} : { description: tool.description },
99
+ operationId: tool.name,
100
+ requestBody: {
101
+ content: { "application/json": { schema: input.schema } },
102
+ required: Array.isArray(required) && Array.isReadonlyArrayNonEmpty(required)
103
+ },
104
+ responses: { "200": {
105
+ content: { "application/json": { schema: output?.schema ?? content } },
106
+ description: `The ${tool.name} result`
107
+ } },
108
+ summary: tool.title ?? tool.annotations?.title ?? tool.name,
109
+ tags: ["tools"],
110
+ "x-dual-mcp": {
111
+ endpoint,
112
+ structured: tool.outputSchema !== void 0,
113
+ tool: tool.name
114
+ }
115
+ } }]
116
+ };
117
+ }
118
+ function toOpenApi(server, tools, endpoint) {
119
+ const converted = Array.reduce(tools, Array.empty(), (done, tool) => Array.append(done, convertTool(tool, endpoint, HashSet.fromIterable(Array.flatMap(done, (entry) => Record.keys(entry.definitions))))));
120
+ return {
121
+ components: { schemas: Record.fromEntries(Array.flatMap(converted, (entry) => Record.toEntries(entry.definitions))) },
122
+ info: {
123
+ title: server.title ?? server.name,
124
+ version: server.version
125
+ },
126
+ openapi: "3.1.0",
127
+ paths: Record.fromEntries(Array.map(converted, (entry) => entry.path)),
128
+ servers: [{ url: endpoint }]
129
+ };
130
+ }
131
+ export { mcp_exports as OpenApiMcp, toOpenApi };
132
+
133
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","names":[],"sources":["../../src/openapi/mcp.ts"],"sourcesContent":["import { Array, HashSet, Option, Predicate, Record, String, pipe } from \"effect\";\n\nimport type { Mcp } from \"@dual-os/sdk/Mcp\";\n\ntype JsonObject = Record.ReadonlyRecord<string, unknown>;\n\nconst content = {\n properties: {\n content: {\n items: {\n properties: {\n data: {\n contentEncoding: \"base64\",\n description: \"The image or audio of the block\",\n type: \"string\",\n },\n mimeType: { type: \"string\" },\n text: { type: \"string\" },\n type: { description: \"text, image, audio, resource_link or resource\", type: \"string\" },\n uri: { type: \"string\" },\n },\n required: [\"type\"],\n type: \"object\",\n },\n type: \"array\",\n },\n },\n required: [\"content\"],\n type: \"object\",\n};\n\nfunction refersToRoot(value: unknown): boolean {\n if (Array.isArray(value)) return Array.some(value, refersToRoot);\n if (!Predicate.isObject(value)) return false;\n return value[\"$ref\"] === \"#\" || Array.some(Record.values(value), refersToRoot);\n}\n\n/**\n * Moves a tool schema's `$defs` into components under names no earlier tool took, and points its\n * references there. A reference to the whole schema, `#`, makes the schema itself a component.\n */\nfunction hoisted(prefix: string, schema: JsonObject, taken: HashSet.HashSet<string>) {\n const definitions = Predicate.isObject(schema[\"$defs\"]) ? schema[\"$defs\"] : {};\n function unique(reserved: HashSet.HashSet<string>, name: string) {\n return pipe(\n Array.makeBy(HashSet.size(reserved) + 1, index => (index === 0 ? name : `${name}${index}`)),\n Array.findFirst(candidate => !HashSet.has(reserved, candidate)),\n Option.getOrElse(() => name),\n );\n }\n // Each name is reserved as soon as it is given, so two definitions never share one.\n const allocated = Array.reduce(\n Record.keys(definitions),\n { names: Record.empty<string, string>(), reserved: taken },\n (done, name) => {\n const unused = unique(done.reserved, `${prefix}${name}`);\n return {\n names: Record.set(done.names, name, unused),\n reserved: HashSet.add(done.reserved, unused),\n };\n },\n );\n const names = allocated.names;\n const rootName = unique(allocated.reserved, prefix);\n function rewrite(value: unknown): unknown {\n if (Array.isArray(value)) return Array.map(value, rewrite);\n if (!Predicate.isObject(value)) return value;\n return Record.map(value, (entry, key) => {\n if (key !== \"$ref\" || !Predicate.isString(entry)) return rewrite(entry);\n if (entry === \"#\") return `#/components/schemas/${rootName}`;\n // A pointer into a definition keeps the segments after the definition's name.\n const pointer = /^#\\/\\$defs\\/([^/]+)(.*)$/u.exec(entry);\n return pipe(\n Option.fromNullishOr(pointer?.[1]),\n Option.flatMap(name => Record.get(names, name)),\n Option.match({\n onNone: () => entry,\n onSome: name => `#/components/schemas/${name}${pointer?.[2] ?? \"\"}`,\n }),\n );\n });\n }\n const own = Record.remove(schema, \"$defs\");\n const hoistedDefinitions = Record.fromEntries(\n Array.map(Record.toEntries(definitions), entry => [\n Option.getOrElse(Record.get(names, entry[0]), () => entry[0]),\n rewrite(entry[1]),\n ]),\n );\n if (!refersToRoot(schema)) return { definitions: hoistedDefinitions, schema: rewrite(own) };\n return {\n definitions: { ...hoistedDefinitions, [rootName]: rewrite(own) },\n schema: { $ref: `#/components/schemas/${rootName}` },\n };\n}\n\ntype Converted = {\n readonly definitions: Record.ReadonlyRecord<string, unknown>;\n readonly path: readonly [string, unknown];\n};\n\nfunction convertTool(tool: Mcp.Tool, endpoint: string, taken: HashSet.HashSet<string>): Converted {\n const name = String.capitalize(tool.name);\n const input = hoisted(`${name}Input`, tool.inputSchema, taken);\n const output =\n tool.outputSchema === undefined\n ? undefined\n : hoisted(\n `${name}Output`,\n tool.outputSchema,\n HashSet.union(taken, HashSet.fromIterable(Record.keys(input.definitions))),\n );\n const required = tool.inputSchema[\"required\"];\n return {\n definitions: { ...input.definitions, ...output?.definitions },\n path: [\n `/tools/${tool.name}`,\n {\n post: {\n ...(tool.description === undefined ? {} : { description: tool.description }),\n operationId: tool.name,\n requestBody: {\n content: { \"application/json\": { schema: input.schema } },\n required: Array.isArray(required) && Array.isReadonlyArrayNonEmpty(required),\n },\n responses: {\n \"200\": {\n content: { \"application/json\": { schema: output?.schema ?? content } },\n description: `The ${tool.name} result`,\n },\n },\n summary: tool.title ?? tool.annotations?.title ?? tool.name,\n tags: [\"tools\"],\n \"x-dual-mcp\": { endpoint, structured: tool.outputSchema !== undefined, tool: tool.name },\n },\n },\n ],\n };\n}\n\nexport function toOpenApi(server: Mcp.Implementation, tools: Mcp.Tool[], endpoint: string) {\n const converted = Array.reduce(tools, Array.empty<Converted>(), (done, tool) =>\n Array.append(\n done,\n convertTool(\n tool,\n endpoint,\n HashSet.fromIterable(Array.flatMap(done, entry => Record.keys(entry.definitions))),\n ),\n ),\n );\n return {\n components: {\n schemas: Record.fromEntries(\n Array.flatMap(converted, entry => Record.toEntries(entry.definitions)),\n ),\n },\n info: { title: server.title ?? server.name, version: server.version },\n openapi: \"3.1.0\",\n paths: Record.fromEntries(Array.map(converted, entry => entry.path)),\n servers: [{ url: endpoint }],\n };\n}\n\nexport * as OpenApiMcp from \"./mcp.ts\";\n"],"mappings":"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"}
@@ -0,0 +1,165 @@
1
+ import { Spec } from "./spec.js";
2
+ import "./operations.js";
3
+ import { Option, Schema } from "effect";
4
+ declare namespace operations_d_exports {
5
+ export { Alias, Body, operations_d_exports as OpenApiOperations, Operation, Parameter, Response, SchemaAt, walk, withReadableGroupIds, withUniqueActionIds };
6
+ }
7
+ declare const methods: readonly ["delete", "get", "head", "options", "patch", "post", "put", "trace"];
8
+ type Method = (typeof methods)[number];
9
+ interface Skipped {
10
+ readonly operation?: {
11
+ readonly method: Method;
12
+ readonly operationId: string;
13
+ };
14
+ readonly path: string;
15
+ readonly reason: string;
16
+ }
17
+ export interface SchemaAt {
18
+ readonly value: unknown;
19
+ readonly pointer: string;
20
+ }
21
+ export interface Parameter {
22
+ readonly name: string;
23
+ readonly location: "path" | "query" | "header";
24
+ readonly required: boolean;
25
+ readonly description?: string;
26
+ readonly schema: Option.Option<SchemaAt>;
27
+ readonly commaSeparated: boolean;
28
+ readonly deepObject: boolean;
29
+ readonly exploded?: boolean;
30
+ readonly delimiter?: "|" | " ";
31
+ }
32
+ type Encoding = "json" | "form" | "multipart" | "text" | "binary";
33
+ export interface Body {
34
+ readonly encoding: Encoding;
35
+ readonly contentType: string;
36
+ readonly deepObject?: readonly string[];
37
+ readonly joined?: readonly (string | [string, string])[];
38
+ readonly required: boolean;
39
+ readonly schema: Option.Option<SchemaAt>;
40
+ }
41
+ export interface Response {
42
+ readonly headers?: readonly string[];
43
+ readonly kind: "json" | "text" | "binary" | "void" | "unknown";
44
+ readonly schema: Option.Option<SchemaAt>;
45
+ readonly status: string;
46
+ readonly contentType: string;
47
+ }
48
+ export interface Operation {
49
+ readonly pathSegments?: readonly string[];
50
+ readonly preauthenticatedUpload?: boolean;
51
+ readonly googleDownload?: boolean;
52
+ readonly nextLink?: boolean;
53
+ readonly alias?: Alias;
54
+ readonly googleUpload?: GoogleUpload;
55
+ readonly graphql?: Graphql;
56
+ readonly mcp?: Mcp;
57
+ readonly operationId: string;
58
+ readonly deprecated: boolean;
59
+ readonly method: Method;
60
+ readonly path: string;
61
+ readonly url: string;
62
+ readonly groupId: string;
63
+ readonly actionId: string;
64
+ readonly actionName: string;
65
+ readonly description: Option.Option<string>;
66
+ readonly parameters: readonly Parameter[];
67
+ readonly bodies: readonly Body[];
68
+ readonly responses: readonly Response[];
69
+ }
70
+ type Alias = typeof Alias.Type;
71
+ declare const Alias: Schema.Struct<{
72
+ readonly parameter: Schema.String;
73
+ readonly prefix: Schema.String;
74
+ readonly replacement: Schema.String;
75
+ }>;
76
+ type Graphql = typeof Graphql.Type;
77
+ declare const Graphql: Schema.Struct<{
78
+ readonly document: Schema.NonEmptyString;
79
+ readonly endpoint: Schema.NonEmptyString;
80
+ readonly field: Schema.NonEmptyString;
81
+ }>;
82
+ type Mcp = typeof Mcp.Type;
83
+ declare const Mcp: Schema.Struct<{
84
+ readonly endpoint: Schema.NonEmptyString;
85
+ readonly structured: Schema.Boolean;
86
+ readonly tool: Schema.NonEmptyString;
87
+ }>;
88
+ type GoogleUpload = typeof GoogleUpload.Type;
89
+ declare const GoogleUpload: Schema.Struct<{
90
+ readonly maxSize: Schema.optionalKey<Schema.String>;
91
+ readonly resumableUrl: Schema.optionalKey<Schema.String>;
92
+ }>;
93
+ interface Source {
94
+ readonly spec: Spec;
95
+ readonly specUrl?: URL;
96
+ }
97
+ export declare function walk(source: Source): {
98
+ operations: {
99
+ pathSegments?: string[];
100
+ preauthenticatedUpload?: boolean;
101
+ googleDownload?: boolean;
102
+ nextLink?: boolean;
103
+ alias?: {
104
+ readonly parameter: string;
105
+ readonly prefix: string;
106
+ readonly replacement: string;
107
+ };
108
+ googleUpload?: {
109
+ readonly maxSize?: string;
110
+ readonly resumableUrl?: string;
111
+ };
112
+ graphql?: {
113
+ readonly document: string;
114
+ readonly endpoint: string;
115
+ readonly field: string;
116
+ };
117
+ mcp?: {
118
+ readonly endpoint: string;
119
+ readonly structured: boolean;
120
+ readonly tool: string;
121
+ };
122
+ actionId: Lowercase<string>;
123
+ actionName: string;
124
+ bodies: Body[];
125
+ deprecated: boolean;
126
+ description: Option.Option<string>;
127
+ groupId: Lowercase<string>;
128
+ method: "delete" | "get" | "head" | "options" | "patch" | "post" | "put" | "trace";
129
+ operationId: string;
130
+ parameters: Parameter[];
131
+ path: string;
132
+ responses: Response[];
133
+ url: string;
134
+ }[];
135
+ skipped: Skipped[];
136
+ };
137
+ export declare function withReadableGroupIds(documents: readonly {
138
+ readonly name: Option.Option<string>;
139
+ readonly title: string;
140
+ readonly operations: readonly Operation[];
141
+ }[]): Operation[][];
142
+ export declare function withUniqueActionIds(operations: readonly Operation[]): (Operation | {
143
+ pathSegments?: readonly string[];
144
+ preauthenticatedUpload?: boolean;
145
+ googleDownload?: boolean;
146
+ nextLink?: boolean;
147
+ alias?: Alias;
148
+ googleUpload?: GoogleUpload;
149
+ graphql?: Graphql;
150
+ mcp?: Mcp;
151
+ operationId: string;
152
+ deprecated: boolean;
153
+ method: Method;
154
+ path: string;
155
+ url: string;
156
+ groupId: string;
157
+ actionName: string;
158
+ description: Option.Option<string>;
159
+ parameters: readonly Parameter[];
160
+ bodies: readonly Body[];
161
+ responses: readonly Response[];
162
+ actionId: string;
163
+ })[];
164
+ export { Alias, operations_d_exports as OpenApiOperations };
165
+ //# sourceMappingURL=operations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operations.d.ts","names":["OpenApiSpec.Spec"],"sources":["../../src/openapi/operations.ts"],"mappings":";;;;;;cAmBM;KAED,iBAAiB;UAEZ;WACC;aAAuB,QAAQ;aAAiB;;WAChD;WACA;;iBAGM;WACN;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA,QAAQ,OAAO,OAAO;WACtB;WACA;WACA;WACA;;KAGN;iBAEY;WACN,UAAU;WACV;WACA;WACA;WACA;WACA,QAAQ,OAAO,OAAO;;iBAGhB;WACN;WACA;WACA,QAAQ,OAAO,OAAO;WACtB;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA,QAAQ;WACR,eAAe;WACf,UAAU;WACV,MAAM;WACN;WACA;WACA,QAAQ;WACR;WACA;WACA;WACA;WACA;WACA,aAAa,OAAO;WACpB,qBAAqB;WACrB,iBAAiB;WACjB,oBAAoB;;KAGnB,eAAe,MAAM;cAC3B,OAAK,OAAA;;;;;KAMN,iBAAiB,QAAQ;cACxB,SAAO,OAAA;;;;;KAMR,aAAa,IAAI;cAChB,KAAG,OAAA;;;;;KAMJ,sBAAsB,aAAa;cAClC,cAAY,OAAA;;;;UAKR;WACC,MAAMA;WACN,UAAU;;wBAgfL,KAAK,QAAQ;EAwClB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0B,SAAO;;wBAG5B,qBACd;WACW,MAAM,OAAO;WACb;WACA,qBAAqB;MAC7B;wBAoGW,oBAAoB,qBAAqB,eAAW;EAvrB1C;EACU;EACR;EACN;EACH,QAAA;EACO,eAAA;EACL,UAAA;EACJ,MAAA;EACO;EACD;EACJ,QAAA;EACF;EACD;EACI;EAEG;EACC,aAAA,OAAO;EACR,qBAAS;EACb,iBAAS;EACN,oBAAS"}