@morphllm/morphsdk 0.2.26 → 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-5HY6Q45E.js → chunk-CMKITT6X.js}

@@ -1,15 +1,15 @@
+import {
+  BrowserClient
+} from "./chunk-NCVWIW7L.js";
 import {
   CodebaseSearchClient
 } from "./chunk-AG3ICTC5.js";
 import {
   FastApplyClient
 } from "./chunk-Q7USYY6R.js";
-import {
-  BrowserClient
-} from "./chunk-APMKEW7D.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-5HY6Q45E.js.map
+//# sourceMappingURL=chunk-CMKITT6X.js.map

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

@@ -1,15 +1,15 @@
-import {
-  toolAnalyse
-} from "./chunk-73RQWOQC.js";
-import {
-  readFinishFiles
-} from "./chunk-EK7OQPWD.js";
 import {
   toolRead
 } from "./chunk-Z2FBMSNE.js";
 import {
   getSystemPrompt
 } from "./chunk-HKZB23U7.js";
+import {
+  toolAnalyse
+} from "./chunk-73RQWOQC.js";
+import {
+  readFinishFiles
+} from "./chunk-EK7OQPWD.js";
 import {
   AGENT_CONFIG,
   DEFAULT_MODEL
@@ -198,4 +198,4 @@ async function runWarpGrep(config) {
 export {
   runWarpGrep
 };
-//# sourceMappingURL=chunk-JJ5ONKDN.js.map
+//# sourceMappingURL=chunk-EAA7D24N.js.map

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

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

package/dist/{chunk-APMKEW7D.js → chunk-NCVWIW7L.js}

@@ -476,4 +476,4 @@ export {
   getErrors,
   checkHealth
 };
-//# sourceMappingURL=chunk-APMKEW7D.js.map
+//# sourceMappingURL=chunk-NCVWIW7L.js.map

package/dist/chunk-NCVWIW7L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../tools/browser/live.ts","../tools/browser/core.ts"],"sourcesContent":["/**\n * Live session utilities for Morph browser sessions\n * \n * Provides helpers for embedding and sharing live browser sessions with WebRTC streaming.\n */\n\nimport type { LiveSessionOptions, IframeOptions } from './types.js';\n\n/**\n * Preset configurations for common use cases\n */\nexport const LIVE_PRESETS = {\n  /** Read-only monitoring (no interaction) */\n  readonly: { interactive: false } as LiveSessionOptions,\n  /** Interactive control (human-in-the-loop) */\n  interactive: { interactive: true } as LiveSessionOptions,\n  /** Watch-only without controls */\n  monitoring: { interactive: false, showControls: false } as LiveSessionOptions,\n} as const;\n\n/**\n * Build a live session URL with query parameters\n * \n * @param debugUrl - Live session debug URL (e.g., from task.debugUrl)\n * @param options - Live session configuration options\n * @returns URL with query parameters for iframe embedding\n * \n * @example\n * ```typescript\n * const url = buildLiveUrl(task.debugUrl, { interactive: true });\n * // Returns: https://example.com/sessions/abc?interactive=true\n * ```\n */\nexport function buildLiveUrl(\n  debugUrl: string,\n  options: LiveSessionOptions = {}\n): string {\n  if (!debugUrl) {\n    throw new Error(\n      'debugUrl is required. Ensure your backend returns debugUrl in the task response. ' +\n      'Contact support@morphllm.com if you need help.'\n    );\n  }     \n\n  const url = new URL(debugUrl);\n  \n  // Add query parameters for supported options\n  if (options.interactive !== undefined) {\n    url.searchParams.set('interactive', String(options.interactive));\n  }\n  \n  if (options.theme) {\n    url.searchParams.set('theme', options.theme);\n  }\n  \n  if (options.showControls !== undefined) {\n    url.searchParams.set('showControls', String(options.showControls));\n  }\n  \n  if (options.pageId) {\n    url.searchParams.set('pageId', options.pageId);\n  }\n  \n  if (options.pageIndex) {\n    url.searchParams.set('pageIndex', options.pageIndex);\n  }\n  \n  return url.toString();\n}\n\n/**\n * Build iframe HTML for embedding a live session\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration including dimensions and session options\n * @returns HTML iframe element as string\n * \n * @example\n * ```typescript\n * const iframe = buildLiveIframe(task.debugUrl, {\n *   interactive: true,\n *   width: '100%',\n *   height: '600px'\n * });\n * ```\n */\nexport function buildLiveIframe(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const {\n    width = '100%',\n    height = '600px',\n    style = '',\n    className = '',\n    ...sessionOptions\n  } = options;\n\n  const src = buildLiveUrl(debugUrl, sessionOptions);\n  \n  // Convert numeric dimensions to pixels\n  const widthStr = typeof width === 'number' ? `${width}px` : width;\n  const heightStr = typeof height === 'number' ? `${height}px` : height;\n  \n  // Build style attribute\n  const baseStyle = `width: ${widthStr}; height: ${heightStr}; border: none;`;\n  const fullStyle = style ? `${baseStyle} ${style}` : baseStyle;\n  \n  // Build iframe attributes\n  const attributes = [\n    `src=\"${src}\"`,\n    `style=\"${fullStyle}\"`,\n  ];\n  \n  if (className) {\n    attributes.push(`class=\"${className}\"`);\n  }\n  \n  return `<iframe ${attributes.join(' ')}></iframe>`;\n}\n\n/**\n * Build complete embed code with HTML snippet\n * \n * @param debugUrl - Live session debug URL\n * @param options - Iframe configuration\n * @returns Multi-line HTML snippet ready to copy-paste\n * \n * @example\n * ```typescript\n * const code = buildEmbedCode(task.debugUrl, { interactive: false });\n * console.log(code);\n * // <!-- Embed Morph Live Session -->\n * // <iframe src=\"...\" style=\"...\"></iframe>\n * ```\n */\nexport function buildEmbedCode(\n  debugUrl: string,\n  options: IframeOptions = {}\n): string {\n  const iframe = buildLiveIframe(debugUrl, options);\n  return `<!-- Embed Morph Live Session -->\\n${iframe}`;\n}\n\n/**\n * Get live session options from preset name or custom config\n * \n * @internal\n */\nexport function resolvePreset(\n  optionsOrPreset?: string | IframeOptions\n): IframeOptions {\n  if (!optionsOrPreset) {\n    return {};\n  }\n  \n  if (typeof optionsOrPreset === 'string') {\n    const preset = LIVE_PRESETS[optionsOrPreset as keyof typeof LIVE_PRESETS];\n    if (!preset) {\n      throw new Error(\n        `Unknown preset: ${optionsOrPreset}. Available presets: ${Object.keys(LIVE_PRESETS).join(', ')}`\n      );\n    }\n    return preset;\n  }\n  \n  return optionsOrPreset;\n}\n\n","/**\n * Core implementation for browser automation tasks\n */\n\nimport { fetchWithRetry, withTimeout } from '../utils/resilience.js';\nimport type {\n  BrowserConfig,\n  BrowserTaskInput,\n  BrowserTaskInputWithSchema,\n  BrowserTaskResult,\n  BrowserTaskWithPromise,\n  BrowserTaskWithPromiseAndSchema,\n  RecordingStatus,\n  ErrorsResponse,\n  LiveSessionOptions,\n  IframeOptions,\n} from './types.js';\nimport { buildLiveUrl, buildLiveIframe, buildEmbedCode, resolvePreset } from './live.js';\n\nconst DEFAULT_CONFIG = {\n  apiUrl: process.env.MORPH_ENVIRONMENT === 'DEV' \n    ? 'http://localhost:8000'\n    : 'https://browser.morphllm.com',\n  timeout: 1000000, // 10 minutes for complex tasks\n  debug: false,\n};\n\n/**\n * BrowserClient class for easier usage with instance configuration\n */\nexport class BrowserClient {\n  private config: BrowserConfig;\n\n  constructor(config: BrowserConfig = {}) {\n    this.config = {\n      ...DEFAULT_CONFIG,\n      ...config,\n    };\n  }\n\n  /**\n   * Execute a browser automation task\n   */\n  async execute(input: BrowserTaskInput): Promise<BrowserTaskResult> {\n    return executeBrowserTask(input, this.config);\n  }\n\n  async createTask(input: BrowserTaskInput): Promise<BrowserTaskWithPromise>;\n  async createTask<T>(input: BrowserTaskInputWithSchema<T>): Promise<BrowserTaskWithPromiseAndSchema<T>>;\n  async createTask<T>(\n    input: BrowserTaskInput | BrowserTaskInputWithSchema<T>\n  ): Promise<BrowserTaskWithPromise | BrowserTaskWithPromiseAndSchema<T>> {\n    if ('schema' in input) {\n      const taskInput: BrowserTaskInput = {\n        ...input,\n        structured_output: stringifyStructuredOutput(input.schema),\n      };\n      const result = await executeBrowserTask(taskInput, this.config);\n      return wrapTaskResponseWithSchema(result, this.config, input.schema);\n    } else {\n      const result = await executeBrowserTask(input, this.config);\n      return wrapTaskResponse(result, this.config);\n    }\n  }\n\n  /**\n   * Execute task with recording and wait for video to be ready\n   */\n  async executeWithRecording(\n    input: BrowserTaskInput & { record_video: true }\n  ): Promise<BrowserTaskResult & { recording?: RecordingStatus }> {\n    return executeWithRecording(input, this.config);\n  }\n\n  /**\n   * Get recording status and URLs\n   */\n  async getRecording(recordingId: string): Promise<RecordingStatus> {\n    return getRecording(recordingId, this.config);\n  }\n\n  /**\n   * Wait for recording to complete with automatic polling\n   */\n  async waitForRecording(\n    recordingId: string,\n    options?: { timeout?: number; pollInterval?: number }\n  ): Promise<RecordingStatus> {\n    return waitForRecording(recordingId, this.config, options);\n  }\n\n  /**\n   * Get errors from recording with screenshots\n   */\n  async getErrors(recordingId: string): Promise<ErrorsResponse> {\n    return getErrors(recordingId, this.config);\n  }\n\n  /**\n   * Check if browser worker service is healthy\n   */\n  async checkHealth(): Promise<{\n    ok: boolean;\n    google_configured: boolean;\n    database_configured: boolean;\n    s3_configured: boolean;\n    error?: string;\n  }> {\n    return checkHealth(this.config);\n  }\n}\n\n/**\n * Execute a natural language browser automation task\n * \n * Returns the full task result including rich agent history data (urls, errors, \n * action_history, judgement, etc.). When using this as an agent tool, use the\n * formatResult() functions from the SDK adapters to return a concise summary.\n * \n * @param input - Task parameters\n * @param config - Optional configuration (apiKey, apiUrl to override default)\n * @returns Task result with success status, findings, and comprehensive execution history\n * \n * @example\n * ```typescript\n * const result = await executeBrowserTask(\n *   {\n *     task: \"Test checkout flow for buying a pineapple\",\n *     url: \"https://3000-abc.e2b.dev\",\n *     max_steps: 20,\n *     repo_id: \"my-project\",\n *     commit_id: \"uuid-here\"\n *   },\n *   {\n *     apiKey: process.env.MORPH_API_KEY,\n *     // apiUrl: 'http://localhost:8001' // Override for local testing\n *   }\n * );\n * \n * if (result.success) {\n *   console.log('Task completed:', result.result);\n *   console.log('URLs visited:', result.urls);\n *   console.log('Actions taken:', result.action_names);\n *   console.log('Has errors:', result.has_errors);\n *   console.log('Replay:', result.replay_url);\n * }\n * ```\n */\nexport async function executeBrowserTask(\n  input: BrowserTaskInput,\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const timeout = config.timeout || DEFAULT_CONFIG.timeout;\n  const debug = config.debug || false;\n\n  if (!input.task || input.task.trim().length === 0) {\n    return { \n      success: false, \n      error: 'Task description is required. Example: \"Go to example.com and click the login button\"' \n    };\n  }\n\n  if (input.max_steps !== undefined && (input.max_steps < 1 || input.max_steps > 50)) {\n    return { \n      success: false, \n      error: 'max_steps must be between 1 and 50. Use more steps for complex multi-page flows.' \n    };\n  }\n\n  if (debug) {\n    console.log(`[Browser] Task: \"${input.task.slice(0, 60)}...\" url=${input.url || 'none'} maxSteps=${input.max_steps ?? 10}`);\n    console.log(`[Browser] Recording: ${input.record_video ? 'yes' : 'no'} | Calling ${apiUrl}/browser-task`);\n  }\n\n  const startTime = Date.now();\n\n  try {\n    const headers: Record<string, string> = { 'Content-Type': 'application/json' };\n    if (config.apiKey) headers['Authorization'] = `Bearer ${config.apiKey}`;\n\n    const fetchPromise = fetchWithRetry(\n      `${apiUrl}/browser-task`,\n      {\n        method: 'POST',\n        headers,\n        body: JSON.stringify({\n          task: input.task,\n          url: input.url,\n          max_steps: input.max_steps ?? 10,\n          model: input.model ?? 'morph-computer-use-v0',\n          viewport_width: input.viewport_width ?? 1280,\n          viewport_height: input.viewport_height ?? 720,\n          external_id: input.external_id,\n          repo_id: input.repo_id,\n          commit_id: input.commit_id,\n          record_video: input.record_video ?? false,\n          video_width: input.video_width ?? input.viewport_width ?? 1280,\n          video_height: input.video_height ?? input.viewport_height ?? 720,\n          structured_output: input.structured_output,\n        }),\n      },\n      config.retryConfig\n    );\n\n    const response = await withTimeout(\n      fetchPromise,\n      timeout,\n      `Browser task timed out after ${timeout}ms. Consider increasing timeout or reducing max_steps.`\n    );\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => response.statusText);\n      if (debug) console.error(`[Browser] Error: ${response.status} - ${errorText}`);\n      throw new Error(`HTTP ${response.status}: ${errorText}`);\n    }\n\n    const result: BrowserTaskResult = await response.json();\n    const elapsed = Date.now() - startTime;\n    \n    if (debug) {\n      console.log(`[Browser] ✅ ${result.success ? 'Success' : 'Failed'} in ${elapsed}ms | steps=${result.steps_taken ?? 0} recordingId=${result.recording_id ?? 'none'}`);\n    }\n\n    return result;\n\n  } catch (error) {\n    if (error instanceof Error) {\n      // Handle network errors\n      if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch failed')) {\n        return {\n          success: false,\n          error: `Cannot connect to browser worker at ${apiUrl}. Ensure the service is running and accessible. For local dev, set MORPH_ENVIRONMENT=DEV.`,\n        };\n      }\n\n      return {\n        success: false,\n        error: error.message,\n      };\n    }\n\n    return {\n      success: false,\n      error: String(error),\n    };\n  }\n}\n\n/**\n * Get recording status and video URL\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @returns Recording status with video URL when ready\n * \n * @example\n * ```typescript\n * const status = await getRecording('uuid-here', { apiKey: 'key' });\n * if (status.status === 'COMPLETED' && status.video_url) {\n *   console.log('Video ready:', status.video_url);\n * }\n * ```\n */\nexport async function getRecording(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<RecordingStatus> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (!config.apiKey) {\n    throw new Error('API key required for getRecording');\n  }\n\n  if (debug) console.log(`[Browser] getRecording: ${recordingId}`);\n\n  const response = await fetch(`${apiUrl}/recordings/${recordingId}`, {\n    method: 'GET',\n    headers: { 'Authorization': `Bearer ${config.apiKey}` },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getRecording error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const recording = await response.json();\n  if (debug) console.log(`[Browser] Recording status: ${recording.status}`);\n\n  return recording;\n}\n\n/**\n * Wait for recording to complete with automatic polling\n * \n * @param recordingId - Recording UUID\n * @param config - Configuration with apiKey\n * @param options - Polling options\n * @returns Recording status when completed or errored\n * \n * @example\n * ```typescript\n * const result = await executeBrowserTask({ task: '...', record_video: true }, config);\n * if (result.recording_id) {\n *   const recording = await waitForRecording(result.recording_id, config, {\n *     timeout: 60000,  // 1 minute\n *     pollInterval: 2000  // Check every 2 seconds\n *   });\n *   console.log('Video URL:', recording.video_url);\n * }\n * ```\n */\nexport async function waitForRecording(\n  recordingId: string,\n  config: BrowserConfig = {},\n  options: { timeout?: number; pollInterval?: number } = {}\n): Promise<RecordingStatus> {\n  const timeout = options.timeout ?? 60000; // Default 1 minute\n  const pollInterval = options.pollInterval ?? 2000; // Default 2 seconds\n  const startTime = Date.now();\n\n  while (Date.now() - startTime < timeout) {\n    const status = await getRecording(recordingId, config);\n    \n    if (status.status === 'COMPLETED' || status.status === 'ERROR') {\n      return status;\n    }\n\n    // Wait before next poll\n    await new Promise(resolve => setTimeout(resolve, pollInterval));\n  }\n\n  throw new Error(`Recording timeout after ${timeout}ms - status still pending`);\n}\n\n/**\n * Execute task with recording and wait for video to be ready\n * \n * @param input - Task parameters with record_video=true\n * @param config - Configuration with apiKey\n * @returns Task result with ready video URL\n * \n * @example\n * ```typescript\n * const result = await executeWithRecording(\n *   {\n *     task: \"Test checkout flow\",\n *     url: \"https://example.com\",\n *     record_video: true,\n *     repo_id: \"my-project\"\n *   },\n *   { apiKey: process.env.MORPH_API_KEY }\n * );\n * \n * console.log('Task result:', result.result);\n * console.log('Video URL:', result.recording?.video_url);\n * ```\n */\nexport async function executeWithRecording(\n  input: BrowserTaskInput & { record_video: true },\n  config: BrowserConfig = {}\n): Promise<BrowserTaskResult & { recording?: RecordingStatus }> {\n  // Execute task with recording\n  const taskResult = await executeBrowserTask(input, config);\n\n  // If recording was created, wait for it to complete\n  if (taskResult.recording_id) {\n    try {\n      const recording = await waitForRecording(\n        taskResult.recording_id,\n        config,\n        { timeout: 60000, pollInterval: 2000 }\n      );\n      return {\n        ...taskResult,\n        recording,\n      };\n    } catch (error) {\n      // Return task result even if recording fails\n      return {\n        ...taskResult,\n        recording: {\n          id: taskResult.recording_id,\n          status: 'ERROR',\n          error: error instanceof Error ? error.message : String(error),\n          created_at: new Date().toISOString(),\n        },\n      };\n    }\n  }\n\n  return taskResult;\n}\n\n/**\n * Get errors from recording with screenshots\n * \n * Screenshots are captured in real-time (500ms after error occurs) during the browser session.\n * \n * @param recordingId - Recording UUID from BrowserTaskResult\n * @param config - Configuration with apiKey\n * @returns Errors with real-time screenshots\n * \n * @example\n * ```typescript\n * const { errors, total_errors } = await getErrors('uuid-here', { apiKey: 'key' });\n * \n * console.log(`Found ${total_errors} errors`);\n * \n * errors.forEach(err => {\n *   console.log(`[${err.type}] ${err.message}`);\n *   if (err.url) console.log(`  URL: ${err.url}`);\n *   if (err.screenshot_url) console.log(`  Screenshot: ${err.screenshot_url}`);\n *   \n *   // Download screenshot\n *   if (err.screenshot_url) {\n *     const response = await fetch(err.screenshot_url);\n *     const screenshot = await response.arrayBuffer();\n *     // Save or process screenshot\n *   }\n * });\n * ```\n */\nexport async function getErrors(\n  recordingId: string,\n  config: BrowserConfig = {}\n): Promise<ErrorsResponse> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (!config.apiKey) {\n    throw new Error('API key required for getErrors');\n  }\n\n  if (debug) console.log(`[Browser] getErrors: ${recordingId}`);\n\n  const response = await fetch(`${apiUrl}/recordings/${recordingId}/errors`, {\n    method: 'GET',\n    headers: { 'Authorization': `Bearer ${config.apiKey}` },\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getErrors error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const errors = await response.json();\n  if (debug) console.log(`[Browser] Found ${errors.total_errors} errors`);\n\n  return errors;\n}\n\n/**\n * Helper to serialize Zod schema for API\n */\nfunction stringifyStructuredOutput(schema: any): string {\n  try {\n    return JSON.stringify({\n      type: 'object',\n      description: 'Zod schema definition (Zod v3)',\n      zodDef: schema._def,\n    });\n  } catch (error) {\n    console.warn('[Browser] Failed to serialize Zod schema:', error);\n    return JSON.stringify({\n      type: 'object',\n      description: 'Schema serialization failed',\n    });\n  }\n}\n\n/**\n * Parse and validate structured task output\n */\nfunction parseStructuredTaskOutput<T>(\n  result: BrowserTaskResult,\n  schema: any\n): BrowserTaskResult & { parsed: T | null } {\n  if (!result.output) {\n    return { ...result, parsed: null };\n  }\n\n  try {\n    const parsed = JSON.parse(result.output);\n    const validated = schema.parse(parsed) as T;\n    return { ...result, parsed: validated };\n  } catch (error) {\n    if (error instanceof SyntaxError) {\n      return { ...result, parsed: null };\n    }\n    throw error;\n  }\n}\n\n/**\n * Get current task status\n */\nasync function getTaskStatus(\n  taskId: string,\n  config: BrowserConfig\n): Promise<BrowserTaskResult> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const debug = config.debug || false;\n\n  if (debug) console.log(`[Browser] getTaskStatus: ${taskId}`);\n\n  const headers: Record<string, string> = {};\n  if (config.apiKey) headers['Authorization'] = `Bearer ${config.apiKey}`;\n\n  const response = await fetch(`${apiUrl}/tasks/${taskId}`, {\n    method: 'GET',\n    headers,\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    if (debug) console.error(`[Browser] getTaskStatus error: ${response.status} - ${errorText}`);\n    throw new Error(`HTTP ${response.status}: ${errorText}`);\n  }\n\n  const result: BrowserTaskResult = await response.json();\n  if (debug) console.log(`[Browser] Task status: ${result.status}`);\n\n  return result;\n}\n\n/**\n * Generate live URL for watching task execution in real-time\n */\nfunction generateLiveUrl(taskId: string, config: BrowserConfig): string {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n  const baseUrl = apiUrl.replace('/api', '');\n  return `${baseUrl}/tasks/${taskId}/live`;\n}\n\n/**\n * Poll task until completion\n */\nasync function pollTaskUntilComplete(\n  taskId: string,\n  config: BrowserConfig,\n  pollConfig: { interval?: number; timeout?: number } = {}\n): Promise<BrowserTaskResult> {\n  const interval = pollConfig.interval ?? 2000; // 2 seconds\n  const timeout = pollConfig.timeout ?? 300000; // 5 minutes\n  const startTime = Date.now();\n\n  while (Date.now() - startTime < timeout) {\n    const status = await getTaskStatus(taskId, config);\n    \n    if (status.status === 'completed' || status.status === 'failed') {\n      return status;\n    }\n\n    await new Promise(resolve => setTimeout(resolve, interval));\n  }\n\n  throw new Error(`Task polling timeout after ${timeout}ms`);\n}\n\n/**\n * Wrap task response with convenience methods\n */\nfunction wrapTaskResponse(\n  result: BrowserTaskResult,\n  config: BrowserConfig\n): BrowserTaskWithPromise {\n  const wrapped: BrowserTaskWithPromise = {\n    ...result,\n    task_id: result.task_id || '',\n    liveUrl: result.task_id \n      ? generateLiveUrl(result.task_id, config)\n      : result.debugUrl || '',\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      return pollTaskUntilComplete(result.task_id!, config, pollConfig);\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help.'\n          );\n        },\n  };\n\n  return wrapped;\n}\n\n/**\n * Wrap task response with schema validation\n */\nfunction wrapTaskResponseWithSchema<T>(\n  result: BrowserTaskResult,\n  config: BrowserConfig,\n  schema: any\n): BrowserTaskWithPromiseAndSchema<T> {\n  const parsed = result.output\n    ? parseStructuredTaskOutput<T>(result, schema)\n    : { ...result, parsed: null };\n\n  const wrapped: BrowserTaskWithPromiseAndSchema<T> = {\n    ...parsed,\n    task_id: result.task_id || '',\n    liveUrl: result.task_id\n      ? generateLiveUrl(result.task_id, config)\n      : result.debugUrl || '',\n    complete: async (pollConfig?: { interval?: number; timeout?: number }) => {\n      const finalResult = await pollTaskUntilComplete(result.task_id!, config, pollConfig);\n      return parseStructuredTaskOutput<T>(finalResult, schema);\n    },\n    // Add Steel live session helpers - either functional or error-throwing\n    getLiveUrl: result.debugUrl\n      ? (options?: LiveSessionOptions) => buildLiveUrl(result.debugUrl!, options)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions. '\n          );\n        },\n    getLiveIframe: result.debugUrl\n      ? (optionsOrPreset?: string | IframeOptions) => {\n          const options = resolvePreset(optionsOrPreset);\n          return buildLiveIframe(result.debugUrl!, options);\n        }\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n    getEmbedCode: result.debugUrl\n      ? () => buildEmbedCode(result.debugUrl!)\n      : () => {\n          throw new Error(\n            'Live sessions not available. Your backend must return a debugUrl in the response. ' +\n            'Contact support@morphllm.com if you need help enabling live sessions.'\n          );\n        },\n  };\n\n  return wrapped;\n}\n\n/**\n * Check if browser worker service is healthy\n * \n * @param config - Optional configuration\n * @returns Health status\n */\nexport async function checkHealth(config: BrowserConfig = {}): Promise<{\n  ok: boolean;\n  google_configured: boolean;\n  database_configured: boolean;\n  s3_configured: boolean;\n  error?: string;\n}> {\n  const apiUrl = config.apiUrl || DEFAULT_CONFIG.apiUrl;\n\n  try {\n    const response = await fetch(`${apiUrl}/health`, {\n      method: 'GET',\n      headers: config.apiKey\n        ? { 'Authorization': `Bearer ${config.apiKey}` }\n        : {},\n    });\n\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}`);\n    }\n\n    const data = await response.json();\n    return {\n      ok: true,\n      google_configured: data.google_configured ?? false,\n      database_configured: data.database_configured ?? false,\n      s3_configured: data.s3_configured ?? false,\n    };\n  } catch (error) {\n    return {\n      ok: false,\n      google_configured: false,\n      database_configured: false,\n      s3_configured: false,\n      error: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n"],"mappings":"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","names":[]}

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-OVIJAG5M.js → chunk-UYBIKZPM.js}

@@ -1,3 +1,6 @@
+import {
+  readAllLines
+} from "./chunk-G2RSY56Q.js";
 import {
   isSymlink,
   isTextualFile,
@@ -7,9 +10,6 @@ import {
 import {
   runRipgrep
 } from "./chunk-RSLIOCOE.js";
-import {
-  readAllLines
-} from "./chunk-G2RSY56Q.js";
 import {
   DEFAULT_EXCLUDES
 } from "./chunk-AFEPUNAO.js";
@@ -132,4 +132,4 @@ var LocalRipgrepProvider = class {
 export {
   LocalRipgrepProvider
 };
-//# sourceMappingURL=chunk-OVIJAG5M.js.map
+//# sourceMappingURL=chunk-UYBIKZPM.js.map

package/dist/{chunk-4VAOPM2H.js → chunk-W5CHJ6OX.js}

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

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

@@ -1,9 +1,9 @@
 import {
   runWarpGrep
-} from "./chunk-JJ5ONKDN.js";
+} from "./chunk-EAA7D24N.js";
 import {
   LocalRipgrepProvider
-} from "./chunk-OVIJAG5M.js";
+} from "./chunk-UYBIKZPM.js";
 
 // tools/warp_grep/vercel.ts
 import { tool } from "ai";
@@ -41,4 +41,4 @@ function createMorphWarpGrepTool(config) {
 export {
   createMorphWarpGrepTool
 };
-//# sourceMappingURL=chunk-LAA6XJBF.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,