@morphllm/morphsdk 0.2.103 → 0.2.105

package/README.md

@@ -1,6 +1,6 @@
 # Morph SDK
 
-Production-ready tools for AI coding agents: WarpGrep (intelligent code search), Fast Apply (10,500 tokens/s), and Repo Storage.
+Production-ready tools for AI coding agents: WarpGrep (intelligent code search), Fast Apply (10,500 tokens/s), GitHub integration, and Browser automation.
 
 [![npm version](https://img.shields.io/npm/v/@morphllm/morphsdk.svg)](https://www.npmjs.com/package/@morphllm/morphsdk)
 
@@ -20,6 +20,8 @@ export MORPH_API_KEY="sk-your-key-here"
 
 - **🔍 WarpGrep** - Intelligent code search agent that explores your codebase with parallel grep/read operations
 - **⚡ Fast Apply** - 98% 1st pass accuracy, AI-powered code editing at 10,500 tokens/s
+- **🐙 GitHub** - Access PR context, post comments, manage check runs through your connected GitHub account
+- **🌐 Browser** - AI-powered browser automation for testing and interaction
 - **📦 Repo Storage** - Agent native git with automatic code indexing and agent metadata
 - **🤖 Agent Tools** - Ready-to-use tools for Anthropic, OpenAI, Gemini, and Vercel AI SDK
 
@@ -78,6 +80,147 @@ const tool = createWarpGrepTool({
 });
 ```
 
+## GitHub Integration
+
+Access your GitHub repositories, pull requests, and deployments through your connected Morph account.
+
+### Setup
+
+Connect your GitHub account in the [Morph Dashboard](https://morphllm.com/dashboard/integrations/github), then use the SDK:
+
+```typescript
+import { MorphClient } from '@morphllm/morphsdk';
+
+const morph = new MorphClient({ apiKey: process.env.MORPH_API_KEY });
+
+// List your GitHub installations
+const installations = await morph.github.installations.list();
+console.log(installations);
+// [{ id: "12345", accountLogin: "acme", accountType: "Organization" }]
+```
+
+### List Repositories
+
+```typescript
+// List repos for an installation
+const repos = await morph.github.repos.list({
+  installationId: "12345"
+});
+// [{ id: 123, name: "app", fullName: "acme/app", private: true }]
+```
+
+### Get Pull Request Context
+
+```typescript
+// Get PR with full context (title, body, diff, files)
+const pr = await morph.github.pullRequests.get({
+  owner: "acme",
+  repo: "app",
+  number: 42
+});
+
+console.log(pr.title);    // "Add user authentication"
+console.log(pr.diff);     // Full unified diff
+console.log(pr.files);    // [{ filename, status, additions, deletions, patch }]
+```
+
+### Find Preview Deployments
+
+```typescript
+// Get deployments for a PR's head SHA
+const deployments = await morph.github.deployments.list({
+  owner: "acme",
+  repo: "app",
+  sha: pr.headSha
+});
+
+const preview = deployments.find(d => d.environment === "preview");
+console.log(preview?.url); // "https://app-pr-42.vercel.app"
+```
+
+### Post PR Comments
+
+```typescript
+// Post a comment to a PR
+const comment = await morph.github.comments.create({
+  owner: "acme",
+  repo: "app",
+  pr: 42,
+  body: "## Test Results\n\n✅ All tests passed!"
+});
+
+// Update the comment
+await morph.github.comments.update({
+  owner: "acme",
+  repo: "app",
+  commentId: comment.id,
+  body: "## Test Results\n\n✅ All tests passed!\n\nUpdated at: " + new Date()
+});
+```
+
+### Manage Check Runs (CI Status)
+
+```typescript
+// Create a check run
+const checkRun = await morph.github.checkRuns.create({
+  owner: "acme",
+  repo: "app",
+  sha: pr.headSha,
+  name: "Preview Test",
+  status: "in_progress",
+  title: "Testing preview deployment...",
+  summary: "Running automated browser tests"
+});
+
+// Update with results
+await morph.github.checkRuns.update({
+  owner: "acme",
+  repo: "app",
+  checkRunId: checkRun.id,
+  conclusion: "success",
+  title: "✅ Preview test passed",
+  summary: "All tests completed successfully"
+});
+```
+
+### Full Example: PR Preview Testing
+
+```typescript
+import { MorphClient } from '@morphllm/morphsdk';
+
+const morph = new MorphClient({ apiKey: process.env.MORPH_API_KEY });
+
+async function testPRPreview(owner: string, repo: string, prNumber: number) {
+  // 1. Get PR context
+  const pr = await morph.github.pullRequests.get({ owner, repo, number: prNumber });
+
+  // 2. Find preview deployment
+  const deployments = await morph.github.deployments.list({ owner, repo, sha: pr.headSha });
+  const preview = deployments.find(d => d.state === "success" && d.url);
+
+  if (!preview) {
+    console.log("No preview deployment found");
+    return;
+  }
+
+  // 3. Run browser test with PR context
+  const task = await morph.browser.createTask({
+    url: preview.url,
+    diff: pr.diff,
+    task: "Test the changes in this PR"
+  });
+
+  // 4. Wait for results
+  const recording = await morph.browser.waitForRecording(task.recordingId);
+
+  // 5. Post results to PR
+  await morph.github.comments.create({
+    owner, repo, pr: prNumber,
+    body: `## 🤖 Preview Test Results\n\n${recording.result || "Test completed"}`
+  });
+}
+```
+
 ## Fast Apply
 
 AI-powered code editing at 10,500 tokens/s with 98% first-pass accuracy.
@@ -160,4 +303,6 @@ Full docs: [docs.morphllm.com](https://docs.morphllm.com)
 **Key Pages:**
 - [WarpGrep](https://docs.morphllm.com/sdk/components/warp-grep) - Intelligent code search
 - [Fast Apply](https://docs.morphllm.com/sdk/components/fast-apply) - AI-powered code editing
+- [GitHub](https://docs.morphllm.com/sdk/components/github) - GitHub integration for PR context and automation
+- [Browser](https://docs.morphllm.com/sdk/components/browser) - AI-powered browser automation
 - [Repo Storage](https://docs.morphllm.com/sdk/components/git) - Git operations and agent metadata