@studio-foundation/runner 0.3.0-beta.1

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 (268) hide show
  1. package/ARCHITECTURE.md +53 -0
  2. package/LICENSE +663 -0
  3. package/README.md +125 -0
  4. package/configs/agents/analyst.agent.yaml +31 -0
  5. package/configs/agents/code-generator.agent.yaml +31 -0
  6. package/configs/agents/generic.agent.yaml +23 -0
  7. package/dist/__tests__/script-executor.test.d.ts +2 -0
  8. package/dist/__tests__/script-executor.test.d.ts.map +1 -0
  9. package/dist/__tests__/script-executor.test.js +173 -0
  10. package/dist/__tests__/script-executor.test.js.map +1 -0
  11. package/dist/index.d.ts +38 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +76 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/integrations/integration-loader.d.ts +20 -0
  16. package/dist/integrations/integration-loader.d.ts.map +1 -0
  17. package/dist/integrations/integration-loader.js +71 -0
  18. package/dist/integrations/integration-loader.js.map +1 -0
  19. package/dist/integrations/integration-loader.test.d.ts +2 -0
  20. package/dist/integrations/integration-loader.test.d.ts.map +1 -0
  21. package/dist/integrations/integration-loader.test.js +77 -0
  22. package/dist/integrations/integration-loader.test.js.map +1 -0
  23. package/dist/middleware/anonymization.d.ts +22 -0
  24. package/dist/middleware/anonymization.d.ts.map +1 -0
  25. package/dist/middleware/anonymization.js +37 -0
  26. package/dist/middleware/anonymization.js.map +1 -0
  27. package/dist/plugins/index.d.ts +5 -0
  28. package/dist/plugins/index.d.ts.map +1 -0
  29. package/dist/plugins/index.js +10 -0
  30. package/dist/plugins/index.js.map +1 -0
  31. package/dist/plugins/mcp-client.d.ts +19 -0
  32. package/dist/plugins/mcp-client.d.ts.map +1 -0
  33. package/dist/plugins/mcp-client.js +126 -0
  34. package/dist/plugins/mcp-client.js.map +1 -0
  35. package/dist/plugins/mcp-client.test.d.ts +2 -0
  36. package/dist/plugins/mcp-client.test.d.ts.map +1 -0
  37. package/dist/plugins/mcp-client.test.js +160 -0
  38. package/dist/plugins/mcp-client.test.js.map +1 -0
  39. package/dist/plugins/oauth-provider.d.ts +27 -0
  40. package/dist/plugins/oauth-provider.d.ts.map +1 -0
  41. package/dist/plugins/oauth-provider.js +140 -0
  42. package/dist/plugins/oauth-provider.js.map +1 -0
  43. package/dist/plugins/oauth-provider.test.d.ts +2 -0
  44. package/dist/plugins/oauth-provider.test.d.ts.map +1 -0
  45. package/dist/plugins/oauth-provider.test.js +144 -0
  46. package/dist/plugins/oauth-provider.test.js.map +1 -0
  47. package/dist/plugins/plugin-loader.d.ts +29 -0
  48. package/dist/plugins/plugin-loader.d.ts.map +1 -0
  49. package/dist/plugins/plugin-loader.js +71 -0
  50. package/dist/plugins/plugin-loader.js.map +1 -0
  51. package/dist/plugins/plugin-loader.test.d.ts +2 -0
  52. package/dist/plugins/plugin-loader.test.d.ts.map +1 -0
  53. package/dist/plugins/plugin-loader.test.js +87 -0
  54. package/dist/plugins/plugin-loader.test.js.map +1 -0
  55. package/dist/prompt-builder.d.ts +47 -0
  56. package/dist/prompt-builder.d.ts.map +1 -0
  57. package/dist/prompt-builder.js +263 -0
  58. package/dist/prompt-builder.js.map +1 -0
  59. package/dist/prompt-builder.test.d.ts +2 -0
  60. package/dist/prompt-builder.test.d.ts.map +1 -0
  61. package/dist/prompt-builder.test.js +154 -0
  62. package/dist/prompt-builder.test.js.map +1 -0
  63. package/dist/providers/anthropic.d.ts +14 -0
  64. package/dist/providers/anthropic.d.ts.map +1 -0
  65. package/dist/providers/anthropic.js +118 -0
  66. package/dist/providers/anthropic.js.map +1 -0
  67. package/dist/providers/anthropic.test.d.ts +2 -0
  68. package/dist/providers/anthropic.test.d.ts.map +1 -0
  69. package/dist/providers/anthropic.test.js +76 -0
  70. package/dist/providers/anthropic.test.js.map +1 -0
  71. package/dist/providers/mock.d.ts +17 -0
  72. package/dist/providers/mock.d.ts.map +1 -0
  73. package/dist/providers/mock.js +39 -0
  74. package/dist/providers/mock.js.map +1 -0
  75. package/dist/providers/ollama.d.ts +18 -0
  76. package/dist/providers/ollama.d.ts.map +1 -0
  77. package/dist/providers/ollama.js +155 -0
  78. package/dist/providers/ollama.js.map +1 -0
  79. package/dist/providers/ollama.test.d.ts +2 -0
  80. package/dist/providers/ollama.test.d.ts.map +1 -0
  81. package/dist/providers/ollama.test.js +123 -0
  82. package/dist/providers/ollama.test.js.map +1 -0
  83. package/dist/providers/openai-responses.d.ts +18 -0
  84. package/dist/providers/openai-responses.d.ts.map +1 -0
  85. package/dist/providers/openai-responses.js +175 -0
  86. package/dist/providers/openai-responses.js.map +1 -0
  87. package/dist/providers/openai.d.ts +16 -0
  88. package/dist/providers/openai.d.ts.map +1 -0
  89. package/dist/providers/openai.js +132 -0
  90. package/dist/providers/openai.js.map +1 -0
  91. package/dist/providers/openai.test.d.ts +2 -0
  92. package/dist/providers/openai.test.d.ts.map +1 -0
  93. package/dist/providers/openai.test.js +51 -0
  94. package/dist/providers/openai.test.js.map +1 -0
  95. package/dist/providers/provider.d.ts +42 -0
  96. package/dist/providers/provider.d.ts.map +1 -0
  97. package/dist/providers/provider.js +10 -0
  98. package/dist/providers/provider.js.map +1 -0
  99. package/dist/providers/registry.d.ts +42 -0
  100. package/dist/providers/registry.d.ts.map +1 -0
  101. package/dist/providers/registry.js +65 -0
  102. package/dist/providers/registry.js.map +1 -0
  103. package/dist/runner.d.ts +46 -0
  104. package/dist/runner.d.ts.map +1 -0
  105. package/dist/runner.js +324 -0
  106. package/dist/runner.js.map +1 -0
  107. package/dist/runner.test.d.ts +2 -0
  108. package/dist/runner.test.d.ts.map +1 -0
  109. package/dist/runner.test.js +280 -0
  110. package/dist/runner.test.js.map +1 -0
  111. package/dist/script-executor.d.ts +11 -0
  112. package/dist/script-executor.d.ts.map +1 -0
  113. package/dist/script-executor.js +85 -0
  114. package/dist/script-executor.js.map +1 -0
  115. package/dist/tools/builtin/git.d.ts +6 -0
  116. package/dist/tools/builtin/git.d.ts.map +1 -0
  117. package/dist/tools/builtin/git.js +294 -0
  118. package/dist/tools/builtin/git.js.map +1 -0
  119. package/dist/tools/builtin/patch.d.ts +6 -0
  120. package/dist/tools/builtin/patch.d.ts.map +1 -0
  121. package/dist/tools/builtin/patch.js +238 -0
  122. package/dist/tools/builtin/patch.js.map +1 -0
  123. package/dist/tools/builtin/repo-manager.d.ts +6 -0
  124. package/dist/tools/builtin/repo-manager.d.ts.map +1 -0
  125. package/dist/tools/builtin/repo-manager.js +171 -0
  126. package/dist/tools/builtin/repo-manager.js.map +1 -0
  127. package/dist/tools/builtin/search.d.ts +6 -0
  128. package/dist/tools/builtin/search.d.ts.map +1 -0
  129. package/dist/tools/builtin/search.js +104 -0
  130. package/dist/tools/builtin/search.js.map +1 -0
  131. package/dist/tools/builtin/shell.d.ts +6 -0
  132. package/dist/tools/builtin/shell.d.ts.map +1 -0
  133. package/dist/tools/builtin/shell.js +78 -0
  134. package/dist/tools/builtin/shell.js.map +1 -0
  135. package/dist/tools/builtin/studio-run.d.ts +12 -0
  136. package/dist/tools/builtin/studio-run.d.ts.map +1 -0
  137. package/dist/tools/builtin/studio-run.js +61 -0
  138. package/dist/tools/builtin/studio-run.js.map +1 -0
  139. package/dist/tools/builtin/web-search.d.ts +7 -0
  140. package/dist/tools/builtin/web-search.d.ts.map +1 -0
  141. package/dist/tools/builtin/web-search.js +94 -0
  142. package/dist/tools/builtin/web-search.js.map +1 -0
  143. package/dist/tools/builtin/web-search.test.d.ts +5 -0
  144. package/dist/tools/builtin/web-search.test.d.ts.map +1 -0
  145. package/dist/tools/builtin/web-search.test.js +90 -0
  146. package/dist/tools/builtin/web-search.test.js.map +1 -0
  147. package/dist/tools/errors.d.ts +4 -0
  148. package/dist/tools/errors.d.ts.map +1 -0
  149. package/dist/tools/errors.js +11 -0
  150. package/dist/tools/errors.js.map +1 -0
  151. package/dist/tools/errors.test.d.ts +2 -0
  152. package/dist/tools/errors.test.d.ts.map +1 -0
  153. package/dist/tools/errors.test.js +14 -0
  154. package/dist/tools/errors.test.js.map +1 -0
  155. package/dist/tools/plugin-loader.d.ts +31 -0
  156. package/dist/tools/plugin-loader.d.ts.map +1 -0
  157. package/dist/tools/plugin-loader.js +183 -0
  158. package/dist/tools/plugin-loader.js.map +1 -0
  159. package/dist/tools/plugin-loader.test.d.ts +2 -0
  160. package/dist/tools/plugin-loader.test.d.ts.map +1 -0
  161. package/dist/tools/plugin-loader.test.js +116 -0
  162. package/dist/tools/plugin-loader.test.js.map +1 -0
  163. package/dist/tools/skills/skill-loader.d.ts +23 -0
  164. package/dist/tools/skills/skill-loader.d.ts.map +1 -0
  165. package/dist/tools/skills/skill-loader.js +58 -0
  166. package/dist/tools/skills/skill-loader.js.map +1 -0
  167. package/dist/tools/skills/skill-loader.test.d.ts +2 -0
  168. package/dist/tools/skills/skill-loader.test.d.ts.map +1 -0
  169. package/dist/tools/skills/skill-loader.test.js +92 -0
  170. package/dist/tools/skills/skill-loader.test.js.map +1 -0
  171. package/dist/tools/tool-executor.d.ts +12 -0
  172. package/dist/tools/tool-executor.d.ts.map +1 -0
  173. package/dist/tools/tool-executor.js +76 -0
  174. package/dist/tools/tool-executor.js.map +1 -0
  175. package/dist/tools/tool-executor.test.d.ts +2 -0
  176. package/dist/tools/tool-executor.test.d.ts.map +1 -0
  177. package/dist/tools/tool-executor.test.js +83 -0
  178. package/dist/tools/tool-executor.test.js.map +1 -0
  179. package/dist/tools/tool-registry.d.ts +65 -0
  180. package/dist/tools/tool-registry.d.ts.map +1 -0
  181. package/dist/tools/tool-registry.js +112 -0
  182. package/dist/tools/tool-registry.js.map +1 -0
  183. package/dist/tools/yaml-executor.d.ts +22 -0
  184. package/dist/tools/yaml-executor.d.ts.map +1 -0
  185. package/dist/tools/yaml-executor.js +80 -0
  186. package/dist/tools/yaml-executor.js.map +1 -0
  187. package/dist/utils/race-signal.d.ts +6 -0
  188. package/dist/utils/race-signal.d.ts.map +1 -0
  189. package/dist/utils/race-signal.js +21 -0
  190. package/dist/utils/race-signal.js.map +1 -0
  191. package/dist/utils/race-signal.test.d.ts +2 -0
  192. package/dist/utils/race-signal.test.d.ts.map +1 -0
  193. package/dist/utils/race-signal.test.js +48 -0
  194. package/dist/utils/race-signal.test.js.map +1 -0
  195. package/package.json +36 -0
  196. package/src/__tests__/script-executor.test.ts +180 -0
  197. package/src/index.ts +68 -0
  198. package/src/integrations/integration-loader.test.ts +88 -0
  199. package/src/integrations/integration-loader.ts +68 -0
  200. package/src/middleware/anonymization.ts +38 -0
  201. package/src/plugins/index.ts +4 -0
  202. package/src/plugins/mcp-client.test.ts +148 -0
  203. package/src/plugins/mcp-client.ts +128 -0
  204. package/src/plugins/oauth-provider.test.ts +167 -0
  205. package/src/plugins/oauth-provider.ts +175 -0
  206. package/src/plugins/plugin-loader.test.ts +114 -0
  207. package/src/plugins/plugin-loader.ts +90 -0
  208. package/src/prompt-builder.test.ts +167 -0
  209. package/src/prompt-builder.ts +332 -0
  210. package/src/providers/anthropic.test.ts +101 -0
  211. package/src/providers/anthropic.ts +135 -0
  212. package/src/providers/mock.ts +57 -0
  213. package/src/providers/ollama.test.ts +166 -0
  214. package/src/providers/ollama.ts +152 -0
  215. package/src/providers/openai-responses.ts +212 -0
  216. package/src/providers/openai.test.ts +67 -0
  217. package/src/providers/openai.ts +139 -0
  218. package/src/providers/provider.ts +54 -0
  219. package/src/providers/registry.ts +77 -0
  220. package/src/runner.test.ts +343 -0
  221. package/src/runner.ts +396 -0
  222. package/src/script-executor.ts +107 -0
  223. package/src/tools/builtin/git.ts +311 -0
  224. package/src/tools/builtin/patch.ts +257 -0
  225. package/src/tools/builtin/repo-manager.ts +142 -0
  226. package/src/tools/builtin/search.ts +108 -0
  227. package/src/tools/builtin/shell.ts +82 -0
  228. package/src/tools/builtin/studio-run.ts +73 -0
  229. package/src/tools/builtin/web-search.test.ts +122 -0
  230. package/src/tools/builtin/web-search.ts +101 -0
  231. package/src/tools/errors.test.ts +12 -0
  232. package/src/tools/errors.ts +6 -0
  233. package/src/tools/plugin-loader.test.ts +130 -0
  234. package/src/tools/plugin-loader.ts +203 -0
  235. package/src/tools/skills/README.md +49 -0
  236. package/src/tools/skills/skill-loader.test.ts +106 -0
  237. package/src/tools/skills/skill-loader.ts +62 -0
  238. package/src/tools/tool-executor.test.ts +88 -0
  239. package/src/tools/tool-executor.ts +84 -0
  240. package/src/tools/tool-registry.ts +130 -0
  241. package/src/tools/yaml-executor.ts +120 -0
  242. package/src/utils/race-signal.test.ts +50 -0
  243. package/src/utils/race-signal.ts +17 -0
  244. package/templates/integrations/linear.integration.yaml +35 -0
  245. package/templates/integrations/slack.integration.yaml +22 -0
  246. package/templates/integrations/webhook.integration.yaml +17 -0
  247. package/templates/tools/git.tool.yaml +80 -0
  248. package/templates/tools/repo-manager.tool.yaml +64 -0
  249. package/templates/tools/search.tool.yaml +22 -0
  250. package/templates/tools/shell.tool.yaml +19 -0
  251. package/templates/tools/web-search.tool.yaml +24 -0
  252. package/tests/anonymization-middleware.test.ts +61 -0
  253. package/tests/anthropic.test.ts +87 -0
  254. package/tests/apply-patch.test.ts +355 -0
  255. package/tests/fixtures/tools/test-builtin.tool.yaml +14 -0
  256. package/tests/fixtures/tools/test-shell.tool.yaml +19 -0
  257. package/tests/mock-provider.test.ts +104 -0
  258. package/tests/openai.test.ts +72 -0
  259. package/tests/plugin-loader.test.ts +54 -0
  260. package/tests/prompt-builder.test.ts +468 -0
  261. package/tests/runner-anonymization.test.ts +89 -0
  262. package/tests/runner.test.ts +885 -0
  263. package/tests/studio-run.test.ts +94 -0
  264. package/tests/tool-executor.test.ts +115 -0
  265. package/tests/tool-registry.test.ts +84 -0
  266. package/tests/yaml-executor.test.ts +76 -0
  267. package/tsconfig.json +20 -0
  268. package/vitest.config.ts +7 -0
package/dist/plugins/oauth-provider.js ADDED
@@ -0,0 +1,140 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.StudioOAuthProvider = void 0;
4
+ const promises_1 = require("node:fs/promises");
5
+ const node_crypto_1 = require("node:crypto");
6
+ const node_path_1 = require("node:path");
7
+ const node_child_process_1 = require("node:child_process");
8
+ const node_http_1 = require("node:http");
9
+ function urlHash(url) {
10
+ return (0, node_crypto_1.createHash)('sha256').update(url).digest('hex').slice(0, 16);
11
+ }
12
+ class StudioOAuthProvider {
13
+ serverUrl;
14
+ storageDir;
15
+ timeoutMs;
16
+ filePath;
17
+ _codeVerifier;
18
+ _callbackPort;
19
+ constructor(serverUrl, storageDir = (0, node_path_1.join)(process.env.HOME ?? process.env.USERPROFILE ?? '/tmp', '.config', 'studio', 'oauth'), timeoutMs = 5 * 60 * 1000) {
20
+ this.serverUrl = serverUrl;
21
+ this.storageDir = storageDir;
22
+ this.timeoutMs = timeoutMs;
23
+ this.filePath = (0, node_path_1.join)(storageDir, `${urlHash(serverUrl)}.json`);
24
+ }
25
+ // --- Storage helpers ---
26
+ async load() {
27
+ try {
28
+ const raw = await (0, promises_1.readFile)(this.filePath, 'utf-8');
29
+ return JSON.parse(raw);
30
+ }
31
+ catch {
32
+ return {};
33
+ }
34
+ }
35
+ async save(data) {
36
+ await (0, promises_1.mkdir)((0, node_path_1.dirname)(this.filePath), { recursive: true });
37
+ await (0, promises_1.writeFile)(this.filePath, JSON.stringify(data, null, 2), 'utf-8');
38
+ }
39
+ // --- OAuthClientProvider: tokens ---
40
+ async tokens() {
41
+ return (await this.load()).tokens;
42
+ }
43
+ async saveTokens(tokens) {
44
+ const data = await this.load();
45
+ await this.save({ ...data, tokens });
46
+ }
47
+ // --- OAuthClientProvider: client information ---
48
+ async clientInformation() {
49
+ return (await this.load()).clientInformation;
50
+ }
51
+ async saveClientInformation(info) {
52
+ const data = await this.load();
53
+ await this.save({ ...data, clientInformation: info });
54
+ }
55
+ // --- OAuthClientProvider: PKCE ---
56
+ saveCodeVerifier(codeVerifier) {
57
+ this._codeVerifier = codeVerifier;
58
+ }
59
+ codeVerifier() {
60
+ if (this._codeVerifier === undefined) {
61
+ throw new Error('No code verifier saved for this session');
62
+ }
63
+ return this._codeVerifier;
64
+ }
65
+ // --- OAuthClientProvider: metadata ---
66
+ get redirectUrl() {
67
+ if (this._callbackPort === undefined)
68
+ return undefined;
69
+ return `http://localhost:${this._callbackPort}/callback`;
70
+ }
71
+ get clientMetadata() {
72
+ const redirectUri = this.redirectUrl ?? 'http://localhost/callback';
73
+ return {
74
+ client_name: 'Studio',
75
+ redirect_uris: [redirectUri],
76
+ };
77
+ }
78
+ redirectToAuthorization(authorizationUrl) {
79
+ const url = authorizationUrl.toString();
80
+ process.stderr.write(`\n Open this URL to authorize Studio:\n ${url}\n\n`);
81
+ const cmd = process.platform === 'darwin' ? `open "${url}"` :
82
+ process.platform === 'win32' ? `start "" "${url}"` :
83
+ `xdg-open "${url}"`;
84
+ (0, node_child_process_1.exec)(cmd, () => { });
85
+ }
86
+ // --- Callback server ---
87
+ async startCallbackServer() {
88
+ let resolveCode;
89
+ let rejectCode;
90
+ const codePromise = new Promise((res, rej) => {
91
+ resolveCode = res;
92
+ rejectCode = rej;
93
+ });
94
+ const server = (0, node_http_1.createServer)((req, res) => {
95
+ const url = new URL(req.url ?? '/', 'http://localhost');
96
+ if (url.pathname === '/callback') {
97
+ const code = url.searchParams.get('code');
98
+ if (code) {
99
+ res.writeHead(200, { 'Content-Type': 'text/html' });
100
+ res.end('<html><body><h1>Authorization successful</h1><p>You can close this tab.</p></body></html>');
101
+ resolveCode(code);
102
+ }
103
+ else {
104
+ res.writeHead(400);
105
+ res.end('Missing code parameter');
106
+ rejectCode(new Error('OAuth callback missing code parameter'));
107
+ }
108
+ }
109
+ else {
110
+ res.writeHead(404);
111
+ res.end();
112
+ }
113
+ });
114
+ await new Promise((res, rej) => {
115
+ server.listen(0, 'localhost', res);
116
+ server.on('error', rej);
117
+ });
118
+ const { port } = server.address();
119
+ this._callbackPort = port;
120
+ // Clear stale client registration — redirect_uri changes with each new port.
121
+ // SDK will re-register with the current port's redirect_uri. Tokens are preserved.
122
+ const existing = await this.load();
123
+ if (existing.clientInformation) {
124
+ await this.save({ tokens: existing.tokens });
125
+ }
126
+ const timeout = setTimeout(() => {
127
+ rejectCode(new Error('OAuth authorization timed out. Run again to retry.'));
128
+ server.close();
129
+ this._callbackPort = undefined;
130
+ }, this.timeoutMs);
131
+ const close = () => {
132
+ clearTimeout(timeout);
133
+ server.close();
134
+ this._callbackPort = undefined;
135
+ };
136
+ return { codePromise, close };
137
+ }
138
+ }
139
+ exports.StudioOAuthProvider = StudioOAuthProvider;
140
+ //# sourceMappingURL=oauth-provider.js.map
package/dist/plugins/oauth-provider.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-provider.js","sourceRoot":"","sources":["../../src/plugins/oauth-provider.ts"],"names":[],"mappings":"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"}
package/dist/plugins/oauth-provider.test.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=oauth-provider.test.d.ts.map
package/dist/plugins/oauth-provider.test.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-provider.test.d.ts","sourceRoot":"","sources":["../../src/plugins/oauth-provider.test.ts"],"names":[],"mappings":""}
package/dist/plugins/oauth-provider.test.js ADDED
@@ -0,0 +1,144 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const vitest_1 = require("vitest");
4
+ const promises_1 = require("node:fs/promises");
5
+ const node_os_1 = require("node:os");
6
+ const node_path_1 = require("node:path");
7
+ const oauth_provider_js_1 = require("./oauth-provider.js");
8
+ vitest_1.vi.mock('node:child_process', () => ({ exec: vitest_1.vi.fn() }));
9
+ let tmpDir;
10
+ (0, vitest_1.beforeEach)(async () => {
11
+ tmpDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'studio-oauth-test-'));
12
+ });
13
+ (0, vitest_1.afterEach)(async () => {
14
+ await (0, promises_1.rm)(tmpDir, { recursive: true, force: true });
15
+ });
16
+ (0, vitest_1.describe)('StudioOAuthProvider — storage', () => {
17
+ (0, vitest_1.it)('tokens() returns undefined when no file exists', async () => {
18
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
19
+ (0, vitest_1.expect)(await p.tokens()).toBeUndefined();
20
+ });
21
+ (0, vitest_1.it)('saveTokens() + tokens() round-trips correctly', async () => {
22
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
23
+ const tokens = { access_token: 'tok123', token_type: 'bearer', expires_in: 3600, refresh_token: 'ref456' };
24
+ await p.saveTokens(tokens);
25
+ (0, vitest_1.expect)(await p.tokens()).toEqual(tokens);
26
+ });
27
+ (0, vitest_1.it)('clientInformation() returns undefined when no file exists', async () => {
28
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
29
+ (0, vitest_1.expect)(await p.clientInformation()).toBeUndefined();
30
+ });
31
+ (0, vitest_1.it)('saveClientInformation() + clientInformation() round-trips correctly', async () => {
32
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
33
+ const info = { client_id: 'cid', client_secret: 'csec' };
34
+ await p.saveClientInformation(info);
35
+ (0, vitest_1.expect)(await p.clientInformation()).toEqual(info);
36
+ });
37
+ (0, vitest_1.it)('two providers with same URL share the same storage file', async () => {
38
+ const p1 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
39
+ const p2 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
40
+ await p1.saveTokens({ access_token: 'shared', token_type: 'bearer' });
41
+ (0, vitest_1.expect)(await p2.tokens()).toEqual({ access_token: 'shared', token_type: 'bearer' });
42
+ });
43
+ (0, vitest_1.it)('two providers with different URLs use different storage files', async () => {
44
+ const p1 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.linear.app/mcp', tmpDir);
45
+ const p2 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.github.com/mcp', tmpDir);
46
+ await p1.saveTokens({ access_token: 'linear-tok', token_type: 'bearer' });
47
+ (0, vitest_1.expect)(await p2.tokens()).toBeUndefined();
48
+ });
49
+ });
50
+ (0, vitest_1.describe)('StudioOAuthProvider — PKCE', () => {
51
+ (0, vitest_1.it)('codeVerifier() throws before saveCodeVerifier() is called', () => {
52
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
53
+ (0, vitest_1.expect)(() => p.codeVerifier()).toThrow();
54
+ });
55
+ (0, vitest_1.it)('saveCodeVerifier() + codeVerifier() round-trips in memory', () => {
56
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
57
+ p.saveCodeVerifier('verifier-abc');
58
+ (0, vitest_1.expect)(p.codeVerifier()).toBe('verifier-abc');
59
+ });
60
+ (0, vitest_1.it)('codeVerifier is NOT persisted across instances', async () => {
61
+ const p1 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
62
+ const p2 = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
63
+ p1.saveCodeVerifier('only-in-p1');
64
+ (0, vitest_1.expect)(() => p2.codeVerifier()).toThrow();
65
+ });
66
+ });
67
+ (0, vitest_1.describe)('StudioOAuthProvider — metadata', () => {
68
+ (0, vitest_1.it)('redirectUrl is undefined before startCallbackServer()', () => {
69
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
70
+ (0, vitest_1.expect)(p.redirectUrl).toBeUndefined();
71
+ });
72
+ (0, vitest_1.it)('clientMetadata includes redirect_uri after server starts', async () => {
73
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
74
+ const { close } = await p.startCallbackServer();
75
+ try {
76
+ const redirectUrl = p.redirectUrl;
77
+ (0, vitest_1.expect)(redirectUrl).toMatch(/^http:\/\/localhost:\d+\/callback$/);
78
+ const meta = p.clientMetadata;
79
+ (0, vitest_1.expect)(meta.client_name).toBe('Studio');
80
+ (0, vitest_1.expect)(meta.redirect_uris).toHaveLength(1);
81
+ (0, vitest_1.expect)(meta.redirect_uris[0].toString()).toMatch(/^http:\/\/localhost:\d+\/callback$/);
82
+ }
83
+ finally {
84
+ close();
85
+ }
86
+ });
87
+ });
88
+ (0, vitest_1.describe)('StudioOAuthProvider — callback server', () => {
89
+ (0, vitest_1.it)('startCallbackServer() resolves codePromise when /callback?code=X is hit', async () => {
90
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
91
+ const { codePromise, close } = await p.startCallbackServer();
92
+ const port = p.redirectUrl.match(/:(\d+)/)[1];
93
+ const res = await fetch(`http://localhost:${port}/callback?code=auth-code-123`);
94
+ (0, vitest_1.expect)(res.ok).toBe(true);
95
+ (0, vitest_1.expect)(await codePromise).toBe('auth-code-123');
96
+ close();
97
+ });
98
+ (0, vitest_1.it)('callback response contains success HTML', async () => {
99
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
100
+ const { close } = await p.startCallbackServer();
101
+ const port = p.redirectUrl.match(/:(\d+)/)[1];
102
+ const res = await fetch(`http://localhost:${port}/callback?code=x`);
103
+ const html = await res.text();
104
+ (0, vitest_1.expect)(html).toContain('Authorization successful');
105
+ close();
106
+ });
107
+ (0, vitest_1.it)('codePromise rejects after timeout', async () => {
108
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir, 50);
109
+ const { codePromise, close } = await p.startCallbackServer();
110
+ await (0, vitest_1.expect)(codePromise).rejects.toThrow('timed out');
111
+ close();
112
+ });
113
+ (0, vitest_1.it)('sets callbackPort so redirectUrl reflects the server port', async () => {
114
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
115
+ (0, vitest_1.expect)(p.redirectUrl).toBeUndefined();
116
+ const { close } = await p.startCallbackServer();
117
+ (0, vitest_1.expect)(p.redirectUrl).toMatch(/^http:\/\/localhost:\d+\/callback$/);
118
+ close();
119
+ });
120
+ (0, vitest_1.it)('clears stale clientInformation but preserves tokens on startCallbackServer()', async () => {
121
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
122
+ // Seed stale state: clientInformation with old redirect_uri + existing tokens
123
+ await p.saveClientInformation({ client_id: 'old-client', redirect_uris: ['http://localhost:9999/callback'] });
124
+ await p.saveTokens({ access_token: 'tok', token_type: 'Bearer' });
125
+ const { close } = await p.startCallbackServer();
126
+ close();
127
+ (0, vitest_1.expect)(await p.clientInformation()).toBeUndefined();
128
+ (0, vitest_1.expect)(await p.tokens()).toEqual({ access_token: 'tok', token_type: 'Bearer' });
129
+ });
130
+ });
131
+ (0, vitest_1.describe)('StudioOAuthProvider — redirectToAuthorization', () => {
132
+ (0, vitest_1.it)('prints the authorization URL to stderr', async () => {
133
+ const p = new oauth_provider_js_1.StudioOAuthProvider('https://mcp.example.com/mcp', tmpDir);
134
+ const written = [];
135
+ const spy = vitest_1.vi.spyOn(process.stderr, 'write').mockImplementation((s) => {
136
+ written.push(String(s));
137
+ return true;
138
+ });
139
+ await p.redirectToAuthorization(new URL('https://auth.example.com/authorize?foo=bar'));
140
+ spy.mockRestore();
141
+ (0, vitest_1.expect)(written.join('')).toContain('https://auth.example.com/authorize');
142
+ });
143
+ });
144
+ //# sourceMappingURL=oauth-provider.test.js.map
package/dist/plugins/oauth-provider.test.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-provider.test.js","sourceRoot":"","sources":["../../src/plugins/oauth-provider.test.ts"],"names":[],"mappings":";;AAAA,mCAAyE;AACzE,+CAA+C;AAC/C,qCAAiC;AACjC,yCAAiC;AACjC,2DAA0D;AAE1D,WAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAEzD,IAAI,MAAc,CAAC;AAEnB,IAAA,mBAAU,EAAC,KAAK,IAAI,EAAE;IACpB,MAAM,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,IAAA,kBAAS,EAAC,KAAK,IAAI,EAAE;IACnB,MAAM,IAAA,aAAE,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,IAAA,WAAE,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;QAC3G,MAAM,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;QACzD,MAAM,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtE,IAAA,eAAM,EAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,IAAA,eAAM,EAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,IAAA,WAAE,EAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACnC,IAAA,eAAM,EAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QAC1E,EAAE,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAClC,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,IAAA,WAAE,EAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,CAAC,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;YAClC,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,CAAC;YAC9B,IAAA,eAAM,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAA,eAAM,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAA,eAAM,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;QACzF,CAAC;gBAAS,CAAC;YACT,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,IAAA,WAAE,EAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAE7D,MAAM,IAAI,GAAI,CAAC,CAAC,WAAsB,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,8BAA8B,CAAC,CAAC;QAChF,IAAA,eAAM,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAA,eAAM,EAAC,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAChD,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAEhD,MAAM,IAAI,GAAI,CAAC,CAAC,WAAsB,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,kBAAkB,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAA,eAAM,EAAC,IAAI,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QACnD,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7E,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAC7D,MAAM,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvD,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,IAAA,eAAM,EAAC,CAAC,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;QACtC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAChD,IAAA,eAAM,EAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;QACpE,KAAK,EAAE,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,8EAA8E;QAC9E,MAAM,CAAC,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,gCAAgC,CAAC,EAAS,CAAC,CAAC;QACrH,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAElE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,mBAAmB,EAAE,CAAC;QAChD,KAAK,EAAE,CAAC;QAER,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC;QACpD,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,IAAA,WAAE,EAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,CAAC,GAAG,IAAI,uCAAmB,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACzE,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,WAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE;YACrE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,CAAC,uBAAuB,CAAC,IAAI,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;QAEvF,GAAG,CAAC,WAAW,EAAE,CAAC;QAClB,IAAA,eAAM,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
package/dist/plugins/plugin-loader.d.ts ADDED
@@ -0,0 +1,29 @@
1
+ export type MCPServerDef = {
2
+ type?: 'stdio';
3
+ command: string;
4
+ args?: string[];
5
+ env?: Record<string, string>;
6
+ } | {
7
+ type: 'http';
8
+ url: string;
9
+ headers?: Record<string, string>;
10
+ env?: Record<string, string>;
11
+ auth?: {
12
+ type: 'oauth';
13
+ client_id?: string;
14
+ client_secret?: string;
15
+ scope?: string;
16
+ };
17
+ };
18
+ export interface SkillContent {
19
+ name: string;
20
+ content: string;
21
+ }
22
+ export interface PluginManifest {
23
+ name: string;
24
+ path: string;
25
+ mcpServers: Record<string, MCPServerDef>;
26
+ skills: SkillContent[];
27
+ }
28
+ export declare function loadPlugins(pluginsDir: string): Promise<PluginManifest[]>;
29
+ //# sourceMappingURL=plugin-loader.d.ts.map
package/dist/plugins/plugin-loader.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-loader.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClF;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF,CAAC;AAEN,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAiB/E"}
package/dist/plugins/plugin-loader.js ADDED
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.loadPlugins = loadPlugins;
4
+ const promises_1 = require("node:fs/promises");
5
+ const node_fs_1 = require("node:fs");
6
+ const node_path_1 = require("node:path");
7
+ async function loadPlugins(pluginsDir) {
8
+ if (!(0, node_fs_1.existsSync)(pluginsDir))
9
+ return [];
10
+ let entries;
11
+ try {
12
+ entries = await (0, promises_1.readdir)(pluginsDir, { withFileTypes: true });
13
+ }
14
+ catch {
15
+ return [];
16
+ }
17
+ const manifests = [];
18
+ for (const entry of entries) {
19
+ if (!entry.isDirectory())
20
+ continue;
21
+ const pluginPath = (0, node_path_1.join)(pluginsDir, entry.name);
22
+ manifests.push(await loadPlugin(entry.name, pluginPath));
23
+ }
24
+ return manifests;
25
+ }
26
+ async function loadPlugin(name, pluginPath) {
27
+ const mcpPath = (0, node_path_1.join)(pluginPath, '.mcp.json');
28
+ let mcpServers = {};
29
+ if ((0, node_fs_1.existsSync)(mcpPath)) {
30
+ try {
31
+ const raw = await (0, promises_1.readFile)(mcpPath, 'utf-8');
32
+ const parsed = JSON.parse(raw);
33
+ // Support both .mcp.json formats:
34
+ // 1. Wrapped Studio format: { "mcpServers": { "serverName": { ... } } }
35
+ // 2. Flat Claude Code format: { "serverName": { ... } }
36
+ // This ensures compatibility with both Studio MCP configurations and
37
+ // plugins from the Claude Code sandbox that use the flat format.
38
+ // Fixes STU-122: Plugin loader should support both .mcp.json formats
39
+ if ('mcpServers' in parsed && parsed.mcpServers !== null && typeof parsed.mcpServers === 'object') {
40
+ mcpServers = parsed.mcpServers;
41
+ }
42
+ else {
43
+ mcpServers = parsed;
44
+ }
45
+ }
46
+ catch {
47
+ // Malformed .mcp.json — skip silently
48
+ }
49
+ }
50
+ const skills = await loadSkillFiles((0, node_path_1.join)(pluginPath, 'skills'));
51
+ return { name, path: pluginPath, mcpServers, skills };
52
+ }
53
+ async function loadSkillFiles(skillsDir) {
54
+ if (!(0, node_fs_1.existsSync)(skillsDir))
55
+ return [];
56
+ let files;
57
+ try {
58
+ files = await (0, promises_1.readdir)(skillsDir);
59
+ }
60
+ catch {
61
+ return [];
62
+ }
63
+ const skillFiles = files.filter((f) => f.endsWith('.skill.md')).sort();
64
+ const skills = [];
65
+ for (const file of skillFiles) {
66
+ const content = await (0, promises_1.readFile)((0, node_path_1.join)(skillsDir, file), 'utf-8');
67
+ skills.push({ name: (0, node_path_1.basename)(file, '.skill.md'), content });
68
+ }
69
+ return skills;
70
+ }
71
+ //# sourceMappingURL=plugin-loader.js.map
package/dist/plugins/plugin-loader.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/plugins/plugin-loader.ts"],"names":[],"mappings":"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"}
package/dist/plugins/plugin-loader.test.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=plugin-loader.test.d.ts.map
package/dist/plugins/plugin-loader.test.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-loader.test.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-loader.test.ts"],"names":[],"mappings":""}
package/dist/plugins/plugin-loader.test.js ADDED
@@ -0,0 +1,87 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const vitest_1 = require("vitest");
4
+ const promises_1 = require("node:fs/promises");
5
+ const node_path_1 = require("node:path");
6
+ const node_os_1 = require("node:os");
7
+ const plugin_loader_js_1 = require("./plugin-loader.js");
8
+ let tmpDir;
9
+ (0, vitest_1.beforeAll)(async () => {
10
+ tmpDir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'studio-plugin-test-'));
11
+ // Plugin 1: code-review — has .mcp.json + skills
12
+ const plugin1 = (0, node_path_1.join)(tmpDir, 'code-review');
13
+ await (0, promises_1.mkdir)((0, node_path_1.join)(plugin1, 'skills'), { recursive: true });
14
+ await (0, promises_1.writeFile)((0, node_path_1.join)(plugin1, '.mcp.json'), JSON.stringify({
15
+ mcpServers: {
16
+ github: { command: 'npx', args: ['-y', '@mcp/server-github'] },
17
+ },
18
+ }));
19
+ await (0, promises_1.writeFile)((0, node_path_1.join)(plugin1, 'skills', 'review-guidelines.skill.md'), '# Review Guidelines\n\nAlways check for security issues.');
20
+ await (0, promises_1.writeFile)((0, node_path_1.join)(plugin1, 'skills', 'security-checklist.skill.md'), '# Security Checklist\n\n- Check SQL injection\n- Check XSS');
21
+ // Plugin 2: analysis — skills only, no .mcp.json
22
+ const plugin2 = (0, node_path_1.join)(tmpDir, 'analysis');
23
+ await (0, promises_1.mkdir)((0, node_path_1.join)(plugin2, 'skills'), { recursive: true });
24
+ await (0, promises_1.writeFile)((0, node_path_1.join)(plugin2, 'skills', 'analysis-tips.skill.md'), '# Analysis Tips\n\nBe thorough.');
25
+ // Plugin 3: empty — no .mcp.json, no skills
26
+ await (0, promises_1.mkdir)((0, node_path_1.join)(tmpDir, 'empty-plugin'));
27
+ // Plugin 4: flat-plugin — flat .mcp.json (Claude Code format, no mcpServers wrapper)
28
+ const plugin4 = (0, node_path_1.join)(tmpDir, 'flat-plugin');
29
+ await (0, promises_1.mkdir)(plugin4, { recursive: true });
30
+ await (0, promises_1.writeFile)((0, node_path_1.join)(plugin4, '.mcp.json'), JSON.stringify({
31
+ context7: { command: 'npx', args: ['-y', '@upstash/context7-mcp'] },
32
+ }));
33
+ });
34
+ (0, vitest_1.afterAll)(async () => {
35
+ await (0, promises_1.rm)(tmpDir, { recursive: true, force: true });
36
+ });
37
+ (0, vitest_1.describe)('loadPlugins', () => {
38
+ (0, vitest_1.it)('returns empty array when plugins dir does not exist', async () => {
39
+ const result = await (0, plugin_loader_js_1.loadPlugins)('/nonexistent/path/to/plugins');
40
+ (0, vitest_1.expect)(result).toEqual([]);
41
+ });
42
+ (0, vitest_1.it)('loads all plugin directories', async () => {
43
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
44
+ (0, vitest_1.expect)(result).toHaveLength(4);
45
+ const names = result.map((p) => p.name).sort();
46
+ (0, vitest_1.expect)(names).toEqual(['analysis', 'code-review', 'empty-plugin', 'flat-plugin']);
47
+ });
48
+ (0, vitest_1.it)('parses .mcp.json into mcpServers', async () => {
49
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
50
+ const codeReview = result.find((p) => p.name === 'code-review');
51
+ (0, vitest_1.expect)(codeReview.mcpServers).toEqual({
52
+ github: { command: 'npx', args: ['-y', '@mcp/server-github'] },
53
+ });
54
+ });
55
+ (0, vitest_1.it)('sets mcpServers to empty object when no .mcp.json', async () => {
56
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
57
+ const analysis = result.find((p) => p.name === 'analysis');
58
+ (0, vitest_1.expect)(analysis.mcpServers).toEqual({});
59
+ });
60
+ (0, vitest_1.it)('loads skill files sorted by name', async () => {
61
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
62
+ const codeReview = result.find((p) => p.name === 'code-review');
63
+ (0, vitest_1.expect)(codeReview.skills).toHaveLength(2);
64
+ (0, vitest_1.expect)(codeReview.skills[0].name).toBe('review-guidelines');
65
+ (0, vitest_1.expect)(codeReview.skills[0].content).toContain('Review Guidelines');
66
+ (0, vitest_1.expect)(codeReview.skills[1].name).toBe('security-checklist');
67
+ });
68
+ (0, vitest_1.it)('returns empty skills array when no skills dir', async () => {
69
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
70
+ const empty = result.find((p) => p.name === 'empty-plugin');
71
+ (0, vitest_1.expect)(empty.skills).toEqual([]);
72
+ (0, vitest_1.expect)(empty.mcpServers).toEqual({});
73
+ });
74
+ (0, vitest_1.it)('sets path to absolute path of plugin directory', async () => {
75
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
76
+ const codeReview = result.find((p) => p.name === 'code-review');
77
+ (0, vitest_1.expect)(codeReview.path).toBe((0, node_path_1.join)(tmpDir, 'code-review'));
78
+ });
79
+ (0, vitest_1.it)('parses flat .mcp.json without mcpServers wrapper — Claude Code format', async () => {
80
+ const result = await (0, plugin_loader_js_1.loadPlugins)(tmpDir);
81
+ const flatPlugin = result.find((p) => p.name === 'flat-plugin');
82
+ (0, vitest_1.expect)(flatPlugin.mcpServers).toEqual({
83
+ context7: { command: 'npx', args: ['-y', '@upstash/context7-mcp'] },
84
+ });
85
+ });
86
+ });
87
+ //# sourceMappingURL=plugin-loader.test.js.map
package/dist/plugins/plugin-loader.test.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-loader.test.js","sourceRoot":"","sources":["../../src/plugins/plugin-loader.test.ts"],"names":[],"mappings":";;AAAA,mCAAmE;AACnE,+CAAiE;AACjE,yCAAiC;AACjC,qCAAiC;AACjC,yDAAiD;AAEjD,IAAI,MAAc,CAAC;AAEnB,IAAA,kBAAS,EAAC,KAAK,IAAI,EAAE;IACnB,MAAM,GAAG,MAAM,IAAA,kBAAO,EAAC,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE9D,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5C,MAAM,IAAA,gBAAK,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,IAAA,oBAAS,EACb,IAAA,gBAAI,EAAC,OAAO,EAAE,WAAW,CAAC,EAC1B,IAAI,CAAC,SAAS,CAAC;QACb,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE;SAC/D;KACF,CAAC,CACH,CAAC;IACF,MAAM,IAAA,oBAAS,EACb,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC,EACrD,0DAA0D,CAC3D,CAAC;IACF,MAAM,IAAA,oBAAS,EACb,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,EAAE,6BAA6B,CAAC,EACtD,4DAA4D,CAC7D,CAAC;IAEF,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,IAAA,gBAAK,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,IAAA,oBAAS,EACb,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,EAAE,wBAAwB,CAAC,EACjD,iCAAiC,CAClC,CAAC;IAEF,4CAA4C;IAC5C,MAAM,IAAA,gBAAK,EAAC,IAAA,gBAAI,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1C,qFAAqF;IACrF,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5C,MAAM,IAAA,gBAAK,EAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAA,oBAAS,EACb,IAAA,gBAAI,EAAC,OAAO,EAAE,WAAW,CAAC,EAC1B,IAAI,CAAC,SAAS,CAAC;QACb,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC,EAAE;KACpE,CAAC,CACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,KAAK,IAAI,EAAE;IAClB,MAAM,IAAA,aAAE,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAA,WAAE,EAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,8BAA8B,CAAC,CAAC;QACjE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAA,eAAM,EAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAE,CAAC;QACjE,IAAA,eAAM,EAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YACpC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC,EAAE;SAC/D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAE,CAAC;QAC5D,IAAA,eAAM,EAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAE,CAAC;QACjE,IAAA,eAAM,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC5D,IAAA,eAAM,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACpE,IAAA,eAAM,EAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAE,CAAC;QAC7D,IAAA,eAAM,EAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,IAAA,eAAM,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAE,CAAC;QACjE,IAAA,eAAM,EAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAI,EAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,MAAM,GAAG,MAAM,IAAA,8BAAW,EAAC,MAAM,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAE,CAAC;QACjE,IAAA,eAAM,EAAC,UAAU,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YACpC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,uBAAuB,CAAC,EAAE;SACpE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
package/dist/prompt-builder.d.ts ADDED
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Prompt builder - constructs messages for LLM with retry escalation
3
+ */
4
+ import type { Message, AgentConfig, OutputContract, ResolvedContextPack, ToolCall } from '@studio-foundation/contracts';
5
+ import type { SkillContent } from './tools/skills/skill-loader.js';
6
+ export interface ExecutionContext {
7
+ attempt: number;
8
+ previous_failures?: Array<{
9
+ error: string;
10
+ tool_calls_count: number;
11
+ }>;
12
+ }
13
+ export interface TaskInput {
14
+ description: string;
15
+ expected_output?: string;
16
+ contract_name?: string;
17
+ }
18
+ export interface GroupFeedbackContext {
19
+ iteration: number;
20
+ max_iterations: number;
21
+ rejection_reason: string;
22
+ rejection_details?: string[];
23
+ }
24
+ export interface AgentContext {
25
+ previous_outputs?: Record<string, unknown>;
26
+ previous_tool_results?: Record<string, ToolCall[]>;
27
+ repo_files?: string[];
28
+ additional_context?: string;
29
+ group_feedback?: GroupFeedbackContext;
30
+ context_packs?: ResolvedContextPack[];
31
+ startup_context?: Record<string, string>;
32
+ stage_name?: string;
33
+ }
34
+ export interface PromptBuildConfig {
35
+ agent: AgentConfig;
36
+ task: TaskInput;
37
+ context: AgentContext;
38
+ executionContext?: ExecutionContext;
39
+ outputContract?: OutputContract;
40
+ promptSnippets?: string[];
41
+ skills?: SkillContent[];
42
+ }
43
+ /**
44
+ * Build prompt messages with retry escalation support
45
+ */
46
+ export declare function buildPrompt(config: PromptBuildConfig): Message[];
47
+ //# sourceMappingURL=prompt-builder.d.ts.map
package/dist/prompt-builder.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../src/prompt-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,EAAE,CA+IhE"}