feat: Phani/deploy with GitHub url

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 57
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-6c765f1c4ce1c4dd4ceb371f56bf047aa79af36031ba43cbd68fa16a5fdb9bb3.yml
-openapi_spec_hash: e9086f69281360f4e0895c9274a59531
-config_hash: deadfc4d2b0a947673bcf559b5db6e1b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-6eaa6f5654abc94549962d7db1e8c7936af1f815bb3abe2f8249959394da1278.yml
+openapi_spec_hash: 31ece7cd801e74228b80a8112a762e56
+config_hash: 3fc2057ce765bc5f27785a694ed0f553

README.md

@@ -67,29 +67,17 @@ import Kernel, { toFile } from '@onkernel/sdk';
 const client = new Kernel();
 
 // If you have access to Node `fs` we recommend using `fs.createReadStream()`:
-await client.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: fs.createReadStream('/path/to/file'),
-});
+await client.deployments.create({ file: fs.createReadStream('/path/to/file') });
 
 // Or if you have the web `File` API you can pass a `File` instance:
-await client.deployments.create({ entrypoint_rel_path: 'src/app.py', file: new File(['my bytes'], 'file') });
+await client.deployments.create({ file: new File(['my bytes'], 'file') });
 
 // You can also pass a `fetch` `Response`:
