feat: add tailor.aigateway.get types for AI Gateway URL resolution (#189)

Author: dragon3

.changeset/tailor-aigateway-get.md

@@ -0,0 +1,5 @@
+---
+"@tailor-platform/function-types": minor
+---
+
+Add `tailor.aigateway.get(name)` types for resolving an AI Gateway URL in the caller's workspace.

packages/types/tailor.d.ts

@@ -61,6 +61,27 @@ declare namespace tailor.authconnection {
   function getConnectionToken(connectionName: string): Promise<any>;
 }
 
+declare namespace tailor.aigateway {
+  /**
+   * AIGateway describes a resolved AI Gateway in the caller's workspace.
+   */
+  interface AIGateway {
+    /**
+     * Base URL of the AI Gateway, e.g.
+     * `https://my-aigateway-<workspace_hash>.ai.erp.dev`. Requests to this URL
+     * are automatically authenticated for the calling workspace.
+     */
+    url: string;
+  }
+
+  /**
+   * get resolves a named AI Gateway in the caller's own workspace and returns
+   * it. The gateway's existence is verified at call time, so resolving a name
+   * that does not exist rejects rather than failing later inside `fetch`.
+   */
+  function get(name: string): Promise<AIGateway>;
+}
+
 declare namespace tailor.iconv {
   /**
    * Convert string from one encoding to another