@restforgejs/mcp-server 1.2.2 → 1.2.4

package/dist/tools/key/generate.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerKeyGenerate(server) {
+    server.registerTool('key_generate', {
+        title: 'Generate API Key',
+        description: `Generate a new API key and write it into an .env file, by wrapping restforge key generate.
+
+USE WHEN:
+- The user wants to create/generate a new API key for a RESTForge project, e.g. "buat api key", "generate api key", "bikin key baru"
+- The user is setting up authentication and needs a key written to .env
+
+DO NOT USE FOR:
+- Listing existing keys -> use 'key_list'
+- Revoking a key -> use 'key_revoke'
+- Writing arbitrary env values -> use 'setup_write_env'
+
+This tool runs: npx restforge key generate [--output] [--force] in the given cwd.
+
+NON-INTERACTIVE NOTE: if a key already exists in the output file and 'force' is not set, the CLI asks for overwrite confirmation. In this non-interactive context that prompt cannot be answered and the call may stall until timeout — set 'force' to regenerate over an existing key. Generating into a file with no existing key works without 'force'.
+
+SECURITY NOTE: the generated key value is sensitive and will appear in this tool's output. Do not echo it back to the user in plain text unless they ask; the key is written to the .env file.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. Never mention internal tool names; describe the action (e.g. "generate the API key").
+- Confirm the key was written to the target file; do not paste the raw key unless the user explicitly asks for it.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the project folder (must contain node_modules/@restforgejs/platform)'),
+            output: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Output .env file to write the key into (relative to cwd; must be INSIDE the project directory — the CLI rejects paths outside cwd). When omitted, the CLI uses its default (.env).'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('Overwrite an existing key without confirmation. Set this to regenerate over an existing key (otherwise the CLI may prompt and stall).'),
+        },
+        annotations: {
+            title: 'Generate API Key',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+    }, async ({ cwd, output, force }) => {
+        const projectCwd = resolve(cwd);
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+
+For the assistant:
+- The user needs to install the RESTForge package before an API key can be generated. Suggest installing it first, then retry. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'key', 'generate'];
+        if (output)
+            args.push(`--output=${output}`);
+        if (force)
+            args.push('--force');
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 60_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to generate the API key.
+
+Project path: ${projectCwd}
+Output: ${output ?? 'default (.env)'}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the API key was not generated. A common cause is that a key already exists and overwrite was not allowed (the operation may have stalled waiting for confirmation) — suggest retrying with overwrite enabled. Do not paste raw output unless asked. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `API key generated.
+
+Project path: ${projectCwd}
+Output: ${output ?? 'default (.env)'}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the key was written to the target .env file. Treat the key value as a secret: do not repeat it back in plain text unless the user explicitly asks.
+- Keep the reply concise. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/key/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/tools/key/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;uGAuBoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,oLAAoL,CAAC;YACjM,KAAK,EAAE,CAAC;iBACL,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,uIAAuI,CAAC;SACrJ;QACD,WAAW,EAAE;YACX,KAAK,EAAE,kBAAkB;YACzB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,KAAK;SACvB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;;;mKAIyI;qBACtJ;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,IAAI,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;UAChB,MAAM,IAAI,gBAAgB;WACzB,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;wSAIyR;qBAC3R;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;UAChB,MAAM,IAAI,gBAAgB;WACzB,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;;8DAK+C;iBACnD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/key/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerKeyTools(server: McpServer): void;

package/dist/tools/key/index.js

@@ -0,0 +1,9 @@
+import { registerKeyGenerate } from './generate.js';
+import { registerKeyList } from './list.js';
+import { registerKeyRevoke } from './revoke.js';
+export function registerKeyTools(server) {
+    registerKeyGenerate(server);
+    registerKeyList(server);
+    registerKeyRevoke(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/key/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/key/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/key/list.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerKeyList(server: McpServer): void;

package/dist/tools/key/list.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerKeyList(server) {
+    server.registerTool('key_list', {
+        title: 'List API Keys',
+        description: `List the registered API keys found in .env files (masked by default), by wrapping restforge key list.
+
+USE WHEN:
+- The user wants to see which API keys exist, e.g. "lihat api key", "daftar key", "list api keys", "key apa saja yang terdaftar"
+
+DO NOT USE FOR:
+- Generating a new key -> use 'key_generate'
+- Revoking a key -> use 'key_revoke'
+
+This tool runs: npx restforge key list [--show-full] [--dir] in the given cwd.
+
+SECURITY NOTE: by default keys are shown MASKED. 'showFull' reveals the full secret key values in this tool's output — only enable it when the user explicitly asks, and avoid repeating full keys back to the user.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. Never mention internal tool names; describe the action (e.g. "list the API keys").
+- Summarise how many keys are present and where; keep masked values masked. Do not paste full key values unless the user explicitly asked and 'showFull' was used.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the project folder (must contain node_modules/@restforgejs/platform)'),
+            showFull: z
+                .boolean()
+                .optional()
+                .describe('Reveal full (unmasked) key values. SECURITY: only when the user explicitly asks. When omitted, keys are masked.'),
+            dir: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Directory to search for .env files. When omitted, the CLI uses the current working directory.'),
+        },
+        annotations: {
+            title: 'List API Keys',
+            readOnlyHint: true,
+            idempotentHint: true,
+        },
+    }, async ({ cwd, showFull, dir }) => {
+        const projectCwd = resolve(cwd);
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+
+For the assistant:
+- The user needs to install the RESTForge package before API keys can be listed. Suggest installing it first, then retry. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'key', 'list'];
+        if (showFull)
+            args.push('--show-full');
+        if (dir)
+            args.push(`--dir=${dir}`);
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 30_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to list API keys.
+
+Project path: ${projectCwd}
+Dir: ${dir ?? 'cwd'}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the keys could not be listed; summarise the likely cause from the output (e.g. the search directory does not exist). Do not paste raw output unless asked. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `API keys listed${showFull ? ' (FULL/unmasked)' : ' (masked)'}.
+
+Project path: ${projectCwd}
+Dir: ${dir ?? 'cwd'}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Read the output and tell the user how many keys are present and in which file(s).
+- ${showFull ? 'Full key values were requested; still avoid repeating the secrets back unless necessary.' : 'Values are masked; do not attempt to unmask unless the user explicitly asks.'}
+- Keep the reply concise. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/key/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/key/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;uGAmBoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,QAAQ,EAAE,CAAC;iBACR,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iHAAiH,CAAC;YAC9H,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CAAC,+FAA+F,CAAC;SAC7G;QACD,WAAW,EAAE;YACX,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE;QAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;;;8JAIoI;qBACjJ;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,IAAI,GAAG;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;OACnB,GAAG,IAAI,KAAK;WACR,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;+MAIgM;qBAClM;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBAAkB,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,WAAW;;gBAE/D,UAAU;OACnB,GAAG,IAAI,KAAK;WACR,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;;IAKX,QAAQ,CAAC,CAAC,CAAC,0FAA0F,CAAC,CAAC,CAAC,8EAA8E;8DAC5H;iBACnD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/key/revoke.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerKeyRevoke(server: McpServer): void;

package/dist/tools/key/revoke.js

@@ -0,0 +1,117 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerKeyRevoke(server) {
+    server.registerTool('key_revoke', {
+        title: 'Revoke API Key',
+        description: `Revoke (remove) an API key from an .env file, by wrapping restforge key revoke.
+
+USE WHEN:
+- The user wants to revoke, remove, or invalidate an API key, e.g. "revoke api key", "cabut key", "hapus api key dari .env"
+
+DO NOT USE FOR:
+- Generating a key -> use 'key_generate'
+- Listing keys -> use 'key_list'
+
+This tool runs: npx restforge key revoke --file=<file> --yes in the given cwd. The 'file' argument is REQUIRED (without it the CLI would drop into an interactive file picker, which cannot be answered here), and '--yes' is always passed to skip the confirmation prompt — so this tool revokes immediately without further confirmation.
+
+IMPORTANT — this is destructive: it removes the key from the named .env file. Confirm the file and intent with the user BEFORE calling this tool, because the revoke happens without an additional in-tool confirmation step.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named .env file must exist and contain a key. This tool does not pre-check it; the failure response surfaces the cause.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. Never mention internal tool names; describe the action (e.g. "revoke the API key").
+- Confirm which file the key was revoked from. Keep the reply concise.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the project folder (must contain node_modules/@restforgejs/platform)'),
+            file: z
+                .string()
+                .min(1)
+                .describe('Path to the .env file containing the key to revoke (relative to cwd; must be INSIDE the project directory — the CLI rejects paths outside cwd). REQUIRED (avoids the interactive file picker).'),
+        },
+        annotations: {
+            title: 'Revoke API Key',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: true,
+        },
+    }, async ({ cwd, file }) => {
+        const projectCwd = resolve(cwd);
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+
+For the assistant:
+- The user needs to install the RESTForge package before an API key can be revoked. Suggest installing it first, then retry. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const args = ['restforge', 'key', 'revoke', `--file=${file}`, '--yes'];
+        const result = await execProcess('npx', args, { cwd: projectCwd, timeout: 30_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to revoke the API key.
+
+Project path: ${projectCwd}
+File: ${file}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the key was not revoked; summarise the likely cause (e.g. the file does not exist or contains no key). Do not paste raw output unless asked. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `API key revoked.
+
+Project path: ${projectCwd}
+File: ${file}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the key was revoked from the named file. Keep the reply concise. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=revoke.js.map

package/dist/tools/key/revoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revoke.js","sourceRoot":"","sources":["../../../src/tools/key/revoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;uGAoBoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,gMAAgM,CAAC;SAC9M;QACD,WAAW,EAAE;YACX,KAAK,EAAE,gBAAgB;YACvB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,IAAI;SACtB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;;;iKAIuI;qBACpJ;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;QAClB,IAAI;WACD,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;iMAIkL;qBACpL;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;QAClB,IAAI;WACD,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;+GAIgG;iBACpG;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/project/delete.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectDelete(server: McpServer): void;

package/dist/tools/project/delete.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import { access } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import { execProcess } from '../../lib/exec.js';
+export function registerProjectDelete(server) {
+    server.registerTool('project_delete', {
+        title: 'Delete Project',
+        description: `Delete a project from the RESTForge registry, INCLUDING all of its endpoints, processors, dashboards, and consumers, by wrapping restforge project delete.
+
+USE WHEN:
+- The user explicitly wants to delete/remove an entire project, e.g. "hapus project", "delete project", "remove project beserta isinya"
+
+DO NOT USE FOR:
+- Listing projects -> use 'project_list'
+- Deleting a single endpoint/processor/dashboard -> out of scope (this removes the WHOLE project)
+
+This tool runs: npx restforge project delete --project=<project> --yes in the given cwd. '--yes' is always passed to skip the confirmation prompt (the prompt cannot be answered in this non-interactive context), so the deletion happens immediately.
+
+IMPORTANT — this is highly destructive and not reversible here: it removes the entire project and every endpoint, processor, dashboard, and consumer inside it. There is NO additional in-tool confirmation. ALWAYS confirm the exact project name and intent with the user BEFORE calling this tool; consider listing projects first to verify the name.
+
+Preconditions:
+- The project must have @restforgejs/platform installed in node_modules.
+- The named project must exist in the registry. This tool does not pre-check it; the failure response surfaces the cause.
+
+PRESENTATION GUIDANCE:
+- Match the user's language. Never mention internal tool names; describe the action (e.g. "delete the project").
+- Confirm what was deleted. Keep the reply concise.
+- When a precondition is not met, frame it as a question or next-step suggestion rather than an error.`,
+        inputSchema: {
+            cwd: z
+                .string()
+                .min(1)
+                .describe('Absolute path of the project folder (must contain node_modules/@restforgejs/platform)'),
+            project: z
+                .string()
+                .min(1)
+                .describe('Name of the project to delete (and everything inside it). REQUIRED. Verify with the user first.'),
+        },
+        annotations: {
+            title: 'Delete Project',
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: true,
+        },
+    }, async ({ cwd, project }) => {
+        const projectCwd = resolve(cwd);
+        try {
+            await access(join(projectCwd, 'node_modules', '@restforgejs', 'platform'));
+        }
+        catch {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Precondition not met: the RESTForge package is not installed in this project.
+
+Project path: ${projectCwd}
+Expected location: node_modules/@restforgejs/platform
+
+For the assistant:
+- The user needs to install the RESTForge package before a project can be deleted. Suggest installing it first, then retry. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        const result = await execProcess('npx', ['restforge', 'project', 'delete', `--project=${project}`, '--yes'], { cwd: projectCwd, timeout: 30_000 });
+        if (!result.success) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to delete the project.
+
+Project path: ${projectCwd}
+Project: ${project}
+Command: ${result.command}
+Exit code: ${result.exitCode}
+
+--- CLI output ---
+stdout:
+${result.stdout}
+
+stderr:
+${result.stderr}
+--- end CLI output ---
+
+For the assistant:
+- Tell the user the project was not deleted; summarise the likely cause (e.g. the project name does not exist in the registry). Do not paste raw output unless asked. Do not mention internal tool names.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Project deleted.
+
+Project path: ${projectCwd}
+Project: ${project}
+Command: ${result.command}
+
+--- CLI output ---
+${result.stdout}
+--- end CLI output ---
+
+For the assistant:
+- Confirm the project and all its contents (endpoints, processors, dashboards, consumers) were removed. Keep the reply concise. Do not mention internal tool names.`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/project/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/project/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;uGAoBoF;QACjG,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,uFAAuF,CAAC;YACpG,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,iGAAiG,CAAC;SAC/G;QACD,WAAW,EAAE;YACX,KAAK,EAAE,gBAAgB;YACvB,YAAY,EAAE,KAAK;YACnB,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,IAAI;SACtB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;QAC7E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;;;;gKAIsI;qBACnJ;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEnJ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;gBAEJ,UAAU;WACf,OAAO;WACP,MAAM,CAAC,OAAO;aACZ,MAAM,CAAC,QAAQ;;;;EAI1B,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;;;0MAI2L;qBAC7L;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;gBAEF,UAAU;WACf,OAAO;WACP,MAAM,CAAC,OAAO;;;EAGvB,MAAM,CAAC,MAAM;;;;oKAIqJ;iBACzJ;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/project/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(server: McpServer): void;

package/dist/tools/project/index.js

@@ -0,0 +1,7 @@
+import { registerProjectList } from './list.js';
+import { registerProjectDelete } from './delete.js';
+export function registerProjectTools(server) {
+    registerProjectList(server);
+    registerProjectDelete(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/project/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/tools/project/list.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectList(server: McpServer): void;