a

2026-05-10 21:50:14 -07:00 · 2024-07-15 02:10:16 -07:00
parent c06250ecb1
commit e7773f6227
1 changed files with 129 additions and 0 deletions
@@ -0,0 +1,129 @@
+// chatGenerate/parsers/gemini.parser.ts
+
+import { GeminiWire_API_Generate_Content, GeminiWire_Safety } from '../../wiretypes/gemini.wiretypes';
+import { ChatGenerateMessageAction } from '../chatGenerate.types';
+import { ISSUE_SYMBOL, ISSUE_SYMBOL_PROMPT_BLOCKED, ISSUE_SYMBOL_RECITATION, TEXT_SYMBOL_MAX_TOKENS } from '../chatGenerate.config';
+
+// Utility function for sorting harm probabilities
+export function geminiHarmProbabilitySortFunction(a: { probability: string }, b: { probability: string }) {
+  const order = ['NEGLIGIBLE', 'LOW', 'MEDIUM', 'HIGH'];
+  return order.indexOf(b.probability) - order.indexOf(a.probability);
+}
+
+function explainGeminiSafetyIssues(safetyRatings?: GeminiWire_Safety.SafetyRating[]): string {
+  if (!safetyRatings || !safetyRatings.length)
+    return 'no safety ratings provided';
+  safetyRatings = (safetyRatings || []).sort(geminiHarmProbabilitySortFunction);
+  // only for non-neglegible probabilities
+  return safetyRatings
+    .filter(rating => rating.probability !== 'NEGLIGIBLE')
+    .map(rating => `${rating.category/*.replace('HARM_CATEGORY_', '')*/} (${rating.probability?.toLowerCase()})`)
+    .join(', ');
+}
+
+export function createGeminiGenerateContentParser(modelId: string): (eventData: string) => Generator<ChatGenerateMessageAction> {
+  const modelName = modelId.replace('models/', '');
+  let hasBegun = false;
+
+  // this can throw, it's caught by the caller
+  return function* (eventData): Generator<ChatGenerateMessageAction> {
+
+    // -> Model
+    if (!hasBegun) {
+      hasBegun = true;
+      yield { op: 'set', value: { model: modelName } };
+    }
+
+    // Throws on malformed event data
+    const generationChunk = GeminiWire_API_Generate_Content.Response_schema.parse(JSON.parse(eventData));
+
+    // remove wireGenerationChunk.candidates[number].safetyRatings
+    (generationChunk as GeminiWire_API_Generate_Content.Response).candidates?.forEach(candidate => {
+      delete candidate.safetyRatings;
+      // delete candidate.citationMetadata;
+    });
+    console.log('\n' + JSON.stringify(generationChunk.candidates, null, 2));
+
+    // -> Prompt Safety Blocking
+    if (generationChunk.promptFeedback?.blockReason) {
+      const { blockReason, safetyRatings } = generationChunk.promptFeedback;
+      yield { op: 'issue', issue: `Input not allowed: ${blockReason}: ${explainGeminiSafetyIssues(safetyRatings)}`, symbol: ISSUE_SYMBOL_PROMPT_BLOCKED };
+      return yield { op: 'parser-close' };
+    }
+
+    // expect: single completion
+    if (generationChunk.candidates?.length !== 1)
+      throw new Error(`expected 1 completion, got ${generationChunk.candidates?.length}`);
+    const candidate0 = generationChunk.candidates[0];
+    if (candidate0.index !== 0)
+      throw new Error(`expected completion index 0, got ${candidate0.index}`);
+
+    // handle missing content
+    if (!candidate0.content) {
+      switch (candidate0.finishReason) {
+
+        case 'MAX_TOKENS':
+          yield { op: 'text', text: ` ${TEXT_SYMBOL_MAX_TOKENS}` /* Interrupted: MAX_TOKENS reached */ };
+          return yield { op: 'parser-close' };
+
+        case 'RECITATION':
+          yield { op: 'issue', issue: `Generation stopped due to RECITATION`, symbol: ISSUE_SYMBOL_RECITATION };
+          return yield { op: 'parser-close' };
+
+        case 'SAFETY':
+          yield { op: 'issue', issue: `Generation stopped due to SAFETY: ${explainGeminiSafetyIssues(candidate0.safetyRatings)}`, symbol: ISSUE_SYMBOL };
+          return yield { op: 'parser-close' };
+
+        default:
+          throw new Error(`server response missing content (finishReason: ${candidate0?.finishReason})`);
+
+      }
+    }
+
+    // expect a single part
+    if (candidate0.content.parts?.length !== 1)
+      throw new Error(`expected 1 content part, got ${candidate0.content.parts?.length}`);
+
+    for (const mPart of candidate0.content.parts) {
+      switch (true) {
+
+        // <- TextPart
+        case 'text' in mPart:
+          yield { op: 'text', text: mPart.text || '' };
+          break;
+
+        // <- FunctionCallPart
+        case 'functionCall' in mPart:
+          yield { op: 'text', text: `TODO: [Function Call] ${mPart.functionCall.name} ${JSON.stringify(mPart.functionCall.args)}` };
+          break;
+
+        // <- ExecutableCodePart
+        case 'executableCode' in mPart:
+          yield { op: 'text', text: `TODO: [Executable Code] ${mPart.executableCode}` };
+          break;
+
+        // <- CodeExecutionResultPart
+        case 'codeExecutionResult' in mPart:
+          yield { op: 'text', text: `TODO: [Code Execution Result] ${mPart.codeExecutionResult}` };
+          break;
+
+        default:
+          throw new Error(`unexpected content part: ${JSON.stringify(mPart)}`);
+      }
+    }
+
+    // -> Stats
+    // if (generationChunk.usageMetadata) {
+    //   // TODO: we should only return this on the last packet, once we have the full stats
+    //   yield {
+    //     op: 'set', value: {
+    //       stats: {
+    //         chatInTokens: generationChunk.usageMetadata.promptTokenCount ?? -1,
+    //         chatOutTokens: generationChunk.usageMetadata.candidatesTokenCount ?? -1,
+    //       },
+    //     },
+    //   };
+    // }
+
+  };
+}