-await client.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await fetch('https://somesite/file'),
-});
+await client.deployments.create({ file: await fetch('https://somesite/file') });
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await toFile(Buffer.from('my bytes'), 'file'),
-});
-await client.deployments.create({
-  entrypoint_rel_path: 'src/app.py',
-  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
-});
+await client.deployments.create({ file: await toFile(Buffer.from('my bytes'), 'file') });
+await client.deployments.create({ file: await toFile(new Uint8Array([0, 1, 2]), 'file') });
 ```
 
 ## Handling errors

api.md

@@ -183,13 +183,13 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/extensions.ts">ExtensionCreateResponse</a></code>
 - <code><a href="./src/resources/extensions.ts">ExtensionListResponse</a></code>
-- <code><a href="./src/resources/extensions.ts">ExtensionUploadResponse</a></code>
 
 Methods:
 
+- <code title="post /extensions">client.extensions.<a href="./src/resources/extensions.ts">create</a>({ ...params }) -> ExtensionCreateResponse</code>
+- <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">retrieve</a>(idOrName) -> Response</code>
 - <code title="get /extensions">client.extensions.<a href="./src/resources/extensions.ts">list</a>() -> ExtensionListResponse</code>
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">delete</a>(idOrName) -> void</code>
-- <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/resources/extensions.ts">download</a>(idOrName) -> Response</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/resources/extensions.ts">downloadFromChromeStore</a>({ ...params }) -> Response</code>
-- <code title="post /extensions">client.extensions.<a href="./src/resources/extensions.ts">upload</a>({ ...params }) -> ExtensionUploadResponse</code>

src/client.ts

@@ -33,10 +33,10 @@ import {
 } from './resources/deployments';
 import { KernelApp } from './core/app-framework';
 import {
+  ExtensionCreateParams,
+  ExtensionCreateResponse,
   ExtensionDownloadFromChromeStoreParams,
   ExtensionListResponse,
-  ExtensionUploadParams,
-  ExtensionUploadResponse,
   Extensions,
 } from './resources/extensions';
 import {
@@ -918,10 +918,10 @@ export declare namespace Kernel {
 
   export {
     Extensions as Extensions,
+    type ExtensionCreateResponse as ExtensionCreateResponse,
     type ExtensionListResponse as ExtensionListResponse,
-    type ExtensionUploadResponse as ExtensionUploadResponse,
+    type ExtensionCreateParams as ExtensionCreateParams,
     type ExtensionDownloadFromChromeStoreParams as ExtensionDownloadFromChromeStoreParams,
-    type ExtensionUploadParams as ExtensionUploadParams,
   };
 
   export type AppAction = API.AppAction;

src/resources/deployments.ts

@@ -19,7 +19,10 @@ export class Deployments extends APIResource {
    * ```ts
    * const deployment = await client.deployments.create({
    *   entrypoint_rel_path: 'src/app.py',
+   *   env_vars: { FOO: 'bar' },
    *   file: fs.createReadStream('path/to/file'),
+   *   region: 'aws.us-east-1a',
+   *   version: '1.0.0',
    * });
    * ```
    */
@@ -349,19 +352,19 @@ export interface DeploymentCreateParams {
   /**
    * Relative path to the entrypoint of the application
    */
-  entrypoint_rel_path: string;
-
-  /**
-   * ZIP file containing the application source directory
-   */
-  file: Uploadable;
+  entrypoint_rel_path?: string;
 
   /**
    * Map of environment variables to set for the deployed application. Each key-value
    * pair represents an environment variable.
    */
   env_vars?: { [key: string]: string };
 
+  /**
+   * ZIP file containing the application source directory
+   */
+  file?: Uploadable;
+
   /**
    * Allow overwriting an existing app version
    */
@@ -372,12 +375,71 @@ export interface DeploymentCreateParams {
    */
   region?: 'aws.us-east-1a';
 
+  /**
+   * Source from which to fetch application code.
+   */
+  source?: DeploymentCreateParams.Source;
+
   /**
    * Version of the application. Can be any string.
    */
   version?: string;
 }
 
+export namespace DeploymentCreateParams {
+  /**
+   * Source from which to fetch application code.
+   */
+  export interface Source {
+    /**
+     * Relative path to the application entrypoint within the selected path.
+     */
+    entrypoint: string;
+
+    /**
+     * Git ref (branch, tag, or commit SHA) to fetch.
+     */
+    ref: string;
+
+    /**
+     * Source type identifier.
+     */
+    type: 'github';
+
+    /**
+     * Base repository URL (without blob/tree suffixes).
+     */
+    url: string;
+
+    /**
+     * Authentication for private repositories.
+     */
+    auth?: Source.Auth;
+
+    /**
+     * Path within the repo to deploy (omit to use repo root).
+     */
+    path?: string;
+  }
+
+  export namespace Source {
+    /**
+     * Authentication for private repositories.
+     */
+    export interface Auth {
+      /**
+       * GitHub PAT or installation access token
+       */
+      token: string;
+
+      /**
+       * Auth method
+       */
+      method: 'github_token';
+    }
+  }
+}
+
 export interface DeploymentListParams extends OffsetPaginationParams {
   /**
    * Filter results by application name.

src/resources/extensions.ts

@@ -10,50 +10,65 @@ import { path } from '../internal/utils/path';
 
 export class Extensions extends APIResource {
   /**
-   * List extensions owned by the caller's organization.
+   * Upload a zip file containing an unpacked browser extension. Optionally provide a
+   * unique name for later reference.
    *
    * @example
    * ```ts
-   * const extensions = await client.extensions.list();
+   * const extension = await client.extensions.create({
+   *   file: fs.createReadStream('path/to/file'),
+   * });
    * ```
    */
-  list(options?: RequestOptions): APIPromise<ExtensionListResponse> {
-    return this._client.get('/extensions', options);
+  create(body: ExtensionCreateParams, options?: RequestOptions): APIPromise<ExtensionCreateResponse> {
+    return this._client.post('/extensions', multipartFormRequestOptions({ body, ...options }, this._client));
   }
 
   /**
-   * Delete an extension by its ID or by its name.
+   * Download the extension as a ZIP archive by ID or name.
    *
    * @example
    * ```ts
