@terreno/ai 0.16.1 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Helper for listing models available to the Gemini Developer API (the API-key based
3
+ * `generativelanguage.googleapis.com` service, distinct from Vertex / the Gemini Enterprise Agent
4
+ * Platform). Used to drive model pickers from the live set of models Google actually exposes for a
5
+ * given API key, so retired models (e.g. an old `gemini-2.0-flash`) never appear.
6
+ */
7
+ /** Default Gemini Developer API base URL. */
8
+ export declare const GEMINI_API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
9
+ export interface ListGeminiApiModelsOptions {
10
+ /** Gemini Developer API key. */
11
+ apiKey: string;
12
+ /** Override the API base URL (primarily for testing). Defaults to `GEMINI_API_BASE_URL`. */
13
+ baseUrl?: string;
14
+ /**
15
+ * When true (the default), only models that support `generateContent` (i.e. chat-capable models)
16
+ * are returned. Set to false to return every listed model id.
17
+ */
18
+ chatOnly?: boolean;
19
+ /** Injectable fetch implementation (defaults to the global `fetch`). */
20
+ fetchImpl?: typeof fetch;
21
+ }
22
+ /** Strip the "models/" resource prefix from a Gemini model name (e.g. "models/gemini-2.5-flash"). */
23
+ export declare const normalizeGeminiModelId: (name: string) => string;
24
+ /**
25
+ * List the models available to a Gemini Developer API key via the `models` REST endpoint. Returns
26
+ * normalized model ids (e.g. "gemini-2.5-flash"). By default only chat-capable models (those
27
+ * supporting `generateContent`) are returned. Returns `undefined` when the listing could not be
28
+ * retrieved (missing key, network error, non-200 response, etc.).
29
+ */
30
+ export declare const listGeminiApiModels: (options: ListGeminiApiModelsOptions) => Promise<string[] | undefined>;
@@ -0,0 +1,154 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ Object.defineProperty(exports, "__esModule", { value: true });
50
+ exports.listGeminiApiModels = exports.normalizeGeminiModelId = exports.GEMINI_API_BASE_URL = void 0;
51
+ var api_1 = require("@terreno/api");
52
+ /**
53
+ * Helper for listing models available to the Gemini Developer API (the API-key based
54
+ * `generativelanguage.googleapis.com` service, distinct from Vertex / the Gemini Enterprise Agent
55
+ * Platform). Used to drive model pickers from the live set of models Google actually exposes for a
56
+ * given API key, so retired models (e.g. an old `gemini-2.0-flash`) never appear.
57
+ */
58
+ /** Default Gemini Developer API base URL. */
59
+ exports.GEMINI_API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
60
+ var MAX_MODEL_LIST_PAGES = 10;
61
+ var MODEL_LIST_PAGE_SIZE = "200";
62
+ var GENERATE_CONTENT_METHOD = "generateContent";
63
+ /** Strip the "models/" resource prefix from a Gemini model name (e.g. "models/gemini-2.5-flash"). */
64
+ var normalizeGeminiModelId = function (name) {
65
+ return name.trim().replace(/^models\//, "");
66
+ };
67
+ exports.normalizeGeminiModelId = normalizeGeminiModelId;
68
+ /**
69
+ * List the models available to a Gemini Developer API key via the `models` REST endpoint. Returns
70
+ * normalized model ids (e.g. "gemini-2.5-flash"). By default only chat-capable models (those
71
+ * supporting `generateContent`) are returned. Returns `undefined` when the listing could not be
72
+ * retrieved (missing key, network error, non-200 response, etc.).
73
+ */
74
+ var listGeminiApiModels = function (options) { return __awaiter(void 0, void 0, void 0, function () {
75
+ var apiKey, fetchImpl, chatOnly, baseUrl, models, pageToken, pages, url, response, body, _a, _b, model, error_1;
76
+ var e_1, _c;
77
+ var _d, _e, _f, _g, _h;
78
+ return __generator(this, function (_j) {
79
+ switch (_j.label) {
80
+ case 0:
81
+ apiKey = options.apiKey;
82
+ if (!apiKey) {
83
+ return [2 /*return*/, undefined];
84
+ }
85
+ fetchImpl = (_d = options.fetchImpl) !== null && _d !== void 0 ? _d : globalThis.fetch;
86
+ if (!fetchImpl) {
87
+ api_1.logger.warn("No fetch implementation available for Gemini model listing.");
88
+ return [2 /*return*/, undefined];
89
+ }
90
+ chatOnly = (_e = options.chatOnly) !== null && _e !== void 0 ? _e : true;
91
+ baseUrl = (_f = options.baseUrl) !== null && _f !== void 0 ? _f : exports.GEMINI_API_BASE_URL;
92
+ models = [];
93
+ pages = 0;
94
+ _j.label = 1;
95
+ case 1:
96
+ _j.trys.push([1, 7, , 8]);
97
+ _j.label = 2;
98
+ case 2:
99
+ url = new URL("".concat(baseUrl, "/models"));
100
+ url.searchParams.set("key", apiKey);
101
+ url.searchParams.set("pageSize", MODEL_LIST_PAGE_SIZE);
102
+ if (pageToken) {
103
+ url.searchParams.set("pageToken", pageToken);
104
+ }
105
+ return [4 /*yield*/, fetchImpl(url.toString())];
106
+ case 3:
107
+ response = _j.sent();
108
+ if (!response.ok) {
109
+ api_1.logger.warn("Gemini model listing failed with status ".concat(response.status, "."));
110
+ return [2 /*return*/, undefined];
111
+ }
112
+ return [4 /*yield*/, response.json()];
113
+ case 4:
114
+ body = (_j.sent());
115
+ try {
116
+ for (_a = (e_1 = void 0, __values((_g = body.models) !== null && _g !== void 0 ? _g : [])), _b = _a.next(); !_b.done; _b = _a.next()) {
117
+ model = _b.value;
118
+ if (!model.name) {
119
+ continue;
120
+ }
121
+ if (chatOnly &&
122
+ !((_h = model.supportedGenerationMethods) !== null && _h !== void 0 ? _h : []).includes(GENERATE_CONTENT_METHOD)) {
123
+ continue;
124
+ }
125
+ models.push((0, exports.normalizeGeminiModelId)(model.name));
126
+ }
127
+ }
128
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
129
+ finally {
130
+ try {
131
+ if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
132
+ }
133
+ finally { if (e_1) throw e_1.error; }
134
+ }
135
+ pageToken = body.nextPageToken;
136
+ pages += 1;
137
+ _j.label = 5;
138
+ case 5:
139
+ if (pageToken && pages < MAX_MODEL_LIST_PAGES) return [3 /*break*/, 2];
140
+ _j.label = 6;
141
+ case 6: return [3 /*break*/, 8];
142
+ case 7:
143
+ error_1 = _j.sent();
144
+ api_1.logger.warn("Gemini model listing errored: ".concat(error_1.message));
145
+ return [2 /*return*/, undefined];
146
+ case 8:
147
+ if (pageToken) {
148
+ api_1.logger.warn("Gemini model listing exceeded ".concat(MAX_MODEL_LIST_PAGES, " pages; returning partial list."));
149
+ }
150
+ return [2 /*return*/, models];
151
+ }
152
+ });
153
+ }); };
154
+ exports.listGeminiApiModels = listGeminiApiModels;
@@ -1,5 +1,9 @@
1
1
  export { AIService, TemperaturePresets } from "./aiService";
2
2
  export { FileStorageService } from "./fileStorage";
3
+ export type { ListGeminiApiModelsOptions } from "./gemini";
4
+ export { GEMINI_API_BASE_URL, listGeminiApiModels, normalizeGeminiModelId } from "./gemini";
3
5
  export { MCPService } from "./mcpService";
4
6
  export { CONTENT_SUMMARY_PROMPT, DEFAULT_GPT_MEMORY, REMIX_PROMPT, TITLE_GENERATION_PROMPT, TRANSLATION_PROMPT, } from "./prompts";
7
+ export type { CreateVertexProviderOptions, ListEnabledVertexModelsOptions, TerrenoVertexProvider, VerifyVertexModelsOptions, VertexLanguageModelProvider, VertexModelAvailability, } from "./vertex";
8
+ export { assertVertexModelsEnabled, createVertexProvider, DEFAULT_VERTEX_LOCATION, isVertexModelAllowed, listEnabledVertexModels, normalizeVertexModelId, verifyVertexModelsEnabled, } from "./vertex";
5
9
  export type { WebSearchProvider, WebSearchResult } from "./webSearchTool";
@@ -1,11 +1,15 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.TRANSLATION_PROMPT = exports.TITLE_GENERATION_PROMPT = exports.REMIX_PROMPT = exports.DEFAULT_GPT_MEMORY = exports.CONTENT_SUMMARY_PROMPT = exports.MCPService = exports.FileStorageService = exports.TemperaturePresets = exports.AIService = void 0;
3
+ exports.verifyVertexModelsEnabled = exports.normalizeVertexModelId = exports.listEnabledVertexModels = exports.isVertexModelAllowed = exports.DEFAULT_VERTEX_LOCATION = exports.createVertexProvider = exports.assertVertexModelsEnabled = exports.TRANSLATION_PROMPT = exports.TITLE_GENERATION_PROMPT = exports.REMIX_PROMPT = exports.DEFAULT_GPT_MEMORY = exports.CONTENT_SUMMARY_PROMPT = exports.MCPService = exports.normalizeGeminiModelId = exports.listGeminiApiModels = exports.GEMINI_API_BASE_URL = exports.FileStorageService = exports.TemperaturePresets = exports.AIService = void 0;
4
4
  var aiService_1 = require("./aiService");
5
5
  Object.defineProperty(exports, "AIService", { enumerable: true, get: function () { return aiService_1.AIService; } });
6
6
  Object.defineProperty(exports, "TemperaturePresets", { enumerable: true, get: function () { return aiService_1.TemperaturePresets; } });
7
7
  var fileStorage_1 = require("./fileStorage");
8
8
  Object.defineProperty(exports, "FileStorageService", { enumerable: true, get: function () { return fileStorage_1.FileStorageService; } });
9
+ var gemini_1 = require("./gemini");
10
+ Object.defineProperty(exports, "GEMINI_API_BASE_URL", { enumerable: true, get: function () { return gemini_1.GEMINI_API_BASE_URL; } });
11
+ Object.defineProperty(exports, "listGeminiApiModels", { enumerable: true, get: function () { return gemini_1.listGeminiApiModels; } });
12
+ Object.defineProperty(exports, "normalizeGeminiModelId", { enumerable: true, get: function () { return gemini_1.normalizeGeminiModelId; } });
9
13
  var mcpService_1 = require("./mcpService");
10
14
  Object.defineProperty(exports, "MCPService", { enumerable: true, get: function () { return mcpService_1.MCPService; } });
11
15
  var prompts_1 = require("./prompts");
@@ -14,3 +18,11 @@ Object.defineProperty(exports, "DEFAULT_GPT_MEMORY", { enumerable: true, get: fu
14
18
  Object.defineProperty(exports, "REMIX_PROMPT", { enumerable: true, get: function () { return prompts_1.REMIX_PROMPT; } });
15
19
  Object.defineProperty(exports, "TITLE_GENERATION_PROMPT", { enumerable: true, get: function () { return prompts_1.TITLE_GENERATION_PROMPT; } });
16
20
  Object.defineProperty(exports, "TRANSLATION_PROMPT", { enumerable: true, get: function () { return prompts_1.TRANSLATION_PROMPT; } });
21
+ var vertex_1 = require("./vertex");
22
+ Object.defineProperty(exports, "assertVertexModelsEnabled", { enumerable: true, get: function () { return vertex_1.assertVertexModelsEnabled; } });
23
+ Object.defineProperty(exports, "createVertexProvider", { enumerable: true, get: function () { return vertex_1.createVertexProvider; } });
24
+ Object.defineProperty(exports, "DEFAULT_VERTEX_LOCATION", { enumerable: true, get: function () { return vertex_1.DEFAULT_VERTEX_LOCATION; } });
25
+ Object.defineProperty(exports, "isVertexModelAllowed", { enumerable: true, get: function () { return vertex_1.isVertexModelAllowed; } });
26
+ Object.defineProperty(exports, "listEnabledVertexModels", { enumerable: true, get: function () { return vertex_1.listEnabledVertexModels; } });
27
+ Object.defineProperty(exports, "normalizeVertexModelId", { enumerable: true, get: function () { return vertex_1.normalizeVertexModelId; } });
28
+ Object.defineProperty(exports, "verifyVertexModelsEnabled", { enumerable: true, get: function () { return vertex_1.verifyVertexModelsEnabled; } });
@@ -0,0 +1,115 @@
1
+ import type { ImageModel, LanguageModel } from "ai";
2
+ /**
3
+ * Helper for Google's Vertex AI provider, now part of the "Gemini Enterprise Agent Platform"
4
+ * (formerly Vertex AI), renamed at Google Cloud Next 2026. The `@ai-sdk/google-vertex` provider
5
+ * and the underlying `*-aiplatform.googleapis.com` REST endpoints are unchanged by the rename;
6
+ * this module centralizes provider creation, model allow-listing, and enabled-model verification
7
+ * against the Gemini Enterprise Agent Platform (Vertex AI) APIs.
8
+ *
9
+ * Behavior:
10
+ * - By default ALL Vertex models are permitted (no allow-list).
11
+ * - Consumers may pass `allowedModels` to restrict which models can be resolved when initializing.
12
+ * - `verifyVertexModelsEnabled` / `assertVertexModelsEnabled` confirm that the requested models are
13
+ * actually enabled/available for the project using the Google publisher-models listing API.
14
+ */
15
+ /** Default Vertex / Gemini Enterprise Agent Platform region. */
16
+ export declare const DEFAULT_VERTEX_LOCATION = "us-central1";
17
+ /** Provider returned by `@ai-sdk/google-vertex` `createVertex`. */
18
+ export interface VertexLanguageModelProvider {
19
+ (modelId: string): LanguageModel;
20
+ image: (modelId: string) => ImageModel;
21
+ }
22
+ export interface CreateVertexProviderOptions {
23
+ /**
24
+ * Optional allow-list of model ids consumers may use. When omitted or empty (the default), ALL
25
+ * Vertex models are permitted. When provided, only listed models may be resolved.
26
+ */
27
+ allowedModels?: string[];
28
+ /** Vertex location/region. Falls back to GOOGLE_VERTEX_LOCATION, then `us-central1`. */
29
+ location?: string;
30
+ /** GCP project id. Falls back to the GOOGLE_VERTEX_PROJECT env var. */
31
+ project?: string;
32
+ /**
33
+ * Injectable factory for the `@ai-sdk/google-vertex` provider, primarily for testing. When
34
+ * omitted, the provider is loaded dynamically from `@ai-sdk/google-vertex`.
35
+ */
36
+ vertexFactory?: (opts: {
37
+ location: string;
38
+ project: string;
39
+ }) => VertexLanguageModelProvider;
40
+ }
41
+ export interface TerrenoVertexProvider {
42
+ /** Configured allow-list (`undefined` means all models are allowed). */
43
+ allowedModels?: string[];
44
+ /** Resolve an image model, enforcing the allow-list. Throws `APIError(400)` when disallowed. */
45
+ imageModel: (modelId: string) => ImageModel;
46
+ /** Returns true when the model id is permitted by the configured allow-list. */
47
+ isModelAllowed: (modelId: string) => boolean;
48
+ /** Resolve a language model, enforcing the allow-list. Throws `APIError(400)` when disallowed. */
49
+ languageModel: (modelId: string) => LanguageModel;
50
+ /** Configured Vertex location. */
51
+ location: string;
52
+ /** Configured GCP project id. */
53
+ project: string;
54
+ /** Underlying `@ai-sdk/google-vertex` provider. */
55
+ raw: VertexLanguageModelProvider;
56
+ }
57
+ export interface ListEnabledVertexModelsOptions {
58
+ /** Injectable fetch implementation (defaults to the global `fetch`). */
59
+ fetchImpl?: typeof fetch;
60
+ /** Injectable access-token getter (defaults to Application Default Credentials). */
61
+ getAccessToken?: () => Promise<string | undefined>;
62
+ /** Vertex location/region. Falls back to GOOGLE_VERTEX_LOCATION, then `us-central1`. */
63
+ location?: string;
64
+ /** GCP project id. */
65
+ project: string;
66
+ }
67
+ export interface VertexModelAvailability {
68
+ /** Requested models confirmed available/enabled via the Google API. */
69
+ available: string[];
70
+ /** Whether the Google API listing was successfully retrieved (false means it was skipped). */
71
+ checked: boolean;
72
+ /** Requested models that were NOT found in the Google API listing. */
73
+ unavailable: string[];
74
+ }
75
+ export interface VerifyVertexModelsOptions extends ListEnabledVertexModelsOptions {
76
+ /** Injectable model-listing function, primarily for testing. */
77
+ listModelsFn?: (options: ListEnabledVertexModelsOptions) => Promise<string[] | undefined>;
78
+ /** Models to verify are enabled/available for the project. */
79
+ models: string[];
80
+ }
81
+ /**
82
+ * Normalize a publisher model resource name (e.g. "publishers/google/models/gemini-2.5-flash" or
83
+ * "gemini-2.5-flash@001") down to its bare model id (e.g. "gemini-2.5-flash").
84
+ */
85
+ export declare const normalizeVertexModelId: (modelName: string) => string;
86
+ /**
87
+ * Returns true when the model id is permitted. An empty/undefined allow-list permits all models.
88
+ * Both the requested model id and allow-list entries are normalized (publisher paths and `@version`
89
+ * suffixes stripped) so matching stays consistent with `verifyVertexModelsEnabled`.
90
+ */
91
+ export declare const isVertexModelAllowed: (modelId: string, allowedModels?: string[]) => boolean;
92
+ /**
93
+ * Create a Vertex AI (Gemini Enterprise Agent Platform) provider that enforces an optional model
94
+ * allow-list. Returns `undefined` when no project is configured or `@ai-sdk/google-vertex` is not
95
+ * installed, so callers can fall back to another provider or demo mode.
96
+ */
97
+ export declare const createVertexProvider: (options?: CreateVertexProviderOptions) => TerrenoVertexProvider | undefined;
98
+ /**
99
+ * List the Google publisher models available to a project via the Gemini Enterprise Agent Platform
100
+ * (Vertex AI) `publishers/google/models` endpoint. Returns the normalized model ids, or `undefined`
101
+ * when the listing could not be retrieved (missing credentials, network error, etc.).
102
+ */
103
+ export declare const listEnabledVertexModels: (options: ListEnabledVertexModelsOptions) => Promise<string[] | undefined>;
104
+ /**
105
+ * Verify that the requested models are enabled/available for the project using the Google APIs.
106
+ * When the listing cannot be retrieved (e.g. no credentials), `checked` is false and verification
107
+ * is treated as inconclusive rather than failing.
108
+ */
109
+ export declare const verifyVertexModelsEnabled: (options: VerifyVertexModelsOptions) => Promise<VertexModelAvailability>;
110
+ /**
111
+ * Like `verifyVertexModelsEnabled`, but throws an `APIError` when the listing was retrieved and one
112
+ * or more requested models are not enabled/available. Inconclusive checks (no credentials/network)
113
+ * do not throw so local development and offline environments keep working.
114
+ */
115
+ export declare const assertVertexModelsEnabled: (options: VerifyVertexModelsOptions) => Promise<VertexModelAvailability>;