Unify utility model settings and align git generation (#486)

* refactor(api): extend git generation payload types

* refactor(settings): add git provider model fields

* feat(config): persist git provider model defaults

* feat(git-api): send provider and model ids

* fix(git-api): forward generation options in runtime

* feat(git-view): use configured model for commit generation

* feat(git-view): pass configured model for PR generation

* feat(vscode): forward model selection in git bridge payload

* feat(vscode): align PR generation with session model flow

* feat(web): resolve and generate git text with provider model

* refactor(settings): unify utility model picker across providers

* chore(settings): rename sidebar item to utility model

* fix(git-model): validate and auto-heal stale utility selections

---------

Co-authored-by: Bohdan Triapitsyn <artmore@protonmail.com>
This commit is contained in:
Nelson Pires
2026-02-24 10:23:57 +02:00
committed by GitHub
co-authored by Bohdan Triapitsyn
parent 8647e0c1a4
commit 7a11867a19
11 changed files with 978 additions and 335 deletions
+269 -38
View File
@@ -304,28 +304,253 @@ const normalizeMergeMethod = (value: string): 'merge' | 'squash' | 'rebase' => {
return 'merge';
};
const extractZenOutputText = (value: unknown): string | null => {
if (!value || typeof value !== 'object') return null;
const root = value as Record<string, unknown>;
const output = root.output;
if (!Array.isArray(output)) return null;
const BRIDGE_ZEN_DEFAULT_MODEL = 'gpt-5-nano';
const BRIDGE_GIT_GENERATION_TIMEOUT_MS = 2 * 60 * 1000;
const BRIDGE_GIT_GENERATION_POLL_INTERVAL_MS = 500;
let bridgeGitModelCatalogCache: Set<string> | null = null;
let bridgeGitModelCatalogCacheAt = 0;
const BRIDGE_GIT_MODEL_CATALOG_CACHE_TTL_MS = 30 * 1000;
const messageItem = output.find((item) => {
if (!item || typeof item !== 'object') return false;
return (item as Record<string, unknown>).type === 'message';
}) as Record<string, unknown> | undefined;
if (!messageItem) return null;
const sleep = (ms: number) => new Promise<void>((resolve) => {
setTimeout(resolve, ms);
});
const content = messageItem.content;
if (!Array.isArray(content)) return null;
const fetchBridgeGitModelCatalog = async (
apiUrl: string,
authHeaders?: Record<string, string>
): Promise<Set<string>> => {
const now = Date.now();
if (bridgeGitModelCatalogCache && now - bridgeGitModelCatalogCacheAt < BRIDGE_GIT_MODEL_CATALOG_CACHE_TTL_MS) {
return bridgeGitModelCatalogCache;
}
const textItem = content.find((item) => {
if (!item || typeof item !== 'object') return false;
return (item as Record<string, unknown>).type === 'output_text';
}) as Record<string, unknown> | undefined;
const headers = authHeaders || {};
const modelsUrl = new URL(`${apiUrl.replace(/\/+$/, '')}/model`);
const response = await fetch(modelsUrl.toString(), {
method: 'GET',
headers: {
Accept: 'application/json',
...headers,
},
signal: AbortSignal.timeout(8_000),
});
const text = typeof textItem?.text === 'string' ? textItem.text.trim() : '';
return text || null;
if (!response.ok) {
throw new Error('Failed to fetch model catalog');
}
const payload = await response.json().catch(() => null) as unknown;
const refs = new Set<string>();
if (Array.isArray(payload)) {
for (const item of payload) {
if (!item || typeof item !== 'object') {
continue;
}
const record = item as Record<string, unknown>;
const providerID = typeof record.providerID === 'string' ? record.providerID.trim() : '';
const modelID = typeof record.modelID === 'string' ? record.modelID.trim() : '';
if (providerID && modelID) {
refs.add(`${providerID}/${modelID}`);
}
}
}
bridgeGitModelCatalogCache = refs;
bridgeGitModelCatalogCacheAt = now;
return refs;
};
const resolveBridgeGitGenerationModel = async (
payloadModel: { providerId?: string; modelId?: string; zenModel?: string },
settings: Record<string, unknown>,
apiUrl: string,
authHeaders?: Record<string, string>
): Promise<{ providerID: string; modelID: string }> => {
let catalog: Set<string> | null = null;
try {
catalog = await fetchBridgeGitModelCatalog(apiUrl, authHeaders);
} catch {
catalog = null;
}
const hasModel = (providerID: string, modelID: string): boolean => {
if (!catalog) {
return false;
}
return catalog.has(`${providerID}/${modelID}`);
};
const requestProviderId = typeof payloadModel.providerId === 'string' ? payloadModel.providerId.trim() : '';
const requestModelId = typeof payloadModel.modelId === 'string' ? payloadModel.modelId.trim() : '';
if (requestProviderId && requestModelId && hasModel(requestProviderId, requestModelId)) {
return { providerID: requestProviderId, modelID: requestModelId };
}
const settingsProviderId = readStringField(settings, 'gitProviderId');
const settingsModelId = readStringField(settings, 'gitModelId');
if (settingsProviderId && settingsModelId && hasModel(settingsProviderId, settingsModelId)) {
return { providerID: settingsProviderId, modelID: settingsModelId };
}
const payloadZenModel = typeof payloadModel.zenModel === 'string' ? payloadModel.zenModel.trim() : '';
const settingsZenModel = readStringField(settings, 'zenModel');
return {
providerID: 'zen',
modelID: payloadZenModel || settingsZenModel || BRIDGE_ZEN_DEFAULT_MODEL,
};
};
const extractTextFromMessageParts = (parts: unknown): string => {
if (!Array.isArray(parts)) {
return '';
}
const textParts = parts
.filter((part) => {
if (!part || typeof part !== 'object') return false;
const record = part as Record<string, unknown>;
return record.type === 'text' && typeof record.text === 'string';
})
.map((part) => (part as Record<string, unknown>).text as string)
.map((text) => text.trim())
.filter((text) => text.length > 0);
return textParts.join('\n').trim();
};
const generateBridgeTextWithSessionFlow = async ({
apiUrl,
directory,
prompt,
providerID,
modelID,
authHeaders,
}: {
apiUrl: string;
directory: string;
prompt: string;
providerID: string;
modelID: string;
authHeaders?: Record<string, string>;
}): Promise<string> => {
const headers = authHeaders || {};
const apiBase = apiUrl.replace(/\/+$/, '');
const deadlineAt = Date.now() + BRIDGE_GIT_GENERATION_TIMEOUT_MS;
const remainingMs = () => Math.max(1_000, deadlineAt - Date.now());
let sessionId: string | null = null;
try {
const sessionUrl = new URL(`${apiBase}/session`);
if (directory) {
sessionUrl.searchParams.set('directory', directory);
}
const createResponse = await fetch(sessionUrl.toString(), {
method: 'POST',
headers: {
'Content-Type': 'application/json',
...headers,
},
body: JSON.stringify({ title: 'Git Generation' }),
signal: AbortSignal.timeout(remainingMs()),
});
if (!createResponse.ok) {
throw new Error('Failed to create OpenCode session');
}
const session = await createResponse.json().catch(() => null) as unknown;
const sessionObj = session && typeof session === 'object' ? session as Record<string, unknown> : null;
const createdSessionId = sessionObj && typeof sessionObj.id === 'string' ? sessionObj.id : '';
if (!createdSessionId) {
throw new Error('Invalid session response');
}
sessionId = createdSessionId;
const promptUrl = new URL(`${apiBase}/session/${encodeURIComponent(sessionId)}/prompt_async`);
if (directory) {
promptUrl.searchParams.set('directory', directory);
}
const promptResponse = await fetch(promptUrl.toString(), {
method: 'POST',
headers: {
'Content-Type': 'application/json',
...headers,
},
body: JSON.stringify({
model: {
providerID,
modelID,
},
parts: [{ type: 'text', text: prompt }],
}),
signal: AbortSignal.timeout(remainingMs()),
});
if (!promptResponse.ok) {
throw new Error('Failed to send prompt');
}
const messagesUrl = new URL(`${apiBase}/session/${encodeURIComponent(sessionId)}/message`);
if (directory) {
messagesUrl.searchParams.set('directory', directory);
}
messagesUrl.searchParams.set('limit', '10');
while (Date.now() < deadlineAt) {
await sleep(BRIDGE_GIT_GENERATION_POLL_INTERVAL_MS);
const messagesResponse = await fetch(messagesUrl.toString(), {
method: 'GET',
headers: {
Accept: 'application/json',
...headers,
},
signal: AbortSignal.timeout(remainingMs()),
});
if (!messagesResponse.ok) {
continue;
}
const messages = await messagesResponse.json().catch(() => null) as unknown;
if (!Array.isArray(messages)) {
continue;
}
for (let i = messages.length - 1; i >= 0; i--) {
const message = messages[i] as Record<string, unknown> | null;
if (!message || typeof message !== 'object') {
continue;
}
const info = message.info as Record<string, unknown> | undefined;
if (info?.role !== 'assistant' || info?.finish !== 'stop') {
continue;
}
const text = extractTextFromMessageParts(message.parts);
if (text) {
return text;
}
}
}
throw new Error('Timeout waiting for generation to complete');
} finally {
if (sessionId) {
const deleteUrl = new URL(`${apiBase}/session/${encodeURIComponent(sessionId)}`);
try {
await fetch(deleteUrl.toString(), {
method: 'DELETE',
headers,
signal: AbortSignal.timeout(5_000),
});
} catch {
// ignore cleanup failures
}
}
}
};
const parseJsonObjectSafe = (value: string): Record<string, unknown> | null => {
@@ -2920,10 +3145,14 @@ export async function handleBridgeMessage(message: BridgeRequest, ctx?: BridgeCo
}
case 'api:git/pr-description': {
const { directory, base, head } = (payload || {}) as {
const { directory, base, head, context, providerId, modelId, zenModel: payloadZenModel } = (payload || {}) as {
directory?: string;
base?: string;
head?: string;
context?: string;
providerId?: string;
modelId?: string;
zenModel?: string;
};
if (!directory) {
return { id, type, success: false, error: 'Directory is required' };
@@ -2961,31 +3190,33 @@ export async function handleBridgeMessage(message: BridgeRequest, ctx?: BridgeCo
return { id, type, success: false, error: 'No diffs available for selected files' };
}
const prompt = `You are drafting a GitHub Pull Request title + description. Respond in JSON of the shape {"title": string, "body": string} (ONLY JSON in response, no markdown fences) with these rules:\n- title: concise, sentence case, <= 80 chars, no trailing punctuation, no commit-style prefixes (no "feat:", "fix:")\n- body: GitHub-flavored markdown with these sections in this order: Summary, Testing, Notes\n- Summary: 3-6 bullet points describing user-visible changes; avoid internal helper function names\n- Testing: bullet list ("- Not tested" allowed)\n- Notes: bullet list; include breaking/rollout notes only when relevant\n\nContext:\n- base branch: ${base}\n- head branch: ${head}\n\nDiff summary:\n${diffSummaries}`;
const prompt = `You are drafting a GitHub Pull Request title + description. Respond in JSON of the shape {"title": string, "body": string} (ONLY JSON in response, no markdown fences) with these rules:\n- title: concise, sentence case, <= 80 chars, no trailing punctuation, no commit-style prefixes (no "feat:", "fix:")\n- body: GitHub-flavored markdown with these sections in this order: Summary, Testing, Notes\n- Summary: 3-6 bullet points describing user-visible changes; avoid internal helper function names\n- Testing: bullet list ("- Not tested" allowed)\n- Notes: bullet list; include breaking/rollout notes only when relevant\n\nContext:\n- base branch: ${base}\n- head branch: ${head}${context?.trim() ? `\n- Additional context: ${context.trim()}` : ''}\n\nDiff summary:\n${diffSummaries}`;
try {
const zenSettings = readSettings(ctx) as Record<string, unknown>;
const zenModelRaw = typeof zenSettings?.zenModel === 'string' ? (zenSettings.zenModel as string).trim() : '';
const zenModel = zenModelRaw.length > 0 ? zenModelRaw : 'gpt-5-nano';
const response = await fetch('https://opencode.ai/zen/v1/responses', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
model: zenModel,
input: [{ role: 'user', content: prompt }],
max_output_tokens: 1200,
stream: false,
reasoning: { effort: 'low' },
}),
});
if (!response.ok) {
return { id, type, success: false, error: 'Failed to generate PR description' };
const apiUrl = ctx?.manager?.getApiUrl();
if (!apiUrl) {
return { id, type, success: false, error: 'OpenCode API unavailable' };
}
const data = await response.json().catch(() => null) as unknown;
const raw = extractZenOutputText(data);
const settings = readSettings(ctx) as Record<string, unknown>;
const { providerID, modelID } = await resolveBridgeGitGenerationModel(
{ providerId, modelId, zenModel: payloadZenModel },
settings,
apiUrl,
ctx?.manager?.getOpenCodeAuthHeaders()
);
const raw = await generateBridgeTextWithSessionFlow({
apiUrl,
directory,
prompt,
providerID,
modelID,
authHeaders: ctx?.manager?.getOpenCodeAuthHeaders(),
});
if (!raw) {
return { id, type, success: false, error: 'No PR description returned by generator' };
}
const cleaned = String(raw)
.trim()
.replace(/^```json\s*/i, '')
+11 -2
View File
@@ -90,10 +90,15 @@ export const createVSCodeGitAPI = (): GitAPI => ({
});
},
generateCommitMessage: async (directory: string, files: string[]): Promise<{ message: GeneratedCommitMessage }> => {
generateCommitMessage: async (
directory: string,
files: string[],
options?: { zenModel?: string; providerId?: string; modelId?: string }
): Promise<{ message: GeneratedCommitMessage }> => {
// This requires AI integration - stubbed for now
void directory; // Unused for now
void files; // Unused for now
void options; // Unused for now
return {
message: {
subject: '',
@@ -104,12 +109,16 @@ export const createVSCodeGitAPI = (): GitAPI => ({
generatePullRequestDescription: async (
directory: string,
payload: { base: string; head: string }
payload: { base: string; head: string; context?: string; zenModel?: string; providerId?: string; modelId?: string }
): Promise<GeneratedPullRequestDescription> => {
return sendBridgeMessage<GeneratedPullRequestDescription>('api:git/pr-description', {
directory,
base: payload.base,
head: payload.head,
context: payload.context,
zenModel: payload.zenModel,
providerId: payload.providerId,
modelId: payload.modelId,
});
},