@morphllm/morphsdk 0.2.14 → 0.2.16

package/dist/git/client.d.ts

@@ -0,0 +1,230 @@
+import { MorphGitConfig, CloneOptions, PushOptions, PullOptions, AddOptions, CommitOptions, StatusOptions, LogOptions, CommitObject, CheckoutOptions, BranchOptions, StatusResult } from './types.js';
+import 'isomorphic-git';
+import 'isomorphic-git/http/node';
+import '../tools/utils/resilience.js';
+
+/**
+ * Morph Git Client - Simple, high-level Git operations
+ * Built on isomorphic-git with explicit configuration
+ */
+
+/**
+ * MorphGit - Git operations for AI agents with Morph backend
+ *
+ * @example
+ * ```typescript
+ * import { MorphGit } from 'morphsdk/git';
+ *
+ * const morphGit = new MorphGit({
+ *   apiKey: process.env.MORPH_API_KEY!,
+ *   proxyUrl: 'https://repos.morphllm.com' // Optional
+ * });
+ *
+ * await morphGit.init({ repoId: 'my-project', dir: './my-project' });
+ * await morphGit.push({ dir: './my-project' });
+ * ```
+ */
+declare class MorphGit {
+    private readonly apiKey;
+    private readonly proxyUrl;
+    constructor(config: MorphGitConfig);
+    /**
+     * Get auth callback for isomorphic-git operations
+     * @private
+     */
+    private getAuthCallback;
+    /**
+     * Initialize a new repository
+     * Creates the repo in the database and in the git provider
+     *
+     * @example
+     * ```ts
+     * await morphGit.init({
+     *   repoId: 'my-project',
+     *   dir: './my-project',
+     *   defaultBranch: 'main'
+     * });
+     * ```
+     */
+    init(options: {
+        repoId: string;
+        dir: string;
+        defaultBranch?: string;
+    }): Promise<void>;
+    /**
+     * Clone a repository from Morph repos
+     *
+     * @example
+     * ```ts
+     * await morphGit.clone({
+     *   repoId: 'my-project',
+     *   dir: './my-project'
+     * });
+     * ```
+     */
+    clone(options: CloneOptions): Promise<void>;
+    /**
+     * Push changes to remote repository
+     *
+     * @example
+     * ```ts
+     * await morphGit.push({ dir: './my-project' });
+     * ```
+     */
+    push(options: PushOptions): Promise<void>;
+    /**
+     * Pull changes from remote repository
+     *
+     * @example
+     * ```ts
+     * await morphGit.pull({ dir: './my-project' });
+     * ```
+     */
+    pull(options: PullOptions): Promise<void>;
+    /**
+     * Stage a file for commit
+     *
+     * @example
+     * ```ts
+     * await morphGit.add({
+     *   dir: './my-project',
+     *   filepath: 'src/app.ts'
+     * });
+     * ```
+     */
+    add(options: AddOptions): Promise<void>;
+    /**
+     * Remove a file from staging
+     *
+     * @example
+     * ```ts
+     * await morphGit.remove({
+     *   dir: './my-project',
+     *   filepath: 'src/old-file.ts'
+     * });
+     * ```
+     */
+    remove(options: AddOptions): Promise<void>;
+    /**
+     * Commit staged changes
+     *
+     * @example
+     * ```ts
+     * await morphGit.commit({
+     *   dir: './my-project',
+     *   message: 'Add new feature',
+     *   author: {
+     *     name: 'AI Agent',
+     *     email: 'ai@example.com'
+     *   }
+     * });
+     * ```
+     */
+    commit(options: CommitOptions): Promise<string>;
+    /**
+     * Get status of a file
+     *
+     * @example
+     * ```ts
+     * const status = await morphGit.status({
+     *   dir: './my-project',
+     *   filepath: 'src/app.ts'
+     * });
+     * console.log(status); // 'modified', '*added', etc.
+     * ```
+     */
+    status(options: StatusOptions): Promise<string>;
+    /**
+     * Get commit history
+     *
+     * @example
+     * ```ts
+     * const commits = await morphGit.log({
+     *   dir: './my-project',
+     *   depth: 10
+     * });
+     * ```
+     */
+    log(options: LogOptions): Promise<CommitObject[]>;
+    /**
+     * Checkout a branch or commit
+     *
+     * @example
+     * ```ts
+     * await morphGit.checkout({
+     *   dir: './my-project',
+     *   ref: 'feature-branch'
+     * });
+     * ```
+     */
+    checkout(options: CheckoutOptions): Promise<void>;
+    /**
+     * Create a new branch
+     *
+     * @example
+     * ```ts
+     * await morphGit.branch({
+     *   dir: './my-project',
+     *   name: 'feature-branch',
+     *   checkout: true
+     * });
+     * ```
+     */
+    branch(options: BranchOptions): Promise<void>;
+    /**
+     * List all branches
+     *
+     * @example
+     * ```ts
+     * const branches = await morphGit.listBranches({
+     *   dir: './my-project'
+     * });
+     * ```
+     */
+    listBranches(options: {
+        dir: string;
+    }): Promise<string[]>;
+    /**
+     * Get the current branch name
+     *
+     * @example
+     * ```ts
+     * const branch = await morphGit.currentBranch({
+     *   dir: './my-project'
+     * });
+     * ```
+     */
+    currentBranch(options: {
+        dir: string;
+    }): Promise<string | undefined>;
+    /**
+     * Get list of changed files (similar to git diff --name-only)
+     *
+     * @example
+     * ```ts
+     * const changes = await morphGit.statusMatrix({
+     *   dir: './my-project'
+     * });
+     * ```
+     */
+    statusMatrix(options: {
+        dir: string;
+    }): Promise<StatusResult[]>;
+    /**
+     * Get the current commit hash
+     *
+     * @example
+     * ```ts
+     * const hash = await morphGit.resolveRef({
+     *   dir: './my-project',
+     *   ref: 'HEAD'
+     * });
+     * ```
+     */
+    resolveRef(options: {
+        dir: string;
+        ref: string;
+    }): Promise<string>;
+}
+
+export { MorphGit };

