@askthew/mcp-plugin 0.2.0 → 0.2.2

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createAskTheWMcpServer } from "./index.js";
-import { createHostConfigSnippet, formatInstallCommand, installHostConfig, } from "./install.js";
+import { createHostConfigSnippet, formatInstallCommand, installHostConfig, sendInstallHeartbeat, } from "./install.js";
 function usage() {
     return [
         "AskTheW Coding Agent Connector",
@@ -105,9 +105,17 @@ async function main() {
     if (command === "install") {
         const options = parseInstallArgs(argv);
         const result = installHostConfig(options);
+        const heartbeatSent = result.wroteFile
+            ? await sendInstallHeartbeat(options).catch(() => false)
+            : false;
         console.log(result.wroteFile ? "AskTheW plugin install complete." : "AskTheW plugin dry run complete.");
         console.log(`Settings path: ${result.settingsPath}`);
         console.log(`Install command: ${formatInstallCommand(options)}`);
+        if (result.wroteFile) {
+            console.log(heartbeatSent
+                ? "Ask The W setup check sent. Refresh the app to confirm the plugin was seen."
+                : "Ask The W setup check could not be sent yet. Restart or reload your coding app, then refresh Ask The W.");
+        }
         console.log(`Next step: ${result.nextStep}`);
         if (!result.wroteFile) {
             console.log("");

package/dist/install.d.ts

@@ -62,4 +62,8 @@ export declare function installHostConfig(input: InstallHostConfigInput): {
     wroteFile: boolean;
     nextStep: string;
 };
+export declare function sendInstallHeartbeat(input: HostConfigInput & {
+    cwd?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<boolean>;
 export {};

package/dist/install.js

@@ -1,6 +1,7 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { resolvePluginScope } from "./scope.js";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -68,7 +69,7 @@ export function formatInstallCommand(input) {
 }
 export function verificationNextStep(hostType) {
     const hostLabel = hostType === "claude_code" ? "Claude Code" : "Codex";
-    return `Restart ${hostLabel} if it is already open, then send a setup_complete signal with capture_session_signal. list_mcp_resources/list_mcp_resource_templates may be empty for this tool-driven connector and are not failure signals.`;
+    return `Refresh Ask The W to confirm the plugin was seen. Restart ${hostLabel} if it is already open, then send a first setup check. list_mcp_resources/list_mcp_resource_templates may be empty for this tool-driven connector and are not failure signals.`;
 }
 export function installHostConfig(input) {
     const settingsPath = resolveSettingsPath({
@@ -109,3 +110,26 @@ export function installHostConfig(input) {
         nextStep: verificationNextStep(input.hostType),
     };
 }
+export async function sendInstallHeartbeat(input) {
+    const fetcher = input.fetchImpl ?? fetch;
+    const scope = resolvePluginScope(input.cwd ?? process.cwd());
+    const apiUrl = input.apiUrl.replace(/\/$/, "");
+    const response = await fetcher(`${apiUrl}/api/connectors/mcp/heartbeat`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            installToken: input.token,
+            clientId: input.clientId || input.hostType,
+            clientLabel: input.clientLabel,
+            hostType: input.hostType,
+            serverName: input.serverName,
+            repoName: scope.repoName,
+            ...(scope.repoRoot ? { repoRoot: scope.repoRoot } : {}),
+            ...(scope.appPath ? { appPath: scope.appPath } : {}),
+            ...(scope.serviceName ? { serviceName: scope.serviceName } : {}),
+        }),
+    });
+    return response.ok;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askthew/mcp-plugin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "description": "Ask The W MCP connector for capturing compact coding-agent session signals.",
   "type": "module",