@miraigent/free-ai-ops-mcp 0.1.42 → 0.1.44

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.1.44] - 2026-07-20
+
+### Added
+
+- Added a tools-list-only JSON-RPC session example and smoke-test coverage so
+  MCP client users can confirm the four public tools before sending any sample
+  tool-call input.
+
+## [0.1.43] - 2026-07-19
+
+### Changed
+
+- Added a README command that extracts and parses the bundled JSON-RPC smoke-test
+  result without copy-pasting response lines, plus smoke-test coverage so the
+  public proof path stays visible for npm users.
+
 ## [0.1.42] - 2026-07-18
 
 ### Changed

package/README.md

@@ -19,6 +19,9 @@ examples/human-review-gate/.
 For a complete public-safe MCP session that covers initialize, tools/list, and
 one tool call, see examples/mcp-json-rpc-session/.
 
+If you only want to confirm which tools the server exposes before sending any
+sample tool-call input, use examples/tools-list-json-rpc-session/.
+
 If your first concern is whether a customer-facing prompt should be stopped
 before AI use, use examples/prompt-risk-json-rpc-session/ for a copy-ready
 prompt_risk_review session.
@@ -44,6 +47,13 @@ This is the fastest public proof path for npm and GitHub users. If the command
 starts but the returned status is confusing, open a Tried It feedback issue with
 the command, synthetic input shape, and returned status only.
 
+To inspect the public tool list without running any tool call:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+That response should include `human_review_gate`, `faq_candidate_review`,
+`ai_safe_crm_note`, and `prompt_risk_review`.
+
 For maintainers and contributors, `npm test` replays the same public
 `examples/mcp-json-rpc-session/sample-session.jsonl` file and checks the
 returned server name, version, tool count, and review-gate fields.
@@ -200,6 +210,15 @@ smoke-test output and inspect the wrapped text field with Node:
 
     node -e 'const r=JSON.parse(process.argv[1]); console.log(JSON.parse(r.result.content[0].text));' '<paste one response line here>'
 
+To avoid copying any response text at all, run the bundled public sample and
+parse only its final synthetic tool-call response:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/mcp-json-rpc-session/sample-session.jsonl | tail -n 1 | node -e 'process.stdin.on("data", c => { const r = JSON.parse(c); console.log(JSON.parse(r.result.content[0].text).gateStatus); })'
+
+That prints `stop` for the bundled support-reply example. If it does, the
+package is returning the expected MCP result shape and you can debug client
+configuration separately from tool behavior.
+
 Paste only the synthetic response from the public example. Do not paste private
 customer records or desktop client logs into shell history, screenshots, or
 GitHub issues.

package/examples/tools-list-json-rpc-session/README.md

@@ -0,0 +1,31 @@
+# Tools List JSON-RPC Session Example
+
+This example lets MCP client users confirm the public tool list before sending
+any sample tool-call input.
+
+Use it when a desktop MCP client starts the server but does not show the tools
+you expected.
+
+## Run
+
+From the repository root:
+
+    npm run mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+From the public npm package:
+
+    npx -y free-ai-ops-mcp@npm:@miraigent/free-ai-ops-mcp < examples/tools-list-json-rpc-session/sample-session.jsonl
+
+You should receive two JSON-RPC response lines. The second response should list:
+
+- human_review_gate
+- faq_candidate_review
+- ai_safe_crm_note
+- prompt_risk_review
+
+If those tools appear in the terminal but not in your desktop MCP client,
+restart the client and re-check the configured command and args before changing
+private workflow data.
+
+Do not include secrets, credentials, private customer records, internal policy
+text, paid product files, or private memory behavior in public issues.

package/examples/tools-list-json-rpc-session/sample-session.jsonl

@@ -0,0 +1,2 @@
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
+{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miraigent/free-ai-ops-mcp",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "Free MCP server for developers adding human review gates, prompt risk checks, FAQ review, and CRM note safety to AI tools.",
   "homepage": "https://github.com/Miraigent/miraigent-free-ai-ops-mcp",
   "type": "module",

package/scripts/smoke-test.mjs

@@ -3,6 +3,7 @@ import assert from 'node:assert';
 import { readFile } from 'node:fs/promises';
 
 const packageJson = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+const rootReadme = await readFile(new URL('../README.md', import.meta.url), 'utf8');
 
 const helpChild = spawn(process.execPath, ['mcp/free-ai-ops-server.mjs', '--help'], {
   stdio: ['ignore', 'pipe', 'inherit']
@@ -27,6 +28,8 @@ assert.match(helpStdout, /human_review_gate/);
 assert.match(helpStdout, /Do not paste secrets/);
 assert.match(helpStdout, /private memory behavior/);
 assert.match(helpStdout, /github\.com\/Miraigent\/miraigent-free-ai-ops-mcp\/issues\/new\/choose/);
+assert.match(rootReadme, /tail -n 1 \| node -e/);
+assert.match(rootReadme, /console\.log\(JSON\.parse\(r\.result\.content\[0\]\.text\)\.gateStatus\)/);
 
 const requests = [
   { jsonrpc: '2.0', id: 1, method: 'initialize', params: {} },
@@ -187,6 +190,21 @@ assert.equal(sampleToolResult.gateStatus, 'stop');
 assert.equal(sampleToolResult.nextLogRow.gate_status, 'stop');
 assert.equal(sampleToolResult.boundary, 'This tool is a review helper. It does not send messages.');
 
+const toolsListSession = await readFile(
+  new URL('../examples/tools-list-json-rpc-session/sample-session.jsonl', import.meta.url),
+  'utf8'
+);
+const toolsListResponses = await runServerWithRequests(toolsListSession.trim().split('\n'));
+assert.equal(toolsListResponses.length, 2);
+assert.equal(toolsListResponses[0].result.protocolVersion, '2024-11-05');
+assert.equal(toolsListResponses[0].result.serverInfo.name, 'miraigent-free-ai-ops-mcp');
+assert.equal(toolsListResponses[0].result.serverInfo.version, packageJson.version);
+assert.deepEqual(
+  toolsListResponses[1].result.tools.map((tool) => tool.name),
+  ['human_review_gate', 'faq_candidate_review', 'ai_safe_crm_note', 'prompt_risk_review']
+);
+assert.match(rootReadme, /examples\/tools-list-json-rpc-session\/sample-session\.jsonl/);
+
 const promptRiskSession = await readFile(
   new URL('../examples/prompt-risk-json-rpc-session/sample-session.jsonl', import.meta.url),
   'utf8'