package/dist/git/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Configuration constants for Morph Git SDK
+ */
+/** Default proxy URL for Morph git operations */
+declare const DEFAULT_PROXY_URL = "https://repos.morphllm.com";
+/**
+ * Validate API key format
+ */
+declare function validateApiKey(apiKey: string): void;
+
+export { DEFAULT_PROXY_URL, validateApiKey };

package/dist/git/index.d.ts

@@ -0,0 +1,5 @@
+export { MorphGit } from './client.js';
+export { AddOptions, BranchOptions, CheckoutOptions, CloneOptions, CommitObject, CommitOptions, DiffOptions, LogOptions, MorphGitConfig, PullOptions, PushOptions, StatusOptions, StatusResult } from './types.js';
+export { default as git } from 'isomorphic-git';
+export { default as http } from 'isomorphic-git/http/node';
+import '../tools/utils/resilience.js';

package/dist/git/types.d.ts

@@ -0,0 +1,91 @@
+import { RetryConfig } from '../tools/utils/resilience.js';
+
+/**
+ * Types for Morph Git SDK
+ */
+
+interface MorphGitConfig {
+    apiKey?: string;
+    proxyUrl?: string;
+    /** Retry configuration for API calls */
+    retryConfig?: RetryConfig;
+}
+interface CloneOptions {
+    repoId: string;
+    dir: string;
+    branch?: string;
+    depth?: number;
+    singleBranch?: boolean;
+}
+interface PushOptions {
+    dir: string;
+    remote?: string;
+    branch?: string;
+}
+interface PullOptions {
+    dir: string;
+    remote?: string;
+    branch?: string;
+}
+interface AddOptions {
+    dir: string;
+    filepath: string;
+}
+interface CommitOptions {
+    dir: string;
+    message: string;
+    author?: {
+        name: string | "Morph AI Agent";
+        email: string | "ai@morphllm.com";
+    };
+}
+interface StatusOptions {
+    dir: string;
+    filepath?: string;
+}
+interface LogOptions {
+    dir: string;
+    depth?: number;
+    ref?: string;
+}
+interface CheckoutOptions {
+    dir: string;
+    ref: string;
+}
+interface BranchOptions {
+    dir: string;
+    name: string;
+    checkout?: boolean;
+}
+interface DiffOptions {
+    dir: string;
+    ref1?: string;
+    ref2?: string;
+    filepath?: string;
+}
+interface GitUser {
+    name: string;
+    email: string;
+}
+interface CommitObject {
+    oid: string;
+    commit: {
+        message: string;
+        author: {
+            name: string | "Morph AI Agent";
+            email: string | "ai@morphllm.com";
+            timestamp: number;
+        };
+        committer: {
+            name: string | "Morph AI Agent";
+            email: string | "ai@morphllm.com";
+            timestamp: number;
+        };
+    };
+}
+interface StatusResult {
+    filepath: string;
+    status: 'unmodified' | 'modified' | '*modified' | 'added' | '*added' | 'deleted' | '*deleted' | 'absent';
+}
+
+export type { AddOptions, BranchOptions, CheckoutOptions, CloneOptions, CommitObject, CommitOptions, DiffOptions, GitUser, LogOptions, MorphGitConfig, PullOptions, PushOptions, StatusOptions, StatusResult };

