@rvry/mcp 0.3.3 → 0.4.0

package/dist/client.d.ts

@@ -3,41 +3,21 @@
  */
 /** Valid tool names for the RVRY engine */
 export type RvryTool = 'deepthink' | 'problem_solve';
-export interface ConstraintView {
-    id: string;
-    type: 'FORWARD' | 'FORBIDDEN' | 'QUESTION';
-    text: string;
-    status: 'active' | 'resolved' | 'acknowledged' | 'deferred';
-}
-export interface DetectionView {
-    overallSeverity: 'low' | 'medium' | 'high' | null;
-    interventionHint: string | null;
-}
-export interface GateView {
-    verdict: 'PASS' | 'SOFT_FAIL' | 'HARD_FAIL' | null;
-    blocked: boolean;
-    reason: string | null;
-}
-export interface MilestoneView {
-    key: string;
-    status: 'missing' | 'satisfied';
+export interface ScopingQuestion {
+    question: string;
+    options: Array<{
+        label: string;
+        description: string;
+    }>;
+    default: string;
 }
-/**
- * Decoded response from the RVRY engine /api/v1/think endpoint.
- *
- * In MCP transport, the raw tool response contains this data as a
- * Base64-encoded JSON string (first content block). Decode before parsing.
- */
 export interface ThinkResponse {
     sessionId: string;
-    status: 'active' | 'complete';
+    status: 'scoping' | 'active' | 'complete';
     round: number;
-    question: string;
-    constraints: ConstraintView[];
-    detection: DetectionView;
-    gate: GateView;
-    milestones: MilestoneView[];
-    constraintBlock: string;
+    prompt: string;
+    instruction: string;
+    scopingQuestions?: ScopingQuestion[];
     usage?: {
         used: number;
         limit: number;
@@ -58,4 +38,4 @@ export interface ThinkResponse {
  * Call the RVRY engine /api/v1/think endpoint with a specific tool.
  * Start a new session by omitting sessionId, or continue by providing one.
  */
-export declare function callTool(tool: RvryTool, input: string, token: string, sessionId?: string): Promise<ThinkResponse>;
+export declare function callTool(tool: RvryTool, input: string, token: string, sessionId?: string, skipScoping?: boolean): Promise<ThinkResponse>;

package/dist/client.js

@@ -6,12 +6,15 @@ const DEFAULT_ENGINE_URL = 'https://engine.rvry.ai';
  * Call the RVRY engine /api/v1/think endpoint with a specific tool.
  * Start a new session by omitting sessionId, or continue by providing one.
  */
-export async function callTool(tool, input, token, sessionId) {
+export async function callTool(tool, input, token, sessionId, skipScoping) {
     const baseUrl = process.env.RVRY_ENGINE_URL ?? DEFAULT_ENGINE_URL;
     const body = { input, tool };
     if (sessionId) {
         body.sessionId = sessionId;
     }
+    if (skipScoping) {
+        body.skipScoping = true;
+    }
     const res = await fetch(`${baseUrl}/api/v1/think`, {
         method: 'POST',
         headers: {

package/dist/index.js

@@ -48,6 +48,10 @@ const TOOL_DEFS = [
                     type: 'string',
                     description: 'Session ID for continuing an existing session. Omit to start a new session.',
                 },
+                skipScoping: {
+                    type: 'boolean',
+                    description: 'Skip the scoping questions phase and begin analysis immediately.',
+                },
             },
             required: ['input'],
         },
@@ -68,6 +72,10 @@ const TOOL_DEFS = [
                     type: 'string',
                     description: 'Session ID for continuing an existing session. Omit to start a new session.',
                 },
+                skipScoping: {
+                    type: 'boolean',
+                    description: 'Skip the scoping questions phase and begin analysis immediately.',
+                },
             },
             required: ['input'],
         },
@@ -81,12 +89,12 @@ function stripResponse(result, question) {
         round: result.round,
         question,
     };
+    if (result.status === 'scoping' && result.scopingQuestions) {
+        stripped.scopingQuestions = result.scopingQuestions;
+    }
     if (result.status === 'active') {
-        stripped.constraints = result.constraints;
-        stripped.detection = result.detection;
-        stripped.gate = result.gate;
-        stripped.milestones = result.milestones;
-        stripped.constraintBlock = result.constraintBlock;
+        stripped.prompt = result.prompt;
+        stripped.instruction = result.instruction;
     }
     if (result.status === 'complete' && result.harvest) {
         stripped.harvest = result.harvest;
@@ -134,6 +142,7 @@ async function main() {
             };
         }
         const sessionId = typeof typedArgs?.sessionId === 'string' ? typedArgs.sessionId : undefined;
+        const skipScoping = typedArgs?.skipScoping === true;
         // Cache question on first call (no sessionId = new session)
         // On continuation calls, read from cache
         let question = input;
@@ -144,7 +153,7 @@ async function main() {
             question = questionCache.get(sessionId) ?? input;
         }
         try {
-            const result = await callTool(rvryTool, input, token, sessionId);
+            const result = await callTool(rvryTool, input, token, sessionId, skipScoping || undefined);
             // Cache question on first call (now we have the sessionId)
             if (!sessionId) {
                 questionCache.set(result.sessionId, input);
@@ -167,22 +176,8 @@ async function main() {
                 }).catch(() => { });
             }
             const stripped = stripResponse(result, question);
-            const userSummary = result.status === 'complete'
-                ? 'Session complete -- harvest ready'
-                : `Round ${result.round} -- ${result.constraints?.filter((c) => c.status === 'active').length ?? 0} constraints active, gate: ${result.gate?.verdict ?? 'starting'}`;
             return {
-                content: [
-                    {
-                        type: 'text',
-                        text: Buffer.from(JSON.stringify(stripped)).toString('base64'),
-                        annotations: { audience: ['assistant'], priority: 1.0 },
-                    },
-                    {
-                        type: 'text',
-                        text: userSummary,
-                        annotations: { audience: ['user'], priority: 0.7 },
-                    },
-                ],
+                content: [{ type: 'text', text: JSON.stringify(stripped) }],
             };
         }
         catch (err) {

package/dist/setup.js

@@ -298,6 +298,65 @@ function configureJsonMcp(configPath, token) {
         return 'error';
     }
 }
+/**
+ * Write RVRY server entry into a TOML config file (e.g. ~/.codex/config.toml).
+ * Uses string/regex manipulation — no TOML parser dependency.
+ */
+function configureTomlMcp(configPath, token) {
+    const block = [
+        '[mcp_servers.rvry]',
+        'command = "npx"',
+        'args = ["@rvry/mcp"]',
+        '',
+        '[mcp_servers.rvry.env]',
+        `RVRY_TOKEN = "${token}"`,
+    ].join('\n');
+    try {
+        let content = '';
+        if (existsSync(configPath)) {
+            content = readFileSync(configPath, 'utf-8');
+        }
+        const sectionRegex = /^\[mcp_servers\.rvry\]/m;
+        if (sectionRegex.test(content)) {
+            // Section exists — check if token is the same
+            const tokenMatch = content.match(/^\[mcp_servers\.rvry\.env\]\s*\nRVRY_TOKEN\s*=\s*"([^"]*)"/m);
+            if (tokenMatch && tokenMatch[1] === token) {
+                return 'unchanged';
+            }
+            // Replace entire section: from [mcp_servers.rvry] to next top-level section or EOF
+            // Match from [mcp_servers.rvry] up to (but not including) the next section header
+            // that is NOT a sub-section of mcp_servers.rvry
+            const replaceRegex = /\[mcp_servers\.rvry\][\s\S]*?(?=\n\[(?!mcp_servers\.rvry[.\]])|$)/;
+            content = content.replace(replaceRegex, block);
+            writeFileSync(configPath, content, 'utf-8');
+            return 'updated';
+        }
+        // Section doesn't exist — append
+        const separator = content.length > 0 && !content.endsWith('\n') ? '\n\n' : content.length > 0 ? '\n' : '';
+        const dir = dirname(configPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(configPath, content + separator + block + '\n', 'utf-8');
+        return 'ok';
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(`  Error writing TOML config: ${msg}`);
+        return 'error';
+    }
+}
+function isCodexAvailable() {
+    try {
+        const cmd = platform() === 'win32' ? 'where codex' : 'which codex';
+        execSync(cmd, { stdio: 'pipe' });
+        return true;
+    }
+    catch { /* not on PATH */ }
+    // Fallback: check if config directory exists (covers aliased installs)
+    if (existsSync(join(homedir(), '.codex', 'config.toml')))
+        return true;
+    return false;
+}
 /** All supported clients. Add new clients here. */
 const CLIENT_REGISTRY = [
     {
@@ -341,6 +400,13 @@ const CLIENT_REGISTRY = [
         configure: (token) => configureJsonMcp(join(homedir(), '.gemini', 'antigravity', 'mcp_config.json'), token),
         notInstalledHint: 'Not installed (https://antigravity.google)',
     },
+    {
+        name: 'Codex',
+        id: 'codex',
+        detect: isCodexAvailable,
+        configure: (token) => configureTomlMcp(join(homedir(), '.codex', 'config.toml'), token),
+        notInstalledHint: 'Not installed (https://openai.com/codex)',
+    },
 ];
 /**
  * Interactive multi-select picker with arrow keys + space + enter.
@@ -673,7 +739,32 @@ export async function runSetup() {
     const tokenFlagIndex = process.argv.indexOf('--token');
     const clientFlagIndex = process.argv.indexOf('--client');
     const clientFilter = clientFlagIndex !== -1 ? process.argv[clientFlagIndex + 1] : null;
-    // ── Step 1: Authentication ──────────────────────────────────────
+    const acceptTerms = process.argv.includes('--accept-terms');
+    // ── Step 1: Terms of Service ────────────────────────────────────
+    console.log('[1/6] Terms of Service');
+    console.log('');
+    console.log('  By continuing, you agree to the RVRY Terms of Service');
+    console.log('  and Privacy Policy:');
+    console.log('');
+    console.log('    https://rvry.ai/terms');
+    console.log('    https://rvry.ai/privacy');
+    console.log('');
+    if (acceptTerms) {
+        console.log('  Accepted via --accept-terms flag.');
+    }
+    else {
+        const rl = createRL();
+        const answer = await ask(rl, '  Do you agree to the Terms of Service? [y/N] ');
+        rl.close();
+        if (answer.toLowerCase() !== 'y') {
+            console.log('');
+            console.log('  Setup cancelled. You must agree to the Terms of Service to use RVRY.');
+            process.exit(1);
+        }
+        console.log('  Accepted.');
+    }
+    console.log('');
+    // ── Step 2: Authentication ──────────────────────────────────────
     let token = null;
     let warning;
     if (tokenFlagIndex !== -1 && process.argv[tokenFlagIndex + 1]) {
@@ -683,11 +774,11 @@ export async function runSetup() {
             process.exit(1);
         }
         token = flagValue;
-        console.log('[1/5] Authentication (from --token flag)');
+        console.log('[2/6] Authentication (from --token flag)');
         console.log(`  Token: ${maskToken(token)}`);
     }
     else {
-        console.log('[1/5] Authentication');
+        console.log('[2/6] Authentication');
         console.log('  Opening browser for sign-in...');
         const result = await deviceAuthFlow();
         if (result) {
@@ -721,7 +812,7 @@ export async function runSetup() {
     }
     console.log('');
     // ── Step 2: Detect clients ──────────────────────────────────────
-    console.log('[2/5] Detecting clients');
+    console.log('[3/6] Detecting clients');
     // Filter registry if --client was passed
     const clients = clientFilter
         ? CLIENT_REGISTRY.filter((c) => c.id === clientFilter)
@@ -741,7 +832,7 @@ export async function runSetup() {
     }
     console.log('');
     // ── Step 3: Configure clients ───────────────────────────────────
-    console.log('[3/5] Select apps to add RVRY MCP configuration');
+    console.log('[4/6] Select apps to add RVRY MCP configuration');
     console.log('  Use \x1b[1m↑↓\x1b[0m to navigate, \x1b[1mspace\x1b[0m to toggle, \x1b[1ma\x1b[0m to toggle all, \x1b[1menter\x1b[0m to confirm');
     console.log('');
     const pickerItems = detected.map((d) => ({
@@ -781,16 +872,25 @@ export async function runSetup() {
         console.log('  Option A — Claude Code (if you install it later):');
         console.log(`    claude mcp add -e RVRY_TOKEN="${token}" -s user rvry -- npx @rvry/mcp`);
         console.log('');
-        console.log('  Option B — JSON config (Claude Desktop, Codex, etc.):');
+        console.log('  Option B — JSON config (Claude Desktop, Anti-Gravity, etc.):');
         const manualConfig = { mcpServers: { RVRY: RVRY_SERVER_ENTRY(token) } };
         console.log('');
         for (const line of JSON.stringify(manualConfig, null, 2).split('\n')) {
             console.log(`    ${line}`);
         }
+        console.log('');
+        console.log('  Option C — TOML config (Codex — add to ~/.codex/config.toml):');
+        console.log('');
+        console.log('    [mcp_servers.rvry]');
+        console.log('    command = "npx"');
+        console.log('    args = ["@rvry/mcp"]');
+        console.log('');
+        console.log('    [mcp_servers.rvry.env]');
+        console.log(`    RVRY_TOKEN = "${token}"`);
     }
     console.log('');
     // ── Step 4: Slash commands ──────────────────────────────────────
-    console.log('[4/5] Slash Commands');
+    console.log('[5/6] Slash Commands');
     const commandCount = await installCommands();
     if (commandCount > 0) {
         console.log(`  Installed ${commandCount} command${commandCount > 1 ? 's' : ''} to .claude/commands/`);
@@ -800,7 +900,7 @@ export async function runSetup() {
     }
     console.log('');
     // ── Step 5: Gitignore protection ────────────────────────────────
-    console.log('[5/5] Gitignore');
+    console.log('[6/6] Gitignore');
     ensureGitignore();
     console.log('');
     // ── Summary ─────────────────────────────────────────────────────
@@ -818,7 +918,8 @@ export async function runSetup() {
     // Client-specific next steps
     const configuredNames = new Set(configuredClients.map((c) => c.name));
     const hasDesktopStyle = configuredNames.has('Claude Desktop / Claude Co-Work')
-        || configuredNames.has('Anti-Gravity');
+        || configuredNames.has('Anti-Gravity')
+        || configuredNames.has('Codex');
     const hasCodeStyle = configuredNames.has('Claude Code');
     console.log('Next steps:');
     let step = 1;
@@ -841,5 +942,14 @@ export async function runSetup() {
         console.log('  1. Configure a client using the manual instructions above');
         console.log('  2. Then try: /deepthink "your question"');
     }
+    // Generic MCP config for any client
+    console.log(`  ${step}. Add RVRY to any other MCP-compatible client —`);
+    console.log('     add this to your MCP config:');
+    console.log('');
+    const mcpBlock = { rvry: RVRY_SERVER_ENTRY('YOUR_RVRY_TOKEN') };
+    const lines = JSON.stringify(mcpBlock, null, 2).split('\n');
+    for (const line of lines.slice(1, -1)) {
+        console.log(`     ${line}`);
+    }
     console.log('');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rvry/mcp",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "RVRY reasoning depth enforcement (RDE) engine client.",
   "type": "module",
   "bin": {