@agentrysh/mcp 0.0.13 → 0.0.14

package/dist/tools.js

@@ -16,12 +16,14 @@ export const TOOL_DESCRIPTORS = [
     },
     {
         name: "agentry_login",
-        description: "Authenticate the user via GitHub device flow. Returns an API key, stored locally. " +
+        description: "Authenticate the user via the agentry sign-in page (GitHub, Google, or magic link — " +
+            "user picks any provider). Returns an API key, stored locally. " +
             "" +
             "RECOMMENDED two-call sequence for interactive sessions: " +
-            "  1. Call with mode='start_only' → returns user_code + verification_uri + device_code. " +
-            "     Show the user the code and URL (DO NOT ask them to confirm authorization — they'll " +
-            "     just open the URL, paste the code, and you'll poll). " +
+            "  1. Call with mode='start_only' → returns user_code + verification_uri + device_code " +
+            "     (plus verification_uri_complete with the code pre-filled). Show the user the URL " +
+            "     and code (DO NOT ask them to confirm authorization — they'll open the URL, sign in " +
+            "     with their provider of choice, and you'll poll). " +
             "  2. IMMEDIATELY call again with mode='full' + the device_code from step 1. " +
             "     This blocks and auto-polls every ~5s for up to timeout_seconds (default 300 = 5min). " +
             "     Returns the api_key when the user authorizes, or status='expired'/'denied' on failure. " +
@@ -606,15 +608,20 @@ export const TOOL_DESCRIPTORS = [
     },
     {
         name: "agentry_repair_analytics",
-        description: "Re-attempt PostHog provisioning for the authenticated user. Idempotent — if the user " +
-            "already has a PostHog project, returns its id without recreating. Use this when " +
+        description: "Re-attempt PostHog provisioning for one project. Idempotent — if the project already " +
+            "has a PostHog team binding, returns its id without recreating. Use this when " +
             "agentry_verify_install reports analytics ❌ with reason 'no_posthog_project' OR when a " +
             "/v1/track/ call returns 503 with that code. " +
             "" +
             "DO NOT re-run agentry_login for this failure mode — that mints a new api_key and " +
-            "churns the user's local config. This tool runs only the provisioning step that was " +
-            "supposed to happen at login.",
-        inputSchema: { type: "object", properties: {}, additionalProperties: false },
+            "churns the user's local config. This tool repairs the project-scoped analytics binding only.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Project to repair. Defaults to local default_project_id." },
+            },
+            additionalProperties: false,
+        },
     },
     {
         name: "agentry_rotate_key",
@@ -1339,6 +1346,59 @@ export const TOOL_DESCRIPTORS = [
             additionalProperties: false,
         },
     },
+    {
+        name: "agentry_invite_teammate",
+        description: "Mint a one-shot invite URL granting a teammate access to a project. Owner-only. " +
+            "The recipient opens the URL, signs in with any provider (GitHub / Google / magic link), " +
+            "and gets their own agentry account + API key automatically scoped to this project — they " +
+            "do NOT use your API key. " +
+            "" +
+            "After this returns, share `invite_url` with your teammate (Slack, email — manual for v1). " +
+            "Invite expires in 7 days, single-use.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Defaults to the local default project." },
+                email: {
+                    type: "string",
+                    description: "Optional — shown on the invite landing page as a hint to the recipient. " +
+                        "Does NOT restrict who can consume the invite; the link is the credential.",
+                },
+                role: {
+                    type: "string",
+                    enum: ["member", "owner"],
+                    description: "Defaults to 'member'. 'owner' is rare — only add other owners deliberately.",
+                },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_list_members",
+        description: "List members of a project + any pending (un-consumed, un-expired) invites. " +
+            "Any member can see the full roster; remove members via agentry_remove_member.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Defaults to the local default project." },
+            },
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "agentry_remove_member",
+        description: "Remove a teammate from a project. Owner-only. Cannot remove the last remaining owner, " +
+            "and an owner cannot remove themselves (transfer ownership first — TBD).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project_id: { type: "string", description: "Defaults to the local default project." },
+                user_id: { type: "string", description: "The user_id from agentry_list_members." },
+            },
+            required: ["user_id"],
+            additionalProperties: false,
+        },
+    },
 ];
 // ---------------------------------------------------------------------------
 // Helpers shared across tool handlers
