@mcarvin/smart-diff 1.1.0 → 2.0.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.
- package/README.md +101 -21
- package/dist/index.cjs +255 -109
- package/dist/index.cjs.map +1 -1
- package/dist/index.min.cjs +1 -1
- package/dist/index.min.cjs.map +1 -1
- package/dist/index.min.mjs +1 -1
- package/dist/index.min.mjs.map +1 -1
- package/dist/index.min.umd.js +1 -1
- package/dist/index.min.umd.js.map +1 -1
- package/dist/index.mjs +252 -106
- package/dist/index.mjs.map +1 -1
- package/dist/index.umd.js +258 -113
- package/dist/index.umd.js.map +1 -1
- package/dist/typings/ai/aiTypes.d.ts +5 -3
- package/dist/typings/ai/llmProviders.d.ts +12 -0
- package/dist/typings/index.d.ts +7 -5
- package/package.json +33 -7
- package/dist/typings/ai/openAIConfig.d.ts +0 -21
package/README.md
CHANGED
|
@@ -6,12 +6,13 @@
|
|
|
6
6
|
[](https://qlty.sh/gh/mcarvin8/projects/smart-diff)
|
|
7
7
|
[](https://codecov.io/gh/mcarvin8/smart-diff)
|
|
8
8
|
|
|
9
|
-
TypeScript library that turns a **git revision range** into a **Markdown summary** using
|
|
9
|
+
TypeScript library that turns a **git revision range** into a **Markdown summary** using any LLM provider supported by the [Vercel AI SDK](https://sdk.vercel.ai) — OpenAI, Anthropic, Google Gemini, Amazon Bedrock, Mistral, Cohere, Groq, xAI, DeepSeek, or any OpenAI-compatible gateway. It uses [`simple-git`](https://github.com/steveukx/git-js) to read the repo, respects **path includes/excludes** and **commit message include/exclude regexes**, and sends commits, paths, structured diff stats, and unified diff text to the model.
|
|
10
10
|
|
|
11
11
|
## Requirements
|
|
12
12
|
|
|
13
13
|
- **Node.js** 20+
|
|
14
|
-
- [
|
|
14
|
+
- An LLM provider credential (see [Provider configuration](#provider-configuration))
|
|
15
|
+
- [Git](https://git-scm.com/) on the `PATH`
|
|
15
16
|
|
|
16
17
|
## Installation
|
|
17
18
|
|
|
@@ -19,25 +20,70 @@ TypeScript library that turns a **git revision range** into a **Markdown summary
|
|
|
19
20
|
npm install @mcarvin/smart-diff
|
|
20
21
|
```
|
|
21
22
|
|
|
22
|
-
|
|
23
|
+
`@ai-sdk/openai` and `@ai-sdk/openai-compatible` ship as direct dependencies. Every other provider (`@ai-sdk/anthropic`, `@ai-sdk/google`, `@ai-sdk/amazon-bedrock`, `@ai-sdk/mistral`, `@ai-sdk/cohere`, `@ai-sdk/groq`, `@ai-sdk/xai`, `@ai-sdk/deepseek`) is declared as an **optional peer** and only needs to be installed when you actually use that provider. If the package is missing, smart-diff throws a clear error telling you which one to install.
|
|
23
24
|
|
|
24
|
-
|
|
25
|
+
## Provider configuration
|
|
26
|
+
|
|
27
|
+
smart-diff is "configured" when [`isLlmProviderConfigured()`](#lower-level-api) returns true — i.e. at least one supported provider can be resolved from env vars — **or** you pass your own `llmModelProvider` factory. Otherwise `summarizeGitDiff` / `generateSummary` throw with `LLM_GATEWAY_REQUIRED_MESSAGE`.
|
|
28
|
+
|
|
29
|
+
### Selecting a provider
|
|
30
|
+
|
|
31
|
+
`LLM_PROVIDER` explicitly selects a provider. When unset, the resolver auto-detects in this order: `LLM_BASE_URL`/`OPENAI_BASE_URL` → `openai-compatible`, `OPENAI_API_KEY`/`LLM_API_KEY` → `openai`, then `ANTHROPIC_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY` (or `GOOGLE_API_KEY`), `MISTRAL_API_KEY`, `COHERE_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`, `DEEPSEEK_API_KEY`, and finally `OPENAI_DEFAULT_HEADERS`/`LLM_DEFAULT_HEADERS` → `openai`.
|
|
32
|
+
|
|
33
|
+
| Provider (`LLM_PROVIDER`) | Package | Credential env vars | Default model |
|
|
34
|
+
|---|---|---|---|
|
|
35
|
+
| `openai` | `@ai-sdk/openai` | `OPENAI_API_KEY` or `LLM_API_KEY` | `gpt-4o-mini` |
|
|
36
|
+
| `openai-compatible` | `@ai-sdk/openai-compatible` | `LLM_BASE_URL` or `OPENAI_BASE_URL` (required); `OPENAI_API_KEY`/`LLM_API_KEY` or custom headers | `gpt-4o-mini` |
|
|
37
|
+
| `anthropic` | `@ai-sdk/anthropic` | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-latest` |
|
|
38
|
+
| `google` | `@ai-sdk/google` | `GOOGLE_GENERATIVE_AI_API_KEY` or `GOOGLE_API_KEY` | `gemini-2.0-flash` |
|
|
39
|
+
| `bedrock` | `@ai-sdk/amazon-bedrock` | Standard AWS credential chain (env / profile / role) | `anthropic.claude-3-5-haiku-20241022-v1:0` |
|
|
40
|
+
| `mistral` | `@ai-sdk/mistral` | `MISTRAL_API_KEY` | `mistral-small-latest` |
|
|
41
|
+
| `cohere` | `@ai-sdk/cohere` | `COHERE_API_KEY` | `command-r-08-2024` |
|
|
42
|
+
| `groq` | `@ai-sdk/groq` | `GROQ_API_KEY` | `llama-3.1-8b-instant` |
|
|
43
|
+
| `xai` | `@ai-sdk/xai` | `XAI_API_KEY` | `grok-2-latest` |
|
|
44
|
+
| `deepseek` | `@ai-sdk/deepseek` | `DEEPSEEK_API_KEY` | `deepseek-chat` |
|
|
45
|
+
|
|
46
|
+
> `LLM_*` wins over `OPENAI_*` where both exist.
|
|
47
|
+
|
|
48
|
+
### Common env vars
|
|
25
49
|
|
|
26
50
|
| Variable | Purpose |
|
|
27
|
-
|
|
28
|
-
| `
|
|
29
|
-
| `
|
|
30
|
-
| `
|
|
31
|
-
| `
|
|
32
|
-
| `
|
|
51
|
+
|---|---|
|
|
52
|
+
| `LLM_PROVIDER` | Explicit provider id from the table above. |
|
|
53
|
+
| `LLM_MODEL` | Overrides the per-provider default model id. |
|
|
54
|
+
| `OPENAI_BASE_URL` / `LLM_BASE_URL` | Base URL for an OpenAI-compatible gateway; presence alone auto-selects the `openai-compatible` provider. |
|
|
55
|
+
| `OPENAI_DEFAULT_HEADERS` / `LLM_DEFAULT_HEADERS` | JSON object of extra headers merged onto OpenAI / OpenAI-compatible requests (e.g. RBAC tokens, raw `Authorization`). `LLM_*` overrides `OPENAI_*` key-by-key. |
|
|
56
|
+
| `LLM_PROVIDER_NAME` | Display name used when `openai-compatible` is active (defaults to `openai-compatible`). |
|
|
57
|
+
| `OPENAI_MAX_DIFF_CHARS` / `LLM_MAX_DIFF_CHARS` | Max size of unified diff text sent to the model (default ~120k characters). |
|
|
58
|
+
| `OPENAI_MAX_TOKENS` / `LLM_MAX_TOKENS` | Max completion tokens (default 4000). |
|
|
59
|
+
|
|
60
|
+
### Example: native OpenAI
|
|
61
|
+
|
|
62
|
+
```powershell
|
|
63
|
+
$env:OPENAI_API_KEY = "sk-..."
|
|
64
|
+
# Optional: $env:LLM_MODEL = "gpt-4o"
|
|
65
|
+
```
|
|
33
66
|
|
|
34
|
-
|
|
67
|
+
### Example: Anthropic Claude
|
|
68
|
+
|
|
69
|
+
```powershell
|
|
70
|
+
$env:ANTHROPIC_API_KEY = "sk-ant-..."
|
|
71
|
+
$env:LLM_MODEL = "claude-3-5-sonnet-latest" # optional override
|
|
72
|
+
```
|
|
35
73
|
|
|
36
|
-
Example
|
|
74
|
+
### Example: company-managed OpenAI-compatible gateway
|
|
37
75
|
|
|
38
76
|
```powershell
|
|
39
|
-
$env:
|
|
40
|
-
$env:
|
|
77
|
+
$env:OPENAI_BASE_URL = "https://llm-gateway.example.com"
|
|
78
|
+
$env:OPENAI_DEFAULT_HEADERS = '{"x-company-rbac":"your-rbac-token-here","Authorization":"Bearer sk-your-api-key-here"}'
|
|
79
|
+
# LLM_PROVIDER is auto-detected as "openai-compatible" because LLM_BASE_URL/OPENAI_BASE_URL is set.
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Example: Google Gemini
|
|
83
|
+
|
|
84
|
+
```powershell
|
|
85
|
+
$env:GOOGLE_GENERATIVE_AI_API_KEY = "..."
|
|
86
|
+
$env:LLM_MODEL = "gemini-2.0-flash"
|
|
41
87
|
```
|
|
42
88
|
|
|
43
89
|
## Usage
|
|
@@ -56,9 +102,10 @@ const markdown = await summarizeGitDiff({
|
|
|
56
102
|
commitMessageExcludeRegexes: ['^\\[bot\\]'],
|
|
57
103
|
commitMessageIncludeRegexes: ['^feat:'], // optional; OR across patterns
|
|
58
104
|
teamName: 'Platform',
|
|
59
|
-
systemPrompt: undefined,
|
|
60
|
-
|
|
61
|
-
|
|
105
|
+
systemPrompt: undefined, // optional; overrides DEFAULT_GIT_DIFF_SYSTEM_PROMPT
|
|
106
|
+
provider: 'anthropic', // optional; overrides LLM_PROVIDER env + auto-detection
|
|
107
|
+
model: 'claude-3-5-sonnet-latest', // optional
|
|
108
|
+
maxDiffChars: 120_000, // optional; also see LLM_MAX_DIFF_CHARS
|
|
62
109
|
});
|
|
63
110
|
```
|
|
64
111
|
|
|
@@ -72,9 +119,27 @@ const markdown = await summarizeGitDiff({
|
|
|
72
119
|
| `commitMessageExcludeRegexes` | Drop commits whose message matches **any** of these patterns. |
|
|
73
120
|
| `teamName` | Adds a `Team:` line to the user payload for the model. |
|
|
74
121
|
| `systemPrompt` | Replaces the default system prompt. |
|
|
75
|
-
| `
|
|
122
|
+
| `provider` | `LlmProviderId` — wins over `LLM_PROVIDER` env and auto-detection. |
|
|
123
|
+
| `model` | Chat model id; overrides `LLM_MODEL` and the provider default. |
|
|
76
124
|
| `maxDiffChars` | Caps unified diff size for the request. |
|
|
77
|
-
| `
|
|
125
|
+
| `llmModelProvider` | `() => Promise<LanguageModel>` — bypass env-based resolution entirely; hand-wire a Vercel AI SDK `LanguageModel` (required in tests or custom setups). |
|
|
126
|
+
|
|
127
|
+
### Injecting your own `LanguageModel`
|
|
128
|
+
|
|
129
|
+
If you want full control — for example, to configure retries, middlewares, or hit an in-process mock — pass `llmModelProvider`:
|
|
130
|
+
|
|
131
|
+
```ts
|
|
132
|
+
import { summarizeGitDiff } from '@mcarvin/smart-diff';
|
|
133
|
+
import { createAnthropic } from '@ai-sdk/anthropic';
|
|
134
|
+
|
|
135
|
+
const md = await summarizeGitDiff({
|
|
136
|
+
from: 'origin/main',
|
|
137
|
+
llmModelProvider: async () =>
|
|
138
|
+
createAnthropic({ apiKey: process.env.MY_ANTHROPIC_KEY })(
|
|
139
|
+
'claude-3-5-sonnet-latest',
|
|
140
|
+
),
|
|
141
|
+
});
|
|
142
|
+
```
|
|
78
143
|
|
|
79
144
|
### Diff shape: single range vs per-commit
|
|
80
145
|
|
|
@@ -83,13 +148,28 @@ const markdown = await summarizeGitDiff({
|
|
|
83
148
|
|
|
84
149
|
### Lower-level API
|
|
85
150
|
|
|
86
|
-
The package also exports helpers
|
|
151
|
+
The package also exports helpers for building a custom pipeline on top of the same git and LLM behavior:
|
|
152
|
+
|
|
153
|
+
- **Git**: `createGitClient`, `getRepoRoot`, `getCommits`, `getDiff`, `getDiffSummary`, `getChangedFiles`, `filterCommitsByMessageRegexes`, `buildDiffPathspecs`
|
|
154
|
+
- **AI**: `generateSummary`, `resolveLlmMaxDiffChars`, `truncateUnifiedDiffForLlm`
|
|
155
|
+
- **Provider resolution**: `resolveLanguageModel`, `detectLlmProvider`, `isLlmProviderConfigured`, `defaultModelForProvider`, `resolveLlmBaseUrl`, `parseLlmDefaultHeadersFromEnv`
|
|
156
|
+
- **Constants / types**: `DEFAULT_GIT_DIFF_SYSTEM_PROMPT`, `LLM_GATEWAY_REQUIRED_MESSAGE`, `LlmProviderId`, `LlmModelProvider`, `ResolveLanguageModelOptions`, `GenerateSummaryInput`, `SummarizeFlags`
|
|
157
|
+
|
|
158
|
+
## Migrating from 1.x → 2.x
|
|
159
|
+
|
|
160
|
+
v2 replaces the direct `openai` SDK dependency with the Vercel AI SDK. If you only rely on env-var configuration, your setup keeps working — `OPENAI_API_KEY`, `OPENAI_BASE_URL`, `OPENAI_DEFAULT_HEADERS`, `LLM_*` equivalents, `OPENAI_MAX_DIFF_CHARS`, and `OPENAI_MAX_TOKENS` are all still honored.
|
|
161
|
+
|
|
162
|
+
Breaking changes:
|
|
163
|
+
|
|
164
|
+
- **Removed `openAiClientProvider` option** on `summarizeGitDiff`/`generateSummary`. Use `llmModelProvider: () => Promise<LanguageModel>` returning a Vercel AI SDK model instead.
|
|
165
|
+
- **Removed `OpenAiLikeClient` and `createOpenAiLikeClient` exports**, along with `shouldUseLlmGateway`. Use `isLlmProviderConfigured()` / `resolveLanguageModel()` instead.
|
|
166
|
+
- **`openai` npm package is no longer a dependency.** Remove it from your own `package.json` if you only depended on it transitively via smart-diff.
|
|
87
167
|
|
|
88
168
|
## Used By
|
|
89
169
|
|
|
90
170
|
This package is used by:
|
|
91
171
|
|
|
92
|
-
- [sf-git-ai-meta-insights](https://github.com/mcarvin8/sf-git-ai-meta-insights)
|
|
172
|
+
- [sf-git-ai-meta-insights](https://github.com/mcarvin8/sf-git-ai-meta-insights) — Salesforce metadata wrapper compatible with Salesforce DX projects
|
|
93
173
|
|
|
94
174
|
## License
|
|
95
175
|
|
package/dist/index.cjs
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
+
var ai = require('ai');
|
|
3
4
|
var node_path = require('node:path');
|
|
4
5
|
var simpleGit = require('simple-git');
|
|
5
6
|
|
|
@@ -35,9 +36,55 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
|
|
|
35
36
|
return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
|
|
36
37
|
};
|
|
37
38
|
|
|
39
|
+
const DEFAULT_LLM_MAX_DIFF_CHARS = 120000;
|
|
40
|
+
const DEFAULT_GIT_DIFF_SYSTEM_PROMPT = `You are a senior software engineer helping developers understand code and configuration changes from the git context they supplied.
|
|
41
|
+
You receive: commit subject lines (when available), changed file paths, and unified git patch(es)—either one range diff or concatenated per-commit patches, depending on how the diff was produced. Patches may be truncated mid-section with an explicit marker—do not infer changes beyond visible lines.
|
|
42
|
+
Explain what changed in terms of behavior, APIs, data, configuration, security, and operational risk. Tie claims to the patch when possible.
|
|
43
|
+
Produce a concise, developer-focused summary in Markdown.
|
|
44
|
+
Use sections that fit the change (for example: Highlights, Breaking or risky changes, API / contract changes, Data & schema, Configuration & infra, Security & auth, Tests & quality). Omit empty sections.
|
|
45
|
+
Group related changes; do not list every individual file. When multiple commits appear in the context, briefly separate notable themes by commit when helpful.
|
|
46
|
+
If the user message includes a Team line, use that exact team name in the summary title (for example: "## <Team> – Change summary" or similar).`;
|
|
47
|
+
const LLM_GATEWAY_REQUIRED_MESSAGE = "No LLM provider configured. Set LLM_PROVIDER (openai | openai-compatible | anthropic | google | bedrock | mistral | cohere | groq | xai | deepseek), " +
|
|
48
|
+
"or a provider API key (OPENAI_API_KEY, LLM_API_KEY, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, MISTRAL_API_KEY, COHERE_API_KEY, GROQ_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY), " +
|
|
49
|
+
"or LLM_BASE_URL / OPENAI_BASE_URL for an OpenAI-compatible gateway, " +
|
|
50
|
+
"or JSON in OPENAI_DEFAULT_HEADERS / LLM_DEFAULT_HEADERS. " +
|
|
51
|
+
"Alternatively pass llmModelProvider or openAiClientProvider to generateSummary or summarizeGitDiff.";
|
|
52
|
+
|
|
53
|
+
const DEFAULT_MODEL_BY_PROVIDER = {
|
|
54
|
+
openai: "gpt-4o-mini",
|
|
55
|
+
"openai-compatible": "gpt-4o-mini",
|
|
56
|
+
anthropic: "claude-3-5-haiku-latest",
|
|
57
|
+
google: "gemini-2.0-flash",
|
|
58
|
+
bedrock: "anthropic.claude-3-5-haiku-20241022-v1:0",
|
|
59
|
+
mistral: "mistral-small-latest",
|
|
60
|
+
cohere: "command-r-08-2024",
|
|
61
|
+
groq: "llama-3.1-8b-instant",
|
|
62
|
+
xai: "grok-2-latest",
|
|
63
|
+
deepseek: "deepseek-chat",
|
|
64
|
+
};
|
|
65
|
+
const VALID_PROVIDERS = new Set([
|
|
66
|
+
"openai",
|
|
67
|
+
"openai-compatible",
|
|
68
|
+
"anthropic",
|
|
69
|
+
"google",
|
|
70
|
+
"bedrock",
|
|
71
|
+
"mistral",
|
|
72
|
+
"cohere",
|
|
73
|
+
"groq",
|
|
74
|
+
"xai",
|
|
75
|
+
"deepseek",
|
|
76
|
+
]);
|
|
77
|
+
function readEnv(name) {
|
|
78
|
+
var _a;
|
|
79
|
+
const value = (_a = process.env[name]) === null || _a === void 0 ? void 0 : _a.trim();
|
|
80
|
+
return value && value.length > 0 ? value : undefined;
|
|
81
|
+
}
|
|
82
|
+
function isValidProviderId(value) {
|
|
83
|
+
return VALID_PROVIDERS.has(value);
|
|
84
|
+
}
|
|
38
85
|
function resolveLlmBaseUrl() {
|
|
39
|
-
var _a
|
|
40
|
-
return (
|
|
86
|
+
var _a;
|
|
87
|
+
return (_a = readEnv("LLM_BASE_URL")) !== null && _a !== void 0 ? _a : readEnv("OPENAI_BASE_URL");
|
|
41
88
|
}
|
|
42
89
|
function parseHeaderJsonObject(raw) {
|
|
43
90
|
const trimmed = raw === null || raw === void 0 ? void 0 : raw.trim();
|
|
@@ -68,87 +115,187 @@ function parseLlmDefaultHeadersFromEnv() {
|
|
|
68
115
|
const merged = Object.assign(Object.assign({}, base), override);
|
|
69
116
|
return Object.keys(merged).length > 0 ? merged : undefined;
|
|
70
117
|
}
|
|
71
|
-
function
|
|
72
|
-
return Object.keys(headers).find((k) => k.toLowerCase() === "authorization");
|
|
73
|
-
}
|
|
74
|
-
function stripBearerPrefix(value) {
|
|
118
|
+
function resolveOpenAiApiKey() {
|
|
75
119
|
var _a;
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
if (
|
|
93
|
-
return
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
if (
|
|
103
|
-
return
|
|
104
|
-
if (
|
|
105
|
-
return
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
return
|
|
110
|
-
}
|
|
111
|
-
function
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
const
|
|
120
|
-
|
|
121
|
-
|
|
120
|
+
return (_a = readEnv("LLM_API_KEY")) !== null && _a !== void 0 ? _a : readEnv("OPENAI_API_KEY");
|
|
121
|
+
}
|
|
122
|
+
function detectLlmProvider() {
|
|
123
|
+
var _a, _b;
|
|
124
|
+
const explicit = (_a = readEnv("LLM_PROVIDER")) === null || _a === void 0 ? void 0 : _a.toLowerCase();
|
|
125
|
+
if (explicit && isValidProviderId(explicit)) {
|
|
126
|
+
return explicit;
|
|
127
|
+
}
|
|
128
|
+
if (resolveLlmBaseUrl()) {
|
|
129
|
+
return "openai-compatible";
|
|
130
|
+
}
|
|
131
|
+
if (resolveOpenAiApiKey()) {
|
|
132
|
+
return "openai";
|
|
133
|
+
}
|
|
134
|
+
if (readEnv("ANTHROPIC_API_KEY"))
|
|
135
|
+
return "anthropic";
|
|
136
|
+
if ((_b = readEnv("GOOGLE_GENERATIVE_AI_API_KEY")) !== null && _b !== void 0 ? _b : readEnv("GOOGLE_API_KEY"))
|
|
137
|
+
return "google";
|
|
138
|
+
if (readEnv("MISTRAL_API_KEY"))
|
|
139
|
+
return "mistral";
|
|
140
|
+
if (readEnv("COHERE_API_KEY"))
|
|
141
|
+
return "cohere";
|
|
142
|
+
if (readEnv("GROQ_API_KEY"))
|
|
143
|
+
return "groq";
|
|
144
|
+
if (readEnv("XAI_API_KEY"))
|
|
145
|
+
return "xai";
|
|
146
|
+
if (readEnv("DEEPSEEK_API_KEY"))
|
|
147
|
+
return "deepseek";
|
|
148
|
+
if (parseLlmDefaultHeadersFromEnv())
|
|
149
|
+
return "openai";
|
|
150
|
+
return undefined;
|
|
151
|
+
}
|
|
152
|
+
function isLlmProviderConfigured() {
|
|
153
|
+
return detectLlmProvider() !== undefined;
|
|
154
|
+
}
|
|
155
|
+
function defaultModelForProvider(provider) {
|
|
156
|
+
return DEFAULT_MODEL_BY_PROVIDER[provider];
|
|
157
|
+
}
|
|
158
|
+
function createOpenAiModel(modelId) {
|
|
159
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
160
|
+
const { createOpenAI } = yield import('@ai-sdk/openai');
|
|
161
|
+
const apiKey = resolveOpenAiApiKey();
|
|
162
|
+
const headers = parseLlmDefaultHeadersFromEnv();
|
|
163
|
+
const provider = createOpenAI(Object.assign(Object.assign({}, (apiKey ? { apiKey } : {})), (headers ? { headers } : {})));
|
|
164
|
+
return provider(modelId);
|
|
165
|
+
});
|
|
166
|
+
}
|
|
167
|
+
function createOpenAiCompatibleModel(modelId) {
|
|
168
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
169
|
+
var _a;
|
|
170
|
+
const { createOpenAICompatible } = yield import('@ai-sdk/openai-compatible');
|
|
171
|
+
const baseURL = resolveLlmBaseUrl();
|
|
172
|
+
if (!baseURL) {
|
|
173
|
+
throw new Error("openai-compatible provider requires LLM_BASE_URL or OPENAI_BASE_URL to be set.");
|
|
122
174
|
}
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
}
|
|
128
|
-
else {
|
|
129
|
-
defaultHeaders =
|
|
130
|
-
Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined;
|
|
131
|
-
}
|
|
132
|
-
return Object.assign(Object.assign({ apiKey: apiKey.length > 0 ? apiKey : "unused" }, (baseURL ? { baseURL } : {})), (defaultHeaders ? { defaultHeaders } : {}));
|
|
175
|
+
const apiKey = resolveOpenAiApiKey();
|
|
176
|
+
const headers = parseLlmDefaultHeadersFromEnv();
|
|
177
|
+
const provider = createOpenAICompatible(Object.assign(Object.assign({ name: (_a = readEnv("LLM_PROVIDER_NAME")) !== null && _a !== void 0 ? _a : "openai-compatible", baseURL }, (apiKey ? { apiKey } : {})), (headers ? { headers } : {})));
|
|
178
|
+
return provider(modelId);
|
|
179
|
+
});
|
|
133
180
|
}
|
|
134
|
-
function
|
|
181
|
+
function wrapMissingPeer(failure) {
|
|
182
|
+
const err = new Error(`Failed to load optional provider package "${failure.pkg}" for LLM_PROVIDER="${failure.provider}". ` +
|
|
183
|
+
`Install it with \`npm install ${failure.pkg}\`.`);
|
|
184
|
+
err.cause = failure.cause;
|
|
185
|
+
return err;
|
|
186
|
+
}
|
|
187
|
+
function importOptional(provider, pkg, loader) {
|
|
135
188
|
return __awaiter(this, void 0, void 0, function* () {
|
|
136
|
-
|
|
137
|
-
|
|
189
|
+
try {
|
|
190
|
+
return yield loader();
|
|
191
|
+
}
|
|
192
|
+
catch (cause) {
|
|
193
|
+
throw wrapMissingPeer({ provider, pkg, cause });
|
|
194
|
+
}
|
|
195
|
+
});
|
|
196
|
+
}
|
|
197
|
+
function createAnthropicModel(modelId) {
|
|
198
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
199
|
+
const mod = yield importOptional("anthropic", "@ai-sdk/anthropic", () => import('@ai-sdk/anthropic'));
|
|
200
|
+
const apiKey = readEnv("ANTHROPIC_API_KEY");
|
|
201
|
+
const provider = mod.createAnthropic(apiKey ? { apiKey } : undefined);
|
|
202
|
+
return provider(modelId);
|
|
203
|
+
});
|
|
204
|
+
}
|
|
205
|
+
function createGoogleModel(modelId) {
|
|
206
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
207
|
+
var _a;
|
|
208
|
+
const mod = yield importOptional("google", "@ai-sdk/google", () => import('@ai-sdk/google'));
|
|
209
|
+
const apiKey = (_a = readEnv("GOOGLE_GENERATIVE_AI_API_KEY")) !== null && _a !== void 0 ? _a : readEnv("GOOGLE_API_KEY");
|
|
210
|
+
const provider = mod.createGoogleGenerativeAI(apiKey ? { apiKey } : undefined);
|
|
211
|
+
return provider(modelId);
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
function createBedrockModel(modelId) {
|
|
215
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
216
|
+
const mod = yield importOptional("bedrock", "@ai-sdk/amazon-bedrock", () => import('@ai-sdk/amazon-bedrock'));
|
|
217
|
+
const provider = mod.createAmazonBedrock();
|
|
218
|
+
return provider(modelId);
|
|
219
|
+
});
|
|
220
|
+
}
|
|
221
|
+
function createMistralModel(modelId) {
|
|
222
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
223
|
+
const mod = yield importOptional("mistral", "@ai-sdk/mistral", () => import('@ai-sdk/mistral'));
|
|
224
|
+
const apiKey = readEnv("MISTRAL_API_KEY");
|
|
225
|
+
const provider = mod.createMistral(apiKey ? { apiKey } : undefined);
|
|
226
|
+
return provider(modelId);
|
|
227
|
+
});
|
|
228
|
+
}
|
|
229
|
+
function createCohereModel(modelId) {
|
|
230
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
231
|
+
const mod = yield importOptional("cohere", "@ai-sdk/cohere", () => import('@ai-sdk/cohere'));
|
|
232
|
+
const apiKey = readEnv("COHERE_API_KEY");
|
|
233
|
+
const provider = mod.createCohere(apiKey ? { apiKey } : undefined);
|
|
234
|
+
return provider(modelId);
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
function createGroqModel(modelId) {
|
|
238
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
239
|
+
const mod = yield importOptional("groq", "@ai-sdk/groq", () => import('@ai-sdk/groq'));
|
|
240
|
+
const apiKey = readEnv("GROQ_API_KEY");
|
|
241
|
+
const provider = mod.createGroq(apiKey ? { apiKey } : undefined);
|
|
242
|
+
return provider(modelId);
|
|
243
|
+
});
|
|
244
|
+
}
|
|
245
|
+
function createXaiModel(modelId) {
|
|
246
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
247
|
+
const mod = yield importOptional("xai", "@ai-sdk/xai", () => import('@ai-sdk/xai'));
|
|
248
|
+
const apiKey = readEnv("XAI_API_KEY");
|
|
249
|
+
const provider = mod.createXai(apiKey ? { apiKey } : undefined);
|
|
250
|
+
return provider(modelId);
|
|
251
|
+
});
|
|
252
|
+
}
|
|
253
|
+
function createDeepseekModel(modelId) {
|
|
254
|
+
return __awaiter(this, void 0, void 0, function* () {
|
|
255
|
+
const mod = yield importOptional("deepseek", "@ai-sdk/deepseek", () => import('@ai-sdk/deepseek'));
|
|
256
|
+
const apiKey = readEnv("DEEPSEEK_API_KEY");
|
|
257
|
+
const provider = mod.createDeepSeek(apiKey ? { apiKey } : undefined);
|
|
258
|
+
return provider(modelId);
|
|
259
|
+
});
|
|
260
|
+
}
|
|
261
|
+
function resolveLanguageModel() {
|
|
262
|
+
return __awaiter(this, arguments, void 0, function* (options = {}) {
|
|
263
|
+
var _a, _b, _c;
|
|
264
|
+
const provider = (_a = options.provider) !== null && _a !== void 0 ? _a : detectLlmProvider();
|
|
265
|
+
if (!provider) {
|
|
266
|
+
throw new Error("No LLM provider could be resolved. Set LLM_PROVIDER or a provider API key " +
|
|
267
|
+
"(OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, MISTRAL_API_KEY, " +
|
|
268
|
+
"COHERE_API_KEY, GROQ_API_KEY, XAI_API_KEY, DEEPSEEK_API_KEY), or LLM_BASE_URL for an OpenAI-compatible gateway.");
|
|
269
|
+
}
|
|
270
|
+
const modelId = (_c = (_b = options.model) !== null && _b !== void 0 ? _b : readEnv("LLM_MODEL")) !== null && _c !== void 0 ? _c : defaultModelForProvider(provider);
|
|
271
|
+
switch (provider) {
|
|
272
|
+
case "openai":
|
|
273
|
+
return createOpenAiModel(modelId);
|
|
274
|
+
case "openai-compatible":
|
|
275
|
+
return createOpenAiCompatibleModel(modelId);
|
|
276
|
+
case "anthropic":
|
|
277
|
+
return createAnthropicModel(modelId);
|
|
278
|
+
case "google":
|
|
279
|
+
return createGoogleModel(modelId);
|
|
280
|
+
case "bedrock":
|
|
281
|
+
return createBedrockModel(modelId);
|
|
282
|
+
case "mistral":
|
|
283
|
+
return createMistralModel(modelId);
|
|
284
|
+
case "cohere":
|
|
285
|
+
return createCohereModel(modelId);
|
|
286
|
+
case "groq":
|
|
287
|
+
return createGroqModel(modelId);
|
|
288
|
+
case "xai":
|
|
289
|
+
return createXaiModel(modelId);
|
|
290
|
+
case "deepseek":
|
|
291
|
+
return createDeepseekModel(modelId);
|
|
292
|
+
default: {
|
|
293
|
+
const _exhaustive = provider;
|
|
294
|
+
throw new Error(`Unhandled LLM provider: ${String(_exhaustive)}`);
|
|
295
|
+
}
|
|
296
|
+
}
|
|
138
297
|
});
|
|
139
298
|
}
|
|
140
|
-
|
|
141
|
-
const DEFAULT_LLM_MAX_DIFF_CHARS = 120000;
|
|
142
|
-
const DEFAULT_GIT_DIFF_SYSTEM_PROMPT = `You are a senior software engineer helping developers understand code and configuration changes from the git context they supplied.
|
|
143
|
-
You receive: commit subject lines (when available), changed file paths, and unified git patch(es)—either one range diff or concatenated per-commit patches, depending on how the diff was produced. Patches may be truncated mid-section with an explicit marker—do not infer changes beyond visible lines.
|
|
144
|
-
Explain what changed in terms of behavior, APIs, data, configuration, security, and operational risk. Tie claims to the patch when possible.
|
|
145
|
-
Produce a concise, developer-focused summary in Markdown.
|
|
146
|
-
Use sections that fit the change (for example: Highlights, Breaking or risky changes, API / contract changes, Data & schema, Configuration & infra, Security & auth, Tests & quality). Omit empty sections.
|
|
147
|
-
Group related changes; do not list every individual file. When multiple commits appear in the context, briefly separate notable themes by commit when helpful.
|
|
148
|
-
If the user message includes a Team line, use that exact team name in the summary title (for example: "## <Team> – Change summary" or similar).`;
|
|
149
|
-
const LLM_GATEWAY_REQUIRED_MESSAGE = "No LLM gateway configured. Set OPENAI_API_KEY or LLM_API_KEY, and/or LLM_BASE_URL or OPENAI_BASE_URL, " +
|
|
150
|
-
"and/or JSON in OPENAI_DEFAULT_HEADERS or LLM_DEFAULT_HEADERS. " +
|
|
151
|
-
"Alternatively pass openAiClientProvider to generateSummary or summarizeGitDiff.";
|
|
152
299
|
|
|
153
300
|
function resolveLlmMaxDiffChars(cliOverride) {
|
|
154
301
|
var _a;
|
|
@@ -176,18 +323,26 @@ function truncateUnifiedDiffForLlm(diffText, maxChars) {
|
|
|
176
323
|
function markdownDiffTruncationNotice(originalChars, maxChars) {
|
|
177
324
|
return `> **Truncated diff:** The unified diff was ${originalChars} characters; only the first ${maxChars} were sent to the model. The summary may not reflect the full change set. Narrow the ref range, adjust path filters, or raise \`maxDiffChars\` / \`LLM_MAX_DIFF_CHARS\`—often together with switching to a model whose context window can fit a larger prompt.\n\n`;
|
|
178
325
|
}
|
|
326
|
+
function resolveMaxOutputTokens() {
|
|
327
|
+
var _a;
|
|
328
|
+
const raw = (_a = process.env.LLM_MAX_TOKENS) !== null && _a !== void 0 ? _a : process.env.OPENAI_MAX_TOKENS;
|
|
329
|
+
const parsed = raw !== undefined ? Number.parseInt(raw, 10) : 4000;
|
|
330
|
+
return Number.isFinite(parsed) && parsed > 0 ? parsed : 4000;
|
|
331
|
+
}
|
|
179
332
|
function generateSummary(input) {
|
|
180
333
|
return __awaiter(this, void 0, void 0, function* () {
|
|
181
|
-
var _a
|
|
182
|
-
const { diffText, fileNames, commits, flags,
|
|
183
|
-
if (!
|
|
334
|
+
var _a;
|
|
335
|
+
const { diffText, fileNames, commits, flags, llmModelProvider, diffSummary, } = input;
|
|
336
|
+
if (!llmModelProvider && !isLlmProviderConfigured()) {
|
|
184
337
|
throw new Error(LLM_GATEWAY_REQUIRED_MESSAGE);
|
|
185
338
|
}
|
|
186
339
|
const maxDiffChars = resolveLlmMaxDiffChars(flags.maxDiffChars);
|
|
187
340
|
const diffTruncated = diffText.length > maxDiffChars;
|
|
188
341
|
const diffForLlm = truncateUnifiedDiffForLlm(diffText, maxDiffChars);
|
|
189
|
-
const userContent =
|
|
190
|
-
const
|
|
342
|
+
const userContent = buildUserContent(flags, commits, fileNames, diffForLlm, diffSummary);
|
|
343
|
+
const systemPrompt = (_a = flags.systemPrompt) !== null && _a !== void 0 ? _a : DEFAULT_GIT_DIFF_SYSTEM_PROMPT;
|
|
344
|
+
const maxOutputTokens = resolveMaxOutputTokens();
|
|
345
|
+
const summary = yield callLlm(userContent, systemPrompt, maxOutputTokens, llmModelProvider, flags);
|
|
191
346
|
if (!diffTruncated) {
|
|
192
347
|
return summary;
|
|
193
348
|
}
|
|
@@ -214,7 +369,7 @@ function formatRegexFilterLines(flags) {
|
|
|
214
369
|
return (`${incLine}${excLine}` +
|
|
215
370
|
"Git context shape: concatenated per-commit unified patches for commits that pass the message filters.\n");
|
|
216
371
|
}
|
|
217
|
-
function
|
|
372
|
+
function buildUserContent(flags, commits, fileNames, diffText, diffSummary) {
|
|
218
373
|
var _a, _b;
|
|
219
374
|
const from = flags.from;
|
|
220
375
|
const to = (_a = flags.to) !== null && _a !== void 0 ? _a : "HEAD";
|
|
@@ -244,31 +399,21 @@ function buildOpenAiUserContent(flags, commits, fileNames, diffText, diffSummary
|
|
|
244
399
|
"=== Git context (unified diff(s); patches may be truncated with an explicit marker) ===\n" +
|
|
245
400
|
diffText);
|
|
246
401
|
}
|
|
247
|
-
function
|
|
402
|
+
function callLlm(userContent, systemPrompt, maxOutputTokens, llmModelProvider, flags) {
|
|
248
403
|
return __awaiter(this, void 0, void 0, function* () {
|
|
249
|
-
var _a, _b
|
|
250
|
-
const
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
const
|
|
254
|
-
const response = yield client.chat.completions.create({
|
|
404
|
+
var _a, _b;
|
|
405
|
+
const model = llmModelProvider
|
|
406
|
+
? yield llmModelProvider()
|
|
407
|
+
: yield resolveLanguageModel(Object.assign(Object.assign({}, (flags.provider ? { provider: flags.provider } : {})), (flags.model ? { model: flags.model } : {})));
|
|
408
|
+
const result = yield ai.generateText({
|
|
255
409
|
model,
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
role: "system",
|
|
259
|
-
content: systemPrompt,
|
|
260
|
-
},
|
|
261
|
-
{
|
|
262
|
-
role: "user",
|
|
263
|
-
content: userContent,
|
|
264
|
-
},
|
|
265
|
-
],
|
|
410
|
+
system: systemPrompt,
|
|
411
|
+
prompt: userContent,
|
|
266
412
|
temperature: 0.2,
|
|
267
|
-
|
|
413
|
+
maxOutputTokens,
|
|
268
414
|
});
|
|
269
|
-
const
|
|
270
|
-
|
|
271
|
-
return text.length > 0 ? text : "No summary generated by OpenAI.";
|
|
415
|
+
const text = (_b = (_a = result.text) === null || _a === void 0 ? void 0 : _a.trim()) !== null && _b !== void 0 ? _b : "";
|
|
416
|
+
return text.length > 0 ? text : "No summary generated by the model.";
|
|
272
417
|
});
|
|
273
418
|
}
|
|
274
419
|
|
|
@@ -712,6 +857,7 @@ function summarizeGitDiff(options) {
|
|
|
712
857
|
to,
|
|
713
858
|
team: options.teamName,
|
|
714
859
|
model: options.model,
|
|
860
|
+
provider: options.provider,
|
|
715
861
|
maxDiffChars: options.maxDiffChars,
|
|
716
862
|
systemPrompt: options.systemPrompt,
|
|
717
863
|
commitMessageIncludeRegexes: options.commitMessageIncludeRegexes,
|
|
@@ -722,7 +868,7 @@ function summarizeGitDiff(options) {
|
|
|
722
868
|
fileNames,
|
|
723
869
|
commits: filteredCommits,
|
|
724
870
|
flags: summarizeFlags,
|
|
725
|
-
|
|
871
|
+
llmModelProvider: options.llmModelProvider,
|
|
726
872
|
diffSummary,
|
|
727
873
|
});
|
|
728
874
|
});
|
|
@@ -732,7 +878,8 @@ exports.DEFAULT_GIT_DIFF_SYSTEM_PROMPT = DEFAULT_GIT_DIFF_SYSTEM_PROMPT;
|
|
|
732
878
|
exports.LLM_GATEWAY_REQUIRED_MESSAGE = LLM_GATEWAY_REQUIRED_MESSAGE;
|
|
733
879
|
exports.buildDiffPathspecs = buildDiffPathspecs;
|
|
734
880
|
exports.createGitClient = createGitClient;
|
|
735
|
-
exports.
|
|
881
|
+
exports.defaultModelForProvider = defaultModelForProvider;
|
|
882
|
+
exports.detectLlmProvider = detectLlmProvider;
|
|
736
883
|
exports.filterCommitsByMessageRegexes = filterCommitsByMessageRegexes;
|
|
737
884
|
exports.generateSummary = generateSummary;
|
|
738
885
|
exports.getChangedFiles = getChangedFiles;
|
|
@@ -740,12 +887,11 @@ exports.getCommits = getCommits;
|
|
|
740
887
|
exports.getDiff = getDiff;
|
|
741
888
|
exports.getDiffSummary = getDiffSummary;
|
|
742
889
|
exports.getRepoRoot = getRepoRoot;
|
|
890
|
+
exports.isLlmProviderConfigured = isLlmProviderConfigured;
|
|
743
891
|
exports.parseLlmDefaultHeadersFromEnv = parseLlmDefaultHeadersFromEnv;
|
|
892
|
+
exports.resolveLanguageModel = resolveLanguageModel;
|
|
744
893
|
exports.resolveLlmBaseUrl = resolveLlmBaseUrl;
|
|
745
894
|
exports.resolveLlmMaxDiffChars = resolveLlmMaxDiffChars;
|
|
746
|
-
exports.resolveOpenAiLikeClientInit = resolveOpenAiLikeClientInit;
|
|
747
|
-
exports.shouldUseLlmGateway = shouldUseLlmGateway;
|
|
748
|
-
exports.splitPromotableAuthorizationFromHeaders = splitPromotableAuthorizationFromHeaders;
|
|
749
895
|
exports.summarizeGitDiff = summarizeGitDiff;
|
|
750
896
|
exports.truncateUnifiedDiffForLlm = truncateUnifiedDiffForLlm;
|
|
751
897
|
//# sourceMappingURL=index.cjs.map
|