-   * await client.extensions.delete('id_or_name');
+   * const extension = await client.extensions.retrieve(
+   *   'id_or_name',
+   * );
+   *
+   * const content = await extension.blob();
+   * console.log(content);
    * ```
    */
-  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/extensions/${idOrName}`, {
+  retrieve(idOrName: string, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/extensions/${idOrName}`, {
       ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
+      __binaryResponse: true,
     });
   }
 
   /**
-   * Download the extension as a ZIP archive by ID or name.
+   * List extensions owned by the caller's organization.
    *
    * @example
    * ```ts
-   * const response = await client.extensions.download(
-   *   'id_or_name',
-   * );
+   * const extensions = await client.extensions.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<ExtensionListResponse> {
+    return this._client.get('/extensions', options);
+  }
+
+  /**
+   * Delete an extension by its ID or by its name.
    *
-   * const content = await response.blob();
-   * console.log(content);
+   * @example
+   * ```ts
+   * await client.extensions.delete('id_or_name');
    * ```
    */
-  download(idOrName: string, options?: RequestOptions): APIPromise<Response> {
-    return this._client.get(path`/extensions/${idOrName}`, {
+  delete(idOrName: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/extensions/${idOrName}`, {
       ...options,
-      headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
-      __binaryResponse: true,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
   }
 
@@ -83,21 +98,37 @@ export class Extensions extends APIResource {
       __binaryResponse: true,
     });
   }
+}
 
+/**
+ * A browser extension uploaded to Kernel.
+ */
+export interface ExtensionCreateResponse {
   /**
-   * Upload a zip file containing an unpacked browser extension. Optionally provide a
-   * unique name for later reference.
-   *
-   * @example
-   * ```ts
-   * const response = await client.extensions.upload({
-   *   file: fs.createReadStream('path/to/file'),
-   * });
-   * ```
+   * Unique identifier for the extension
    */
-  upload(body: ExtensionUploadParams, options?: RequestOptions): APIPromise<ExtensionUploadResponse> {
-    return this._client.post('/extensions', multipartFormRequestOptions({ body, ...options }, this._client));
-  }
+  id: string;
+
+  /**
+   * Timestamp when the extension was created
+   */
+  created_at: string;
+
+  /**
+   * Size of the extension archive in bytes
+   */
+  size_bytes: number;
+
+  /**
+   * Timestamp when the extension was last used
+   */
+  last_used_at?: string | null;
+
+  /**
+   * Optional, easier-to-reference name for the extension. Must be unique within the
+   * organization.
+   */
+  name?: string | null;
 }
 
 export type ExtensionListResponse = Array<ExtensionListResponse.ExtensionListResponseItem>;
@@ -135,35 +166,16 @@ export namespace ExtensionListResponse {
   }
 }
 
-/**
- * A browser extension uploaded to Kernel.
- */
-export interface ExtensionUploadResponse {
-  /**
-   * Unique identifier for the extension
-   */
-  id: string;
-
+export interface ExtensionCreateParams {
   /**
-   * Timestamp when the extension was created
-   */
-  created_at: string;
-
-  /**
-   * Size of the extension archive in bytes
-   */
-  size_bytes: number;
-
-  /**
-   * Timestamp when the extension was last used
+   * ZIP file containing the browser extension.
    */
-  last_used_at?: string | null;
+  file: Uploadable;
 
   /**
-   * Optional, easier-to-reference name for the extension. Must be unique within the
-   * organization.
+   * Optional unique name within the organization to reference this extension.
    */
-  name?: string | null;
+  name?: string;
 }
 
 export interface ExtensionDownloadFromChromeStoreParams {
@@ -178,23 +190,11 @@ export interface ExtensionDownloadFromChromeStoreParams {
   os?: 'win' | 'mac' | 'linux';
 }
 
-export interface ExtensionUploadParams {
-  /**
-   * ZIP file containing the browser extension.
-   */
-  file: Uploadable;
-
-  /**
-   * Optional unique name within the organization to reference this extension.
-   */
-  name?: string;
-}
-
 export declare namespace Extensions {
   export {
+    type ExtensionCreateResponse as ExtensionCreateResponse,
     type ExtensionListResponse as ExtensionListResponse,
-    type ExtensionUploadResponse as ExtensionUploadResponse,
+    type ExtensionCreateParams as ExtensionCreateParams,
     type ExtensionDownloadFromChromeStoreParams as ExtensionDownloadFromChromeStoreParams,
-    type ExtensionUploadParams as ExtensionUploadParams,
   };
 }