@aisac/cli 0.4.0-beta.2 → 0.4.0-beta.21

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 (47) hide show
  1. package/README.md +115 -10
  2. package/dist/assets/claude/hooks/context-compaction.ts +17 -5
  3. package/dist/assets/claude/hooks/native-host-contract-runtime.ts +1 -1
  4. package/dist/assets/claude/hooks/native-host-contract.test.ts +8 -4
  5. package/dist/assets/claude/hooks/provider-window.d.ts +83 -0
  6. package/dist/assets/codex-context-compaction.mjs +243 -5
  7. package/dist/assets/jev-paid-pilot-terminal.mjs +6 -0
  8. package/dist/claude-compatibility.mjs +26 -25
  9. package/dist/claude-observation.mjs +2 -1
  10. package/dist/cli.mjs +584 -35
  11. package/dist/codex-compatibility.mjs +48 -2
  12. package/dist/codex-engineering.mjs +165 -0
  13. package/dist/codex-hooks.mjs +411 -0
  14. package/dist/codex-permissions.mjs +67 -34
  15. package/dist/codex-protocol-fingerprint.json +11 -11
  16. package/dist/engineering-init.mjs +615 -0
  17. package/dist/engineering-pack.mjs +259 -23
  18. package/dist/engineering-scan-pins.json +42 -0
  19. package/dist/engineering-scan-report.mjs +1274 -0
  20. package/dist/engineering-scan-tools.mjs +1418 -0
  21. package/dist/engineering-scan.mjs +1265 -0
  22. package/dist/extensions-catalog.mjs +373 -0
  23. package/dist/extensions-cli.mjs +492 -0
  24. package/dist/extensions-preferences.mjs +151 -0
  25. package/dist/guardrails/continuity.mjs +239 -0
  26. package/dist/guardrails/format.mjs +111 -0
  27. package/dist/guardrails/guards.mjs +449 -0
  28. package/dist/guardrails/patch.mjs +33 -0
  29. package/dist/guardrails/run.mjs +286 -0
  30. package/dist/guardrails/shell-words.mjs +206 -0
  31. package/dist/guardrails-plugin.mjs +207 -0
  32. package/dist/launch.mjs +278 -34
  33. package/dist/managed-host.mjs +977 -0
  34. package/dist/mcp-servers.mjs +192 -0
  35. package/dist/mcp.mjs +10 -2
  36. package/dist/monitor.mjs +76 -1
  37. package/dist/package.json +1 -1
  38. package/dist/platform.mjs +78 -29
  39. package/dist/release-manifest-public-keys.json +10 -0
  40. package/dist/release-manifest.json +328 -0
  41. package/dist/release-manifest.mjs +817 -0
  42. package/dist/release-settings.mjs +210 -0
  43. package/dist/self-update.mjs +1036 -0
  44. package/dist/state.mjs +25 -1
  45. package/dist/token-guide.mjs +132 -0
  46. package/dist/update-actions.mjs +442 -0
  47. package/package.json +1 -1