package/dist/index.cjs

@@ -748,36 +748,27 @@ function wrapTaskResponse(result, config) {
     liveUrl: generateLiveUrl(result.task_id, config),
     complete: async (pollConfig) => {
       return pollTaskUntilComplete(result.task_id, config, pollConfig);
-    }
-  };
-  if (result.debugUrl) {
-    wrapped.getLiveUrl = (options) => {
-      return buildLiveUrl(result.debugUrl, options);
-    };
-    wrapped.getLiveIframe = (optionsOrPreset) => {
-      const options = resolvePreset(optionsOrPreset);
-      return buildLiveIframe(result.debugUrl, options);
-    };
-    wrapped.getEmbedCode = () => {
-      return buildEmbedCode(result.debugUrl);
-    };
-  } else {
-    wrapped.getLiveUrl = () => {
+    },
+    // Add Steel live session helpers - either functional or error-throwing
+    getLiveUrl: result.debugUrl ? (options) => buildLiveUrl(result.debugUrl, options) : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
       );
-    };
-    wrapped.getLiveIframe = () => {
+    },
+    getLiveIframe: result.debugUrl ? (optionsOrPreset) => {
+      const options = resolvePreset(optionsOrPreset);
+      return buildLiveIframe(result.debugUrl, options);
+    } : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
       );
-    };
-    wrapped.getEmbedCode = () => {
+    },
+    getEmbedCode: result.debugUrl ? () => buildEmbedCode(result.debugUrl) : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help."
       );
-    };
-  }
+    }
+  };
   return wrapped;
 }
 function wrapTaskResponseWithSchema(result, config, schema) {
@@ -792,36 +783,27 @@ function wrapTaskResponseWithSchema(result, config, schema) {
     complete: async (pollConfig) => {
       const finalResult = await pollTaskUntilComplete(result.task_id, config, pollConfig);
       return parseStructuredTaskOutput(finalResult, schema);
-    }
-  };
-  if (result.debugUrl) {
-    wrapped.getLiveUrl = (options) => {
-      return buildLiveUrl(result.debugUrl, options);
-    };
-    wrapped.getLiveIframe = (optionsOrPreset) => {
-      const options = resolvePreset(optionsOrPreset);
-      return buildLiveIframe(result.debugUrl, options);
-    };
-    wrapped.getEmbedCode = () => {
-      return buildEmbedCode(result.debugUrl);
-    };
-  } else {
-    wrapped.getLiveUrl = () => {
+    },
+    // Add Steel live session helpers - either functional or error-throwing
+    getLiveUrl: result.debugUrl ? (options) => buildLiveUrl(result.debugUrl, options) : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions. "
       );
-    };
-    wrapped.getLiveIframe = () => {
+    },
+    getLiveIframe: result.debugUrl ? (optionsOrPreset) => {
+      const options = resolvePreset(optionsOrPreset);
+      return buildLiveIframe(result.debugUrl, options);
+    } : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions."
       );
-    };
-    wrapped.getEmbedCode = () => {
+    },
+    getEmbedCode: result.debugUrl ? () => buildEmbedCode(result.debugUrl) : () => {
       throw new Error(
         "Live sessions not available. Your backend must return a debugUrl in the response. Contact support@morphllm.com if you need help enabling live sessions."
       );
-    };
-  }
+    }
+  };
   return wrapped;
 }
 async function checkHealth(config = {}) {