@morphllm/morphsdk 0.2.27 → 0.2.28

package/README.md

@@ -1,6 +1,6 @@
 # Morph SDK
 
-Production-ready tools for AI coding agents: Fast Apply (10,500 tokens/s)
+Production-ready tools for AI coding agents: Repo Storage with automatic code indexing, semantic search, and Fast Apply (10,500 tokens/s).
 
 [![npm version](https://img.shields.io/npm/v/@morphllm/morphsdk.svg)](https://www.npmjs.com/package/@morphllm/morphsdk)
 
@@ -16,15 +16,57 @@ Get your API key: [morphllm.com/dashboard/api-keys](https://morphllm.com/dashboa
 export MORPH_API_KEY="sk-your-key-here"
 ```
 
+## Features
+
+- **🔍 Semantic Search** - Search code with natural language (morph-v4-embedding + morph-v4-rerank)
+- **📦 Repo Storage** - Git with automatic code indexing, agent metadata, and chat history
+- **⚡ Fast Apply** - AI-powered code editing at 10,500 tokens/s
+- **🤖 Agent Tools** - Ready-to-use tools for Anthropic, OpenAI, and Vercel AI SDK
+
 ## Quick Start
 
+### Repo Storage + Semantic Search
+
 ```typescript
 import { MorphClient } from '@morphllm/morphsdk';
 
-const morph = new MorphClient({ 
-  apiKey: process.env.MORPH_API_KEY 
+const morph = new MorphClient({ apiKey: process.env.MORPH_API_KEY });
+
+// Initialize repo
+await morph.git.init({ repoId: 'my-project', dir: './my-project' });
+
+// Commit with agent metadata
+await morph.git.add({ dir: './my-project', filepath: '.' });
+await morph.git.commit({
+  dir: './my-project',
+  message: 'Add authentication',
+  chatHistory: [
+    { role: 'user', content: 'Add OAuth login' },
+    { role: 'assistant', content: 'Implementing Google OAuth' }
+  ],
+  recordingId: 'rec_123'
 });
 
+// Push (triggers automatic code embedding, 3-8s)
+await morph.git.push({ dir: './my-project' });
+
+// Search your code with natural language
+const results = await morph.codebaseSearch.search({
+  query: "Where is the OAuth login implemented?",
+  repoId: 'my-project',
+  targetDirectories: [] // or ['src/auth'] to narrow search
+});
+
+console.log(results.results[0].content);
+```
+
+### Fast Apply
+
+```typescript
+import { MorphClient } from '@morphllm/morphsdk';
+
+const morph = new MorphClient({ apiKey: process.env.MORPH_API_KEY });
+
 // AI-powered file editing
 await morph.fastApply.execute({
   target_filepath: 'src/app.ts',
@@ -33,7 +75,157 @@ await morph.fastApply.execute({
 });
 ```
 
+## Repo Storage
+
+Git built for AI agents with automatic code indexing and semantic search.
+
+### Git Operations
+
+```typescript
+// Initialize
+await morph.git.init({ repoId: 'my-project', dir: './my-project' });
+
+// Clone
+await morph.git.clone({ repoId: 'my-project', dir: './local-copy' });
+
+// Stage and commit
+await morph.git.add({ dir: './my-project', filepath: '.' });
+await morph.git.commit({ 
+  dir: './my-project', 
+  message: 'Add feature'
+});
+
+// Push (triggers code embedding in background)
+await morph.git.push({ dir: './my-project' });
+
+// Status and history
+const files = await morph.git.statusMatrix({ dir: './my-project' });
+const commits = await morph.git.log({ dir: './my-project', depth: 10 });
+
+// Branch operations
+await morph.git.branch({ dir: './my-project', name: 'feature' });
+const branches = await morph.git.listBranches({ dir: './my-project' });
+await morph.git.checkout({ dir: './my-project', ref: 'main' });
+```
+
+### Agent Metadata
+
+Store chat history and browser recordings with commits:
+
+```typescript
+// Commit with metadata
+const sha = await morph.git.commit({
+  dir: './my-project',
+  message: 'Implement user auth',
+  chatHistory: [
+    { role: 'user', content: 'Add OAuth' },
+    { role: 'assistant', content: 'Adding Google OAuth' }
+  ],
+  recordingId: 'rec_abc123'
+});
+
+// Retrieve metadata later
+const metadata = await morph.git.getCommitMetadata({
+  dir: './my-project',
+  commitSha: sha
+});
+
+console.log(metadata?.chatHistory);
+console.log(metadata?.recordingId);
+```
+
+### Code Embedding
+
+When you push, Morph automatically embeds your code for semantic search. Each commit is indexed separately:
+
+```typescript
+// Search latest code on 'main'
+await morph.codebaseSearch.search({ 
+  query: "auth logic", 
+  repoId: 'my-project' 
+});
+
+// Search specific branch
+await morph.codebaseSearch.search({ 
+  query: "auth logic", 
+  repoId: 'my-project',
+  branch: 'develop' 
+});
+
+// Search exact commit
+await morph.codebaseSearch.search({ 
+  query: "auth logic", 
+  repoId: 'my-project',
+  commitHash: 'abc123...' 
+});
+```
+
+## Semantic Search
+
+Two-stage retrieval: embedding similarity (morph-v4-embedding) + reranking (morph-v4-rerank).
+
+### As Agent Tool
+
+```typescript
+import { createCodebaseSearchTool } from '@morphllm/morphsdk/tools/anthropic';
+import Anthropic from '@anthropic-ai/sdk';
+
+const client = new Anthropic();
+const tool = createCodebaseSearchTool({ repoId: 'my-project' });
+
+const response = await client.messages.create({
+  model: "claude-sonnet-4-5-20250929",
+  tools: [tool],
+  messages: [{ role: "user", content: "Find authentication code" }]
+});
+```
+
+### Direct Search
+
+```typescript
+const results = await morph.codebaseSearch.search({
+  query: "How does authentication work?",
+  repoId: 'my-project',
+  targetDirectories: ["src/auth"], // or [] for all
+  limit: 10
+});
+
+results.results.forEach(r => {
+  console.log(`${r.filepath} (${(r.rerankScore * 100).toFixed(1)}% relevant)`);
+  console.log(r.content);
+});
+```
+
+### How It Works
+
+1. **Embedding Search**: Query embedded with morph-v4-embedding, vector search retrieves top 50 candidates (~50ms)
+2. **Reranking**: Candidates scored with morph-v4-rerank for precision (~150ms)
+3. **Results**: Top 10 most relevant code chunks (~230ms total)
+
+## Fast Apply
+
+AI-powered code editing at 10,500 tokens/s. See [tools/fastapply/README.md](./tools/fastapply/README.md) for details.
+
+## Agent Tools
+
+Ready-to-use tools for popular AI frameworks:
+
+- **Anthropic SDK** - `@morphllm/morphsdk/tools/anthropic`
+- **OpenAI SDK** - `@morphllm/morphsdk/tools/openai`
+- **Vercel AI SDK** - `@morphllm/morphsdk/tools/vercel`
+
+Available tools:
+- `createCodebaseSearchTool` - Semantic code search
+- `createFastApplyTool` - AI-powered code editing
+- `createBrowserTool` - Browser automation
+- `createWarpGrepTool` - Fast grep with AI parsing
+
 ## Documentation
 
 Full docs: [docs.morphllm.com](https://docs.morphllm.com)
 
+**Key Pages:**
+- [Repo Storage](https://docs.morphllm.com/sdk/components/git) - Git operations and agent metadata
+- [Semantic Search](https://docs.morphllm.com/sdk/components/semantic-search) - Code search with natural language
+- [Fast Apply](https://docs.morphllm.com/sdk/components/fast-apply) - AI-powered code editing
+

package/dist/{chunk-22WVN4MC.js → chunk-CMKITT6X.js}

@@ -1,15 +1,15 @@
 import {
   BrowserClient
 } from "./chunk-NCVWIW7L.js";
-import {
-  FastApplyClient
-} from "./chunk-Q7USYY6R.js";
 import {
   CodebaseSearchClient
 } from "./chunk-AG3ICTC5.js";
+import {
+  FastApplyClient
+} from "./chunk-Q7USYY6R.js";
 import {
   MorphGit
-} from "./chunk-DF2ZOO7R.js";
+} from "./chunk-TBVDBQZ2.js";
 import {
   AnthropicRouter,
   GeminiRouter,
@@ -94,4 +94,4 @@ var MorphClient = class {
 export {
   MorphClient
 };
-//# sourceMappingURL=chunk-22WVN4MC.js.map
+//# sourceMappingURL=chunk-CMKITT6X.js.map

package/dist/{chunk-PRIYMEI6.js → chunk-EAA7D24N.js}

@@ -1,3 +1,6 @@
+import {
+  toolRead
+} from "./chunk-Z2FBMSNE.js";
 import {
   getSystemPrompt
 } from "./chunk-HKZB23U7.js";
@@ -7,9 +10,6 @@ import {
 import {
   readFinishFiles
 } from "./chunk-EK7OQPWD.js";
-import {
-  toolRead
-} from "./chunk-Z2FBMSNE.js";
 import {
   AGENT_CONFIG,
   DEFAULT_MODEL
@@ -198,4 +198,4 @@ async function runWarpGrep(config) {
 export {
   runWarpGrep
 };
-//# sourceMappingURL=chunk-PRIYMEI6.js.map
+//# sourceMappingURL=chunk-EAA7D24N.js.map

package/dist/{chunk-LFYQ6GKI.js → chunk-LN4CTQZG.js}

@@ -1,9 +1,9 @@
+import {
+  runWarpGrep
+} from "./chunk-EAA7D24N.js";
 import {
   LocalRipgrepProvider
 } from "./chunk-UYBIKZPM.js";
-import {
-  runWarpGrep
-} from "./chunk-PRIYMEI6.js";
 
 // tools/warp_grep/openai.ts
 import { z } from "zod";
@@ -53,4 +53,4 @@ function createMorphWarpGrepTool(config) {
 export {
   createMorphWarpGrepTool
 };
-//# sourceMappingURL=chunk-LFYQ6GKI.js.map
+//# sourceMappingURL=chunk-LN4CTQZG.js.map

package/dist/{chunk-2DXRTGRH.js → chunk-Q7PDN7TS.js}

@@ -6,4 +6,4 @@ export {
   default2 as default,
   default3 as default2
 };
-//# sourceMappingURL=chunk-2DXRTGRH.js.map
+//# sourceMappingURL=chunk-Q7PDN7TS.js.map

package/dist/chunk-Q7PDN7TS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../git/index.ts"],"sourcesContent":["/**\n * Morph Git SDK\n * \n * Git operations for AI agents using Morph's backend infrastructure.\n * \n * @example\n * ```typescript\n * import { MorphGit } from 'morphsdk/git';\n * \n * const morphGit = new MorphGit({\n *   apiKey: process.env.MORPH_API_KEY!\n * });\n * \n * // Initialize and push\n * await morphGit.init({ repoId: 'my-project', dir: './my-project' });\n * await morphGit.add({ dir: './my-project', filepath: 'src/app.ts' });\n * await morphGit.commit({ dir: './my-project', message: 'Update' });\n * await morphGit.push({ dir: './my-project', branch: 'main' });\n * ```\n */\n\nexport { MorphGit } from './client.js';\nexport type {\n  MorphGitConfig,\n  CloneOptions,\n  PushOptions,\n  PullOptions,\n  AddOptions,\n  CommitOptions,\n  StatusOptions,\n  LogOptions,\n  CheckoutOptions,\n  BranchOptions,\n  DiffOptions,\n  CommitObject,\n  StatusResult,\n  ChatMessage,\n  CommitMetadata,\n} from './types.js';\n\n// Re-export isomorphic-git for advanced use cases\nexport { default as git } from 'isomorphic-git';\nexport { default as http } from 'isomorphic-git/http/node';\n\n"],"mappings":";AAyCA,SAAoB,WAAXA,gBAAsB;AAC/B,SAAoB,WAAXA,gBAAuB;","names":["default"]}

package/dist/{chunk-DF2ZOO7R.js → chunk-TBVDBQZ2.js}

@@ -100,11 +100,19 @@ var MorphGit = class {
    * 
    * @example
    * ```ts
-   * await morphGit.push({ dir: './my-project' });
+   * await morphGit.push({ 
+   *   dir: './my-project',
+   *   branch: 'main' // Required: explicit branch name
+   * });
    * ```
    */
   async push(options) {
     const { dir, remote = "origin", branch } = options;
+    if (!branch) {
+      throw new Error(
+        'branch is required for push operations. Specify the branch explicitly: { dir: "./my-project", branch: "main" }'
+      );
+    }
     await git.push({
       fs,
       http,
@@ -119,11 +127,19 @@ var MorphGit = class {
    * 
    * @example
    * ```ts
-   * await morphGit.pull({ dir: './my-project' });
+   * await morphGit.pull({ 
+   *   dir: './my-project',
+   *   branch: 'main' // Required: explicit branch name
+   * });
    * ```
    */
   async pull(options) {
     const { dir, remote = "origin", branch } = options;
+    if (!branch) {
+      throw new Error(
+        'branch is required for pull operations. Specify the branch explicitly: { dir: "./my-project", branch: "main" }'
+      );
+    }
     await git.pull({
       fs,
       http,
@@ -440,4 +456,4 @@ var MorphGit = class {
 export {
   MorphGit
 };
-//# sourceMappingURL=chunk-DF2ZOO7R.js.map
+//# sourceMappingURL=chunk-TBVDBQZ2.js.map

package/dist/chunk-TBVDBQZ2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../git/client.ts"],"sourcesContent":["/**\n * Morph Git Client - Simple, high-level Git operations\n * Built on isomorphic-git with explicit configuration\n */\n\nimport git from 'isomorphic-git';\nimport http from 'isomorphic-git/http/node';\nimport fs from 'fs';\nimport type {\n  CloneOptions,\n  PushOptions,\n  PullOptions,\n  AddOptions,\n  CommitOptions,\n  StatusOptions,\n  LogOptions,\n  CheckoutOptions,\n  BranchOptions,\n  DiffOptions,\n  CommitObject,\n  StatusResult,\n  MorphGitConfig,\n  CommitMetadata,\n} from './types.js';\n\nconst DEFAULT_PROXY_URL = 'https://repos.morphllm.com';\n\n/**\n * MorphGit - Git operations for AI agents with Morph backend\n * \n * @example\n * ```typescript\n * import { MorphGit } from 'morphsdk/git';\n * \n * const morphGit = new MorphGit({\n *   apiKey: process.env.MORPH_API_KEY!,\n *   proxyUrl: 'https://repos.morphllm.com' // Optional\n * });\n * \n * await morphGit.init({ repoId: 'my-project', dir: './my-project' });\n * await morphGit.push({ dir: './my-project' });\n * ```\n */\nexport class MorphGit {\n  private readonly apiKey: string;\n  private readonly proxyUrl: string;\n\n  constructor(config: MorphGitConfig) {\n    // Validate API key\n    if (!config.apiKey) {\n      throw new Error('API key is required. Get one at https://morphllm.com/dashboard');\n    }\n    \n    if (!config.apiKey.startsWith('sk-') && !config.apiKey.startsWith('morph-')) {\n      throw new Error('Invalid API key format. Expected: sk-... or morph-...');\n    }\n    \n    this.apiKey = config.apiKey;\n    this.proxyUrl = config.proxyUrl || DEFAULT_PROXY_URL;\n  }\n  \n  /**\n   * Get auth callback for isomorphic-git operations\n   * @private\n   */\n  private getAuthCallback() {\n    return () => ({\n      username: 'morph',\n      password: this.apiKey,\n    });\n  }\n\n  /**\n   * Initialize a new repository\n   * Creates the repo in the database and in the git provider\n   * \n   * @example\n   * ```ts\n   * await morphGit.init({\n   *   repoId: 'my-project',\n   *   dir: './my-project',\n   *   defaultBranch: 'main'\n   * });\n   * ```\n   */\n  async init(options: {\n    repoId: string;\n    dir: string;\n    defaultBranch?: string;\n  }): Promise<void> {\n    const { repoId, dir, defaultBranch = 'main' } = options;\n\n    // Call backend API to create repository\n    const response = await fetch(`${this.proxyUrl}/v1/repos`, {\n      method: 'POST',\n      headers: {\n        'Authorization': `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        repoId,\n        name: repoId,\n        defaultBranch,\n      }),\n    });\n\n    if (!response.ok) {\n      const error = await response.text();\n      throw new Error(`Failed to create repository: ${error}`);\n    }\n\n    // Initialize local git repository (industry standard: no clone needed)\n    await git.init({\n      fs,\n      dir,\n      defaultBranch,\n    });\n\n    // Add remote pointing to Morph git-proxy\n    await git.addRemote({\n      fs,\n      dir,\n      remote: 'origin',\n      url: `${this.proxyUrl}/v1/repos/${repoId}`,\n    });\n\n    console.log(`✓ Repository '${repoId}' initialized`);\n  }\n\n  /**\n   * Clone a repository from Morph repos\n   * \n   * @example\n   * ```ts\n   * await morphGit.clone({\n   *   repoId: 'my-project',\n   *   dir: './my-project'\n   * });\n   * ```\n   */\n  async clone(options: CloneOptions): Promise<void> {\n    const { repoId, dir, branch = 'main', depth, singleBranch = true } = options;\n\n    await git.clone({\n      fs,\n      http,\n      dir,\n      corsProxy: this.proxyUrl,\n      url: `${this.proxyUrl}/v1/repos/${repoId}`,\n      ref: branch,\n      singleBranch,\n      depth,\n      onAuth: this.getAuthCallback(),\n    });\n  }\n\n  /**\n   * Push changes to remote repository\n   * \n   * @example\n   * ```ts\n   * await morphGit.push({ \n   *   dir: './my-project',\n   *   branch: 'main' // Required: explicit branch name\n   * });\n   * ```\n   */\n  async push(options: PushOptions): Promise<void> {\n    const { dir, remote = 'origin', branch } = options;\n\n    if (!branch) {\n      throw new Error(\n        'branch is required for push operations. ' +\n        'Specify the branch explicitly: { dir: \"./my-project\", branch: \"main\" }'\n      );\n    }\n\n    await git.push({\n      fs,\n      http,\n      dir,\n      remote,\n      ref: branch,\n      onAuth: this.getAuthCallback(),\n    });\n  }\n\n  /**\n   * Pull changes from remote repository\n   * \n   * @example\n   * ```ts\n   * await morphGit.pull({ \n   *   dir: './my-project',\n   *   branch: 'main' // Required: explicit branch name\n   * });\n   * ```\n   */\n  async pull(options: PullOptions): Promise<void> {\n    const { dir, remote = 'origin', branch } = options;\n\n    if (!branch) {\n      throw new Error(\n        'branch is required for pull operations. ' +\n        'Specify the branch explicitly: { dir: \"./my-project\", branch: \"main\" }'\n      );\n    }\n\n    await git.pull({\n      fs,\n      http,\n      dir,\n      remote,\n      ref: branch,\n      onAuth: this.getAuthCallback(),\n      author: {\n        name: 'Morph Agent',\n        email: 'agent@morph.com',\n      },\n    });\n  }\n\n  /**\n   * Stage a file for commit\n   * \n   * @example\n   * ```ts\n   * await morphGit.add({\n   *   dir: './my-project',\n   *   filepath: 'src/app.ts'\n   * });\n   * ```\n   */\n  async add(options: AddOptions): Promise<void> {\n    const { dir, filepath } = options;\n\n    await git.add({\n      fs,\n      dir,\n      filepath,\n    });\n  }\n\n  /**\n   * Remove a file from staging\n   * \n   * @example\n   * ```ts\n   * await morphGit.remove({\n   *   dir: './my-project',\n   *   filepath: 'src/old-file.ts'\n   * });\n   * ```\n   */\n  async remove(options: AddOptions): Promise<void> {\n    const { dir, filepath } = options;\n\n    await git.remove({\n      fs,\n      dir,\n      filepath,\n    });\n  }\n\n  /**\n   * Commit staged changes\n   * \n   * @example\n   * ```ts\n   * await morphGit.commit({\n   *   dir: './my-project',\n   *   message: 'Add new feature',\n   *   author: {\n   *     name: 'AI Agent',\n   *     email: 'ai@example.com'\n   *   },\n   *   chatHistory: [\n   *     { role: 'user', content: 'Please add a new feature' },\n   *     { role: 'assistant', content: 'I will add that feature' }\n   *   ],\n   *   recordingId: 'rec_123'\n   * });\n   * ```\n   */\n  async commit(options: CommitOptions): Promise<string> {\n    const { dir, message, author, chatHistory, recordingId } = options;\n\n    // Provide default author if not specified\n    const commitAuthor = author || {\n      name: 'Morph SDK',\n      email: 'sdk@morphllm.com'\n    };\n\n    const sha = await git.commit({\n      fs,\n      dir,\n      message,\n      author: commitAuthor,\n    });\n\n    // Store metadata as git note if provided\n    if (chatHistory || recordingId) {\n      const metadata: CommitMetadata = {\n        chatHistory,\n        recordingId\n      };\n      \n      await git.addNote({\n        fs,\n        dir,\n        ref: 'refs/notes/morph-metadata',\n        oid: sha,\n        note: JSON.stringify(metadata, null, 2),\n        author: commitAuthor\n      });\n    }\n\n    return sha;\n  }\n\n  /**\n   * Get status of a file\n   * \n   * @example\n   * ```ts\n   * const status = await morphGit.status({\n   *   dir: './my-project',\n   *   filepath: 'src/app.ts'\n   * });\n   * console.log(status); // 'modified', '*added', etc.\n   * ```\n   */\n  async status(options: StatusOptions): Promise<string> {\n    const { dir, filepath } = options;\n\n    if (!filepath) {\n      throw new Error('filepath is required for status check');\n    }\n\n    const status = await git.status({\n      fs,\n      dir,\n      filepath,\n    });\n\n    return status;\n  }\n\n  /**\n   * Get commit history\n   * \n   * @example\n   * ```ts\n   * const commits = await morphGit.log({\n   *   dir: './my-project',\n   *   depth: 10\n   * });\n   * ```\n   */\n  async log(options: LogOptions): Promise<CommitObject[]> {\n    const { dir, depth, ref } = options;\n\n    const commits = await git.log({\n      fs,\n      dir,\n      depth,\n      ref,\n    });\n\n    return commits as CommitObject[];\n  }\n\n  /**\n   * Checkout a branch or commit\n   * \n   * @example\n   * ```ts\n   * await morphGit.checkout({\n   *   dir: './my-project',\n   *   ref: 'feature-branch'\n   * });\n   * ```\n   */\n  async checkout(options: CheckoutOptions): Promise<void> {\n    const { dir, ref } = options;\n\n    await git.checkout({\n      fs,\n      dir,\n      ref,\n    });\n  }\n\n  /**\n   * Create a new branch\n   * \n   * @example\n   * ```ts\n   * await morphGit.branch({\n   *   dir: './my-project',\n   *   name: 'feature-branch',\n   *   checkout: true\n   * });\n   * ```\n   */\n  async branch(options: BranchOptions): Promise<void> {\n    const { dir, name, checkout = false } = options;\n\n    await git.branch({\n      fs,\n      dir,\n      ref: name,\n      checkout,\n    });\n  }\n\n  /**\n   * List all branches\n   * \n   * @example\n   * ```ts\n   * const branches = await morphGit.listBranches({\n   *   dir: './my-project'\n   * });\n   * ```\n   */\n  async listBranches(options: { dir: string }): Promise<string[]> {\n    const { dir } = options;\n\n    const branches = await git.listBranches({\n      fs,\n      dir,\n    });\n\n    return branches;\n  }\n\n  /**\n   * Get the current branch name\n   * \n   * @example\n   * ```ts\n   * const branch = await morphGit.currentBranch({\n   *   dir: './my-project'\n   * });\n   * ```\n   */\n  async currentBranch(options: { dir: string }): Promise<string | undefined> {\n    const { dir } = options;\n\n    const branch = await git.currentBranch({\n      fs,\n      dir,\n    });\n\n    return branch || undefined;\n  }\n\n  /**\n   * Get list of changed files (similar to git diff --name-only)\n   * \n   * @example\n   * ```ts\n   * const changes = await morphGit.statusMatrix({\n   *   dir: './my-project'\n   * });\n   * ```\n   */\n  async statusMatrix(options: { dir: string }): Promise<StatusResult[]> {\n    const { dir } = options;\n\n    const matrix = await git.statusMatrix({\n      fs,\n      dir,\n    });\n\n    return matrix.map(([filepath, HEADStatus, workdirStatus, stageStatus]) => {\n      let status: StatusResult['status'] = 'unmodified';\n\n      // Determine status based on statusMatrix values\n      if (HEADStatus === 1 && workdirStatus === 2 && stageStatus === 2) {\n        status = 'modified';\n      } else if (HEADStatus === 1 && workdirStatus === 2 && stageStatus === 1) {\n        status = '*modified';\n      } else if (HEADStatus === 0 && workdirStatus === 2 && stageStatus === 2) {\n        status = 'added';\n      } else if (HEADStatus === 0 && workdirStatus === 2 && stageStatus === 0) {\n        status = '*added';\n      } else if (HEADStatus === 1 && workdirStatus === 0 && stageStatus === 0) {\n        status = 'deleted';\n      } else if (HEADStatus === 1 && workdirStatus === 0 && stageStatus === 1) {\n        status = '*deleted';\n      } else if (HEADStatus === 1 && workdirStatus === 1 && stageStatus === 1) {\n        status = 'unmodified';\n      } else if (HEADStatus === 0 && workdirStatus === 0 && stageStatus === 0) {\n        status = 'absent';\n      }\n\n      return {\n        filepath,\n        status,\n      };\n    });\n  }\n\n  /**\n   * Get the current commit hash\n   * \n   * @example\n   * ```ts\n   * const hash = await morphGit.resolveRef({\n   *   dir: './my-project',\n   *   ref: 'HEAD'\n   * });\n   * ```\n   */\n  async resolveRef(options: { dir: string; ref: string }): Promise<string> {\n    const { dir, ref } = options;\n\n    const oid = await git.resolveRef({\n      fs,\n      dir,\n      ref,\n    });\n\n    return oid;\n  }\n\n  /**\n   * Get metadata (chat history, recording ID) attached to a commit\n   * \n   * @example\n   * ```ts\n   * const metadata = await morphGit.getCommitMetadata({\n   *   dir: './my-project',\n   *   commitSha: 'abc123...'\n   * });\n   * \n   * if (metadata) {\n   *   console.log('Chat history:', metadata.chatHistory);\n   *   console.log('Recording ID:', metadata.recordingId);\n   * }\n   * ```\n   */\n  async getCommitMetadata(options: {\n    dir: string;\n    commitSha: string;\n  }): Promise<CommitMetadata | null> {\n    try {\n      const note = await git.readNote({\n        fs,\n        dir: options.dir,\n        ref: 'refs/notes/morph-metadata',\n        oid: options.commitSha\n      });\n      \n      const metadata = JSON.parse(new TextDecoder().decode(note));\n      return metadata;\n    } catch (err) {\n      // No metadata found for this commit\n      return null;\n    }\n  }\n}\n\n"],"mappings":"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","names":[]}

package/dist/{chunk-ZKIVLLZY.js → chunk-W5CHJ6OX.js}

@@ -1,9 +1,9 @@
+import {
+  runWarpGrep
+} from "./chunk-EAA7D24N.js";
 import {
   LocalRipgrepProvider
 } from "./chunk-UYBIKZPM.js";
-import {
-  runWarpGrep
-} from "./chunk-PRIYMEI6.js";
 
 // tools/warp_grep/anthropic.ts
 import { z } from "zod";
@@ -50,4 +50,4 @@ function createMorphWarpGrepTool(config) {
 export {
   createMorphWarpGrepTool
 };
-//# sourceMappingURL=chunk-ZKIVLLZY.js.map
+//# sourceMappingURL=chunk-W5CHJ6OX.js.map

package/dist/{chunk-HNYSKGCP.js → chunk-YSBSDU75.js}

@@ -1,9 +1,9 @@
+import {
+  runWarpGrep
+} from "./chunk-EAA7D24N.js";
 import {
   LocalRipgrepProvider
 } from "./chunk-UYBIKZPM.js";
-import {
-  runWarpGrep
-} from "./chunk-PRIYMEI6.js";
 
 // tools/warp_grep/vercel.ts
 import { tool } from "ai";
@@ -41,4 +41,4 @@ function createMorphWarpGrepTool(config) {
 export {
   createMorphWarpGrepTool
 };
-//# sourceMappingURL=chunk-HNYSKGCP.js.map
+//# sourceMappingURL=chunk-YSBSDU75.js.map

package/dist/client.cjs

@@ -927,11 +927,19 @@ var MorphGit = class {
    * 
    * @example
    * ```ts
-   * await morphGit.push({ dir: './my-project' });
+   * await morphGit.push({ 
+   *   dir: './my-project',
+   *   branch: 'main' // Required: explicit branch name
+   * });
    * ```
    */
   async push(options) {
     const { dir, remote = "origin", branch } = options;
+    if (!branch) {
+      throw new Error(
+        'branch is required for push operations. Specify the branch explicitly: { dir: "./my-project", branch: "main" }'
+      );
+    }
     await import_isomorphic_git.default.push({
       fs: import_fs.default,
       http: import_node.default,
@@ -946,11 +954,19 @@ var MorphGit = class {
    * 
    * @example
    * ```ts
-   * await morphGit.pull({ dir: './my-project' });
+   * await morphGit.pull({ 
+   *   dir: './my-project',
+   *   branch: 'main' // Required: explicit branch name
+   * });
    * ```
    */
   async pull(options) {
     const { dir, remote = "origin", branch } = options;
+    if (!branch) {
+      throw new Error(
+        'branch is required for pull operations. Specify the branch explicitly: { dir: "./my-project", branch: "main" }'
+      );
+    }
     await import_isomorphic_git.default.pull({
       fs: import_fs.default,
       http: import_node.default,