@@ -1453,7 +1513,7 @@ export async function dispatchTool(name, args) {
             case "agentry_rotate_key":
                 return await handleRotateKey();
             case "agentry_repair_analytics":
-                return await handleRepairAnalytics();
+                return await handleRepairAnalytics(a.project_id ? String(a.project_id) : undefined);
             case "agentry_publish_query":
                 return await handlePublishQuery({
                     project_id: a.project_id ? String(a.project_id) : undefined,
@@ -1821,6 +1881,19 @@ export async function dispatchTool(name, args) {
                     kind: a.kind ? String(a.kind) : undefined,
                     resolved: typeof a.resolved === "boolean" ? a.resolved : undefined,
                 });
+            case "agentry_invite_teammate":
+                return await handleInviteTeammate({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    email: a.email ? String(a.email) : undefined,
+                    role: a.role === "owner" ? "owner" : "member",
+                });
+            case "agentry_list_members":
+                return await handleListMembers(a.project_id ? String(a.project_id) : undefined);
+            case "agentry_remove_member":
+                return await handleRemoveMember({
+                    project_id: a.project_id ? String(a.project_id) : undefined,
+                    user_id: String(a.user_id ?? ""),
+                });
             default:
                 return {
                     error: {
@@ -1850,7 +1923,13 @@ function handleStatus() {
         project_count: projectIds.length,
         projects: projectIds.map((id) => {
             const p = cfg.projects[id];
-            return { id, name: p.name, local_path: p.local_path };
+            return {
+                id,
+                name: p.name,
+                local_path: p.local_path,
+                analytics_ready: p.analytics_ready ?? null,
+                posthog_project_id: p.posthog_project_id ?? null,
+            };
         }),
         onboarding: hint,
         next_steps: [hint.message, hint.next_action],
@@ -1860,14 +1939,16 @@ async function handleLogin(input) {
     const cfg = loadConfig();
     if (input.mode === "start_only") {
         const start = await api.startDeviceFlow(cfg);
+        const openUrl = start.verification_uri_complete ?? start.verification_uri;
         return {
             mode: "start_only",
             verification_uri: start.verification_uri,
+            verification_uri_complete: start.verification_uri_complete,
             user_code: start.user_code,
             device_code: start.device_code,
             interval: start.interval,
             expires_in: start.expires_in,
-            next_action: `Show the user: "Open ${start.verification_uri} and enter the code ${start.user_code}." ` +
+            next_action: `Show the user a clickable link: ${openUrl} — one click takes them to sign-in, no code entry. ` +
                 `Then IMMEDIATELY call agentry_login again with mode='full' and device_code='${start.device_code}'. ` +
                 `That call will block and auto-poll for up to ${start.expires_in}s — DO NOT ask the user to confirm authorization before polling.`,
         };
@@ -1966,7 +2047,7 @@ async function handleLogin(input) {
         device_code: deviceCode,
         next_action: `Timed out after ${input.timeout_seconds ?? 300}s. ` +
             (verificationUri && userCode
-                ? `Confirm the user opened ${verificationUri} and entered ${userCode}, `
+                ? `Confirm the user opened ${verificationUri}?code=${userCode}, `
                 : "Confirm the user has authorized, ") +
             `then call agentry_login again with mode='full' and device_code='${deviceCode}' to resume polling.`,
     };
@@ -1995,7 +2076,7 @@ async function handleRotateKey() {
             "New key stored locally. Old key is revoked — update any places it was pasted (CI envs, etc).",
     };
 }
-async function handleRepairAnalytics() {
+async function handleRepairAnalytics(projectId) {
     const cfg = loadConfig();
     if (!cfg.api_key) {
         return {
@@ -2006,9 +2087,32 @@ async function handleRepairAnalytics() {
             },
         };
     }
+    const picked = pickProject(cfg, projectId);
+    if (!picked || !picked.project) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No local project selected for analytics repair.",
+                next_action: "Create a project first or pass a project_id from agentry_list_projects.",
+            },
+        };
+    }
     try {
-        const resp = await api.repairAnalyticsBackend(cfg);
-        return resp;
+        const resp = await api.repairAnalyticsBackend(cfg, picked.id);
+        const updatedProject = {
+            ...picked.project,
+            analytics_ready: resp.posthog_project_id !== null,
+            posthog_project_id: resp.posthog_project_id,
+        };
+        const nextCfg = {
+            ...cfg,
+            projects: {
+                ...cfg.projects,
+                [picked.id]: updatedProject,
+            },
+        };
+        saveConfig(nextCfg);
+        return { project_id: picked.id, ...resp };
     }
     catch (err) {
         return {
@@ -2016,7 +2120,7 @@ async function handleRepairAnalytics() {
                 code: "repair_failed",
                 message: err instanceof Error ? err.message : String(err),
                 next_action: "Upstream PostHog provisioning failed. If the error mentions 5xx / timeouts / rate " +
-                    "limits, wait 30–60s and call agentry_repair_analytics again. Errors and deploys are " +
+                    "limits, wait 30–60s and call agentry_repair_analytics again for the same project. Errors and deploys are " +
                     "unaffected; only analytics ingest needs PostHog.",
             },
         };
@@ -2425,6 +2529,8 @@ async function handleListProjects() {
             ...p,
             local_path: local?.local_path ?? null,
             dsn_known_locally: Boolean(local?.dsn),
+            analytics_ready: local?.analytics_ready ?? null,
+            posthog_project_id: local?.posthog_project_id ?? null,
             is_default: cfg.default_project_id === p.id,
         };
     });
@@ -2469,6 +2575,8 @@ async function handleCreateProject(input) {
         dsn: resp.dsn,
         local_path: input.local_path ?? null,
         default_branch: resp.default_branch ?? input.default_branch ?? "main",
+        analytics_ready: resp.analytics?.ready,
+        posthog_project_id: resp.analytics?.posthog_project_id ?? null,
     };
     const nextCfg = {
         ...cfg,
@@ -2497,6 +2605,7 @@ async function handleCreateProject(input) {
             logs_url: resp.logs_url,
             analytics_url: resp.analytics_url,
             deploys_url: resp.deploys_url,
+            analytics: resp.analytics,
         },
         install_snippet: install,
         next_action: resp.next_action ??
@@ -3310,17 +3419,17 @@ async function handleVerifyInstall(input) {
     const analyticsDetail = checks.analytics?.detail ?? "";
     const noPosthogProject = !checks.analytics?.ok &&
         (analyticsDetail.includes("no_posthog_project") ||
-            analyticsDetail.includes("user has no PostHog project provisioned"));
+            analyticsDetail.includes("project has no PostHog project provisioned"));
     const baseAction = failed.length === 0
         ? "Install verified. Errors land in agentry_list_cases; analytics flow to PostHog; deploys via agentry_list_deploys."
         : noPosthogProject && failed.length === 1
             ? "Analytics is the only failed signal AND the cause is missing PostHog provisioning " +
-                "(first-login provisioning was best-effort and failed). Call agentry_repair_analytics " +
+                "(the project binding is missing). Call agentry_repair_analytics " +
                 "— it's idempotent and runs the same provisioning step. Then re-run agentry_verify_install. " +
                 "DO NOT re-run agentry_login for this."
             : `Install incomplete. Failed signal types: ${failed.join(", ")}. ` +
                 (noPosthogProject
-                    ? "Analytics failed because the user has no PostHog project provisioned — " +
+                    ? "Analytics failed because the project has no PostHog project provisioned — " +
                         "call agentry_repair_analytics, then re-run verify. "
                     : "") +
                 "For each failed type, re-read its corresponding step in agentry_install_guide and fix.";
@@ -3774,4 +3883,61 @@ async function handleListFeedback(input) {
     const resp = await api.listFeedback(cfg, opts);
     return resp;
 }
+// ---------------------------------------------------------------------------
+// Team invites + member management (Phase 4)
+// ---------------------------------------------------------------------------
+async function handleInviteTeammate(input) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, input.project_id);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id, or call agentry_create_project.",
+            },
+        };
+    }
+    const body = { role: input.role };
+    if (input.email)
+        body.email = input.email;
+    return await api.inviteTeammate(cfg, picked.id, body);
+}
+async function handleListMembers(projectId) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, projectId);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id.",
+            },
+        };
+    }
+    return await api.listMembers(cfg, picked.id);
+}
+async function handleRemoveMember(input) {
+    const cfg = loadConfig();
+    const picked = pickProject(cfg, input.project_id);
+    if (!picked) {
+        return {
+            error: {
+                code: "no_project",
+                message: "No project_id given and no default project set.",
+                next_action: "Pass project_id.",
+            },
+        };
+    }
+    if (!input.user_id) {
+        return {
+            error: {
+                code: "invalid_payload",
+                message: "user_id is required.",
+                next_action: "Call agentry_list_members to find the user_id to remove.",
+            },
+        };
+    }
+    return await api.removeMember(cfg, picked.id, input.user_id);
+}
 //# sourceMappingURL=tools.js.map