@@ -0,0 +1,373 @@
1
+ // @ts-check
2
+ /**
3
+ * The AISAC Engineering extension catalog (spec aisac-engineering-extensions,
4
+ * FR1, FR2, FR7). It ships with the client and is the only source of hooks
5
+ * and MCP servers: the server and the licensed pack can neither add nor change
6
+ * entries (ADR-0048). Every change to MCP_CATALOG repeats the FR7 review
7
+ * recorded in the spec, and CODEOWNERS covers this file.
8
+ */
9
+
10
+ /** @typedef {'pt-BR' | 'en'} CatalogLocale */
11
+ /** @typedef {'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'SessionStart' | 'PreCompact' | 'Stop'} HookEvent */
12
+ /** @typedef {'block' | 'advise' | 'context'} HookMode */
13
+ /**
14
+ * @typedef {object} HookBinding
15
+ * @property {HookEvent} event
16
+ * @property {string} [matcher] Tool names (PreToolUse, PostToolUse) or SessionStart sources.
17
+ */
18
+ /**
19
+ * @typedef {object} HookEntry
20
+ * @property {string} id
21
+ * @property {HookMode} mode
22
+ * @property {boolean} defaultOn
23
+ * @property {readonly ('claude' | 'codex')[]} clients
24
+ * @property {readonly HookBinding[]} bindings
25
+ * @property {Readonly<Record<CatalogLocale, string>>} description
26
+ */
27
+
28
+ export const CATALOG_ID = /^[a-z][a-z0-9-]{0,31}$/u;
29
+
30
+ const EDIT_TOOLS = 'Edit|MultiEdit|Write';
31
+
32
+ /** @type {readonly HookEntry[]} */
33
+ export const HOOK_CATALOG = Object.freeze([
34
+ {
35
+ id: 'secrets-guard',
36
+ mode: 'block',
37
+ defaultOn: true,
38
+ clients: ['claude', 'codex'],
39
+ bindings: [
40
+ { event: 'PreToolUse', matcher: 'Read|Edit|MultiEdit|Write|NotebookEdit|Grep|Bash' },
41
+ ],
42
+ description: {
43
+ en: 'Refuses reading or writing secret files (.env, keys, credentials); decides from names only.',
44
+ 'pt-BR':
45
+ 'Recusa ler ou gravar arquivos de segredo (.env, chaves, credenciais); decide só pelo nome.',
46
+ },
47
+ },
48
+ {
49
+ id: 'git-guard',
50
+ mode: 'block',
51
+ defaultOn: false,
52
+ clients: ['claude', 'codex'],
53
+ bindings: [{ event: 'PreToolUse', matcher: 'Bash' }],
54
+ description: {
55
+ en: 'Refuses git push to main or master and force pushes (--force-with-lease passes).',
56
+ 'pt-BR': 'Recusa git push na main ou master e push forçado (--force-with-lease passa).',
57
+ },
58
+ },
59
+ {
60
+ id: 'destructive-guard',
61
+ mode: 'block',
62
+ defaultOn: false,
63
+ clients: ['claude', 'codex'],
64
+ bindings: [{ event: 'PreToolUse', matcher: 'Bash' }],
65
+ description: {
66
+ en: 'Refuses rm -rf on /, ~, . or .. and DROP DATABASE, DROP TABLE or TRUNCATE.',
67
+ 'pt-BR': 'Recusa rm -rf em /, ~, . ou .. e DROP DATABASE, DROP TABLE ou TRUNCATE.',
68
+ },
69
+ },
70
+ {
71
+ id: 'format-on-edit',
72
+ mode: 'advise',
73
+ defaultOn: false,
74
+ clients: ['claude', 'codex'],
75
+ bindings: [{ event: 'PostToolUse', matcher: EDIT_TOOLS }],
76
+ description: {
77
+ en: "Formats the edited file with the project's own formatter, when one is installed.",
78
+ 'pt-BR': 'Formata o arquivo editado com o formatador do próprio projeto, quando houver.',
79
+ },
80
+ },
81
+ {
82
+ id: 'docs-reminder',
83
+ mode: 'advise',
84
+ defaultOn: true,
85
+ clients: ['claude', 'codex'],
86
+ bindings: [{ event: 'PostToolUse', matcher: EDIT_TOOLS }, { event: 'UserPromptSubmit' }],
87
+ description: {
88
+ en: 'After a source file changes in a project with docs/, reminds once per turn to update the docs.',
89
+ 'pt-BR':
90
+ 'Quando um arquivo de código muda num projeto com docs/, lembra uma vez por turno de atualizar a documentação.',
91
+ },
92
+ },
93
+ {
94
+ id: 'session-context',
95
+ mode: 'context',
96
+ defaultOn: true,
97
+ clients: ['claude', 'codex'],
98
+ bindings: [{ event: 'SessionStart', matcher: 'startup|resume|clear' }],
99
+ description: {
100
+ en: 'Starts the session with a short repository snapshot (branch, status, recent commits).',
101
+ 'pt-BR': 'Abre a sessão com um resumo do repositório (branch, status, commits recentes).',
102
+ },
103
+ },
104
+ {
105
+ id: 'compact-continuity',
106
+ mode: 'context',
107
+ defaultOn: true,
108
+ clients: ['claude', 'codex'],
109
+ bindings: [{ event: 'PreCompact' }, { event: 'SessionStart', matcher: 'compact' }],
110
+ description: {
111
+ en: 'Saves a repository snapshot before a compaction and restores it right after.',
112
+ 'pt-BR': 'Salva um resumo do repositório antes do compact e o devolve logo depois.',
113
+ },
114
+ },
115
+ {
116
+ id: 'continuity-reminder',
117
+ mode: 'block',
118
+ defaultOn: true,
119
+ clients: ['claude', 'codex'],
120
+ bindings: [
121
+ { event: 'PostToolUse', matcher: EDIT_TOOLS },
122
+ { event: 'UserPromptSubmit' },
123
+ { event: 'Stop' },
124
+ ],
125
+ description: {
126
+ en: 'In a project with NOTES.md, asks once per turn to update NOTES.md, the spec or the CHANGELOG after code changes.',
127
+ 'pt-BR':
128
+ 'Num projeto com NOTES.md, pede uma vez por turno para atualizar NOTES.md, a spec ou o CHANGELOG depois de mudanças no código.',
129
+ },
130
+ },
131
+ ]);
132
+
133
+ /**
134
+ * Codex hook positions (spec FR6, E6b). Codex keys a user's trust and off switch
135
+ * by position (`<event>:<group>:<handler>`), so each event lists its hooks in a
136
+ * fixed order and the launcher always emits all of them. This list is
137
+ * append-only: a new hook goes at the end of its event, and a retired id stays
138
+ * in place (the dispatcher ignores an id the catalog no longer has), so a review
139
+ * the user made in `/hooks` never moves to another hook.
140
+ * @type {Readonly<Record<HookEvent, readonly string[]>>}
141
+ */
142
+ export const CODEX_HOOK_POSITIONS = Object.freeze({
143
+ PreToolUse: Object.freeze(['secrets-guard', 'git-guard', 'destructive-guard']),
144
+ PostToolUse: Object.freeze(['format-on-edit', 'docs-reminder', 'continuity-reminder']),
145
+ UserPromptSubmit: Object.freeze(['docs-reminder', 'continuity-reminder']),
146
+ SessionStart: Object.freeze(['session-context', 'compact-continuity']),
147
+ PreCompact: Object.freeze(['compact-continuity']),
148
+ Stop: Object.freeze(['continuity-reminder']),
149
+ });
150
+
151
+ /** @param {string} id @returns {HookEntry | undefined} */
152
+ export function hookById(id) {
153
+ return HOOK_CATALOG.find((entry) => entry.id === id);
154
+ }
155
+
156
+ /** @returns {string[]} */
157
+ export function hookIds() {
158
+ return HOOK_CATALOG.map((entry) => entry.id);
159
+ }
160
+
161
+ /**
162
+ * @typedef {object} McpHttpTransport
163
+ * @property {'http'} type
164
+ * @property {string} url Exact URL. Hosts key a stored login by server name and URL.
165
+ * @property {string} [bearerEnv] Environment variable that holds a bearer token. The
166
+ * catalog names it; its value is never stored or read by AISAC.
167
+ */
168
+ /**
169
+ * @typedef {object} McpStdioTransport
170
+ * @property {'stdio'} type
171
+ * @property {'npx'} command
172
+ * @property {readonly string[]} args Pinned to an exact package version (FR7).
173
+ */
174
+ /** @typedef {'host-oauth' | 'optional-oauth' | 'env-token' | 'none'} McpLogin */
175
+ /**
176
+ * @typedef {object} McpEntry
177
+ * @property {string} id
178
+ * @property {false} defaultOn Every catalog server starts off (FR7).
179
+ * @property {readonly ('claude' | 'codex')[]} clients
180
+ * @property {string} publisher
181
+ * @property {string} source The vendor's repository or documentation.
182
+ * @property {McpHttpTransport | McpStdioTransport} transport
183
+ * @property {McpLogin} login
184
+ * @property {string} [setup] A one-time command the user runs before the first use.
185
+ * @property {Readonly<Record<CatalogLocale, string>>} [loginNote] Why and how this login differs.
186
+ * @property {Readonly<Record<CatalogLocale, string>>} description
187
+ * @property {Readonly<Record<CatalogLocale, string>>} reaches What the server can reach (FR7).
188
+ * @property {readonly string[]} [blockedTools] Tools removed in both clients whatever the
189
+ * user's permission mode is (FR7.2): tools that spend money, or that would take a
190
+ * credential as an argument. Exact names.
191
+ * @property {readonly string[]} [blockedToolPrefixes] Name prefixes removed in Claude Code
192
+ * only, through a glob deny rule; Codex documents exact names only (FR7.2).
193
+ * @property {Readonly<Record<CatalogLocale, string>>} [blockedNote] Why the tools are
194
+ * blocked, when the reason is not spending; `aisac mcp info` prints it in place of the
195
+ * spending sentence (FR7.2 amendment of 2026-11-09).
196
+ */
197
+
198
+ /** Session name of a catalog server, so it never collides with the user's own. */
199
+ export const MCP_SERVER_PREFIX = 'aisac-';
200
+ const PLAYWRIGHT_PACKAGE = '@playwright/mcp@0.0.83';
201
+
202
+ /**
203
+ * MCP catalog v1 (spec FR7; the owner chose the five vendor servers on 2026-11-03)
204
+ * plus `creatives`, the AISAC Creatives Studio (owner, 2026-11-09; spec
205
+ * aisac-engineering-reels FR8, wave E7c). The review of each entry (source,
206
+ * transport, login, tools, reach) is recorded in the extensions spec (FR7.1).
207
+ * @type {readonly McpEntry[]}
208
+ */
209
+ export const MCP_CATALOG = Object.freeze([
210
+ {
211
+ id: 'github',
212
+ defaultOn: false,
213
+ clients: ['claude', 'codex'],
214
+ publisher: 'GitHub',
215
+ source: 'https://github.com/github/github-mcp-server',
216
+ transport: {
217
+ type: 'http',
218
+ url: 'https://api.githubcopilot.com/mcp/readonly',
219
+ bearerEnv: 'GITHUB_PERSONAL_ACCESS_TOKEN',
220
+ },
221
+ login: 'env-token',
222
+ loginNote: {
223
+ en: 'GitHub offers no OAuth login for Claude Code or Codex, so this server takes a personal access token. Use a fine-grained token with read-only access to only the repositories you need, and an expiry date: in Claude Code the session’s shell commands can also read this variable.',
224
+ 'pt-BR':
225
+ 'O GitHub não oferece login OAuth para o Claude Code nem para o Codex, então este servidor usa um token de acesso pessoal. Use um token fine-grained, somente leitura, só nos repositórios de que você precisa e com data de validade: no Claude Code os comandos de shell da sessão também conseguem ler essa variável.',
226
+ },
227
+ description: {
228
+ en: "GitHub's hosted server, read-only: repositories, issues, pull requests and users.",
229
+ 'pt-BR':
230
+ 'Servidor hospedado do GitHub, somente leitura: repositórios, issues, pull requests e usuários.',
231
+ },
232
+ reaches: {
233
+ en: 'Reads what your token can see: repository files, commits, branches, releases, issues, pull requests, and user and team profiles. This read-only URL exposes no write tool.',
234
+ 'pt-BR':
235
+ 'Lê o que o seu token enxerga: arquivos, commits, branches e releases dos repositórios, issues, pull requests e perfis de usuários e times. Esta URL somente leitura não expõe ferramenta de escrita.',
236
+ },
237
+ },
238
+ {
239
+ id: 'supabase',
240
+ defaultOn: false,
241
+ clients: ['claude', 'codex'],
242
+ publisher: 'Supabase',
243
+ source: 'https://github.com/supabase-community/supabase-mcp',
244
+ transport: { type: 'http', url: 'https://mcp.supabase.com/mcp?read_only=true' },
245
+ login: 'host-oauth',
246
+ // read_only=true should already leave these out; the vendor does not publish
247
+ // what it removes, so they are blocked as a second layer (FR7.2).
248
+ blockedTools: ['create_project', 'confirm_cost', 'create_branch'],
249
+ description: {
250
+ en: "Supabase's hosted server, read-only: tables, SQL, logs, advisors and docs.",
251
+ 'pt-BR':
252
+ 'Servidor hospedado da Supabase, somente leitura: tabelas, SQL, logs, advisors e documentação.',
253
+ },
254
+ reaches: {
255
+ en: 'Every organization and project of the Supabase account you log in with: database contents through read-only SQL, migrations, logs, advisors, Edge Functions, project URLs and publishable keys. read_only=true runs SQL as a read-only Postgres role and leaves out the write tools; the login grants the scopes you approve on Supabase.',
256
+ 'pt-BR':
257
+ 'Todas as organizações e projetos da conta Supabase em que você entrar: dados do banco por SQL somente leitura, migrations, logs, advisors, Edge Functions, URLs dos projetos e chaves publicáveis. read_only=true executa o SQL com um papel Postgres somente leitura e deixa de fora as ferramentas de escrita; o login concede os escopos que você aprovar na Supabase.',
258
+ },
259
+ },
260
+ {
261
+ id: 'vercel',
262
+ defaultOn: false,
263
+ clients: ['claude', 'codex'],
264
+ publisher: 'Vercel',
265
+ source: 'https://vercel.com/docs/agent-resources/vercel-mcp',
266
+ transport: { type: 'http', url: 'https://mcp.vercel.com' },
267
+ login: 'host-oauth',
268
+ // buy_domain charges the team after a quote, and its confirm flag is a model
269
+ // argument; a domain transfer may be charged (FR7.1, FR7.2).
270
+ blockedTools: ['buy_domain', 'create_or_transfer_domain'],
271
+ blockedToolPrefixes: ['buy_'],
272
+ description: {
273
+ en: "Vercel's hosted server: projects, deployments, logs, domains and environment variables.",
274
+ 'pt-BR':
275
+ 'Servidor hospedado da Vercel: projetos, deploys, logs, domínios e variáveis de ambiente.',
276
+ },
277
+ reaches: {
278
+ en: 'The teams you grant at login, with the access of your Vercel user: projects, deployments, build and runtime logs, domains and DNS, and environment variables, including decrypted values. It also has write tools (deployments, environment variables, DNS records, firewall rules, project settings) and no read-only mode, so keep the confirmation of each call on. Buying domains is blocked by AISAC.',
279
+ 'pt-BR':
280
+ 'Os times que você liberar no login, com o acesso do seu usuário Vercel: projetos, deploys, logs de build e de execução, domínios e DNS, e variáveis de ambiente, inclusive valores decifrados. Também tem ferramentas de escrita (deploys, variáveis de ambiente, registros DNS, regras de firewall, configurações de projeto) e não tem modo somente leitura, então mantenha a confirmação de cada chamada ligada. A compra de domínios é bloqueada pela AISAC.',
281
+ },
282
+ },
283
+ {
284
+ id: 'playwright',
285
+ defaultOn: false,
286
+ clients: ['claude', 'codex'],
287
+ publisher: 'Microsoft',
288
+ source: 'https://github.com/microsoft/playwright-mcp',
289
+ transport: {
290
+ type: 'stdio',
291
+ command: 'npx',
292
+ args: ['-y', PLAYWRIGHT_PACKAGE, '--browser', 'chromium', '--headless', '--isolated'],
293
+ },
294
+ login: 'none',
295
+ setup: `npx -y ${PLAYWRIGHT_PACKAGE} install-browser chrome-for-testing`,
296
+ description: {
297
+ en: 'A local headless browser driven by Playwright, for testing web pages.',
298
+ 'pt-BR': 'Um navegador local sem janela, controlado pelo Playwright, para testar páginas.',
299
+ },
300
+ reaches: {
301
+ en: 'Runs on your machine with a fresh in-memory profile each session, so no saved logins. It opens any URL the agent asks for, including localhost and your local network, can run JavaScript in the page and upload files from the project. Page content is untrusted input.',
302
+ 'pt-BR':
303
+ 'Roda na sua máquina com um perfil novo em memória a cada sessão, sem logins salvos. Abre qualquer URL que o agente pedir, inclusive localhost e a sua rede local, pode executar JavaScript na página e enviar arquivos do projeto. O conteúdo das páginas é entrada não confiável.',
304
+ },
305
+ },
306
+ {
307
+ id: 'context7',
308
+ defaultOn: false,
309
+ clients: ['claude', 'codex'],
310
+ publisher: 'Upstash',
311
+ source: 'https://github.com/upstash/context7',
312
+ transport: { type: 'http', url: 'https://mcp.context7.com/mcp' },
313
+ login: 'optional-oauth',
314
+ description: {
315
+ en: 'Up-to-date documentation and code examples for libraries, from Context7.',
316
+ 'pt-BR': 'Documentação e exemplos de código atualizados de bibliotecas, do Context7.',
317
+ },
318
+ reaches: {
319
+ en: 'Public library documentation only. What the agent asks (library names and questions) goes to Upstash, so keep secrets and private code out of those questions. It works without login, with lower rate limits.',
320
+ 'pt-BR':
321
+ 'Só documentação pública de bibliotecas. O que o agente pergunta (nomes de bibliotecas e dúvidas) vai para a Upstash, então não coloque segredos nem código privado nessas perguntas. Funciona sem login, com limites de uso menores.',
322
+ },
323
+ },
324
+ {
325
+ id: 'creatives',
326
+ defaultOn: false,
327
+ clients: ['claude', 'codex'],
328
+ publisher: 'AISAC',
329
+ source: 'https://studio.aisac.agency/',
330
+ // The URL is the OAuth resource the Studio itself publishes in its
331
+ // protected-resource metadata (read 2026-11-09, reels spec M3). The Studio
332
+ // web app lives at studio.aisac.agency, but that domain is the browser origin
333
+ // only: the MCP issuer, audience and resource stay on this host, so a token
334
+ // obtained for this URL is the one the server accepts.
335
+ transport: { type: 'http', url: 'https://mcp-creatives.vercel.app/mcp' },
336
+ login: 'host-oauth',
337
+ // The key-management tools take or delete a provider key by name. A key typed
338
+ // into a tool call would stay in the session transcript, so keys are managed
339
+ // only on the Studio keys page (reels spec D2, FR8). The generate tools spend
340
+ // on the keys the user registered there: not blocked (FR7.2 amendment).
341
+ blockedTools: ['creatives_register_key', 'creatives_revoke_key'],
342
+ blockedNote: {
343
+ en: 'Provider keys are managed only on the Studio keys page (https://studio.aisac.agency/?studio=keys): a key typed into a tool call would stay in the session transcript.',
344
+ 'pt-BR':
345
+ 'As chaves dos provedores são gerenciadas só na página de chaves do Studio (https://studio.aisac.agency/?studio=keys): uma chave digitada numa chamada de ferramenta ficaria no transcript da sessão.',
346
+ },
347
+ loginNote: {
348
+ en: 'The Studio login needs an account with access (it comes with the AISAC Engineering purchase). Register your provider keys on the Studio keys page before the first generation; the server never takes a key as an argument.',
349
+ 'pt-BR':
350
+ 'O login do Studio exige uma conta com acesso (vem com a compra do AISAC Engineering). Registre as chaves dos seus provedores na página de chaves do Studio antes da primeira geração; o servidor nunca recebe uma chave como argumento.',
351
+ },
352
+ description: {
353
+ en: 'The AISAC Creatives Studio: images, narration and video generated with your own provider keys, plus voices, influencer profiles and reel productions.',
354
+ 'pt-BR':
355
+ 'O AISAC Creatives Studio: imagens, narração e vídeo gerados com as suas próprias chaves de provedor, mais vozes, perfis de influencer e produções de reels.',
356
+ },
357
+ reaches: {
358
+ en: 'Your Studio account only: the generations, assets, voice presets, influencer profiles, Motion projects and productions you own, and the fingerprints of the provider keys you registered (never the keys). Image, audio and video generation and the Motion stages spend on your own provider keys, within the limits the Studio enforces; a Studio production spends only after an approval in the Studio web app or in the Mothership. Registering and revoking keys is blocked by AISAC.',
359
+ 'pt-BR':
360
+ 'Só a sua conta do Studio: as gerações, assets, presets de voz, perfis de influencer, projetos Motion e produções que são seus, e as impressões digitais das chaves de provedor que você registrou (nunca as chaves). Geração de imagem, áudio e vídeo e as etapas do Motion gastam das suas próprias chaves de provedor, dentro dos limites que o Studio impõe; uma produção do Studio só gasta depois de uma aprovação no app web do Studio ou no Mothership. Registrar e revogar chaves é bloqueado pela AISAC.',
361
+ },
362
+ },
363
+ ]);
364
+
365
+ /** @param {string} id @returns {McpEntry | undefined} */
366
+ export function mcpById(id) {
367
+ return MCP_CATALOG.find((entry) => entry.id === id);
368
+ }
369
+
370
+ /** @returns {string[]} */
371
+ export function mcpIds() {
372
+ return MCP_CATALOG.map((entry) => entry.id);
373
+ }