.github/workflows/check-changeset.yml

@@ -28,6 +28,9 @@ jobs:
     name: Check changeset vs changed files
     runs-on: ubuntu-latest
 
+    permissions:
+      pull-requests: write
+
     steps:
     - name: Checkout Repo
       uses: actions/checkout@v4
@@ -89,4 +92,4 @@ jobs:
     # Don't want it to throw before editing the comment.
     - name: Fail if checker script logged a blocking failure
       if: ${{steps.check-changeset.outputs.BLOCKING_FAILURE == 'true'}}
-      run: exit 1
+      run: exit 1

.github/workflows/check-docs.yml

@@ -22,26 +22,34 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout Repo
-      uses: actions/checkout@v4
-      with:
-        # get all history for the diff
-        fetch-depth: 0
-    - name: Set up Node (20)
-      uses: actions/setup-node@v4
-      with:
-        node-version: 22.10.0
-    - name: Yarn install
-      run: yarn
-    - name: Run doc generation
-      run: yarn docgen:all
-    - name: Check for changes in docs-devsite dir (fail if so)
-      run: |
-        if [[ -n "$(git status docs-devsite --porcelain)" ]]; then
-          echo "Unstaged changes detected:"
-          git status -s
-          exit 1
-        fi
-    - name: Reference documentation needs to be updated. See message below.
-      if: ${{ failure() }}
-      run: echo "Changes in this PR affect the reference docs. Run \`yarn docgen:all\` locally to regenerate docs and add them to this PR."
+      - name: Checkout Repo
+        uses: actions/checkout@v4
+        with:
+          # get all history for the diff
+          fetch-depth: 0
+      - name: Set up Node (20)
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.10.0
+      - name: Yarn install
+        run: yarn
+      - name: Run doc generation
+        run: yarn docgen:all
+        # Fail first if there are docs-devsite changes since running yarn docgen:all
+        # will also regenerate any API report changes.
+      - name: Check for changes in docs-devsite dir (fail if so)
+        run: |
+          if [[ -n "$(git status docs-devsite --porcelain)" ]]; then
+            echo "Unstaged changes detected in docs-devsite/:"
+            git status -s
+            echo "Changes in this PR affect the reference docs or API reports. Run \`yarn docgen:all\` locally to regenerate the changed files and add them to this PR."
+            exit 1
+          fi
+      - name: Check for changes in common/api-review dir (fail if so)
+        run: |
+          if [[ -n "$(git status common/api-review --porcelain)" ]]; then
+            echo "Unstaged changes detected in api-report(s):"
+            git status -s
+            echo "Changes in this PR affect the API reports. Run \`yarn build\` locally to regenerate the API reports and add them to this PR."
+            exit 1
+          fi

.github/workflows/release-pr.yml

@@ -24,6 +24,9 @@ jobs:
   release:
     name: Create Release PR
     runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: write
     if: ${{ !startsWith(github.event.head_commit.message, 'Version Packages (#') }}
     steps:
       - name: Checkout Repo

common/api-review/database.api.md

@@ -228,6 +228,10 @@ export function startAt(value?: number | string | boolean | null, key?: string):
 
 // @public
 export interface ThenableReference extends DatabaseReference, Pick<Promise<DatabaseReference>, 'then' | 'catch'> {
+    // (undocumented)
+    key: string;
+    // (undocumented)
+    parent: DatabaseReference;
 }
 
 // @public

common/api-review/vertexai.api.md

@@ -28,9 +28,9 @@ export interface BaseParams {
 
 // @public
 export enum BlockReason {
-    // (undocumented)
+    BLOCKLIST = "BLOCKLIST",
     OTHER = "OTHER",
-    // (undocumented)
+    PROHIBITED_CONTENT = "PROHIBITED_CONTENT",
     SAFETY = "SAFETY"
 }
 
@@ -88,6 +88,9 @@ export interface Content {
 export interface CountTokensRequest {
     // (undocumented)
     contents: Content[];
+    generationConfig?: GenerationConfig;
+    systemInstruction?: string | Part | Content;
+    tools?: Tool[];
 }
 
 // @public
@@ -158,15 +161,14 @@ export interface FileDataPart {
 
 // @public
 export enum FinishReason {
-    // (undocumented)
+    BLOCKLIST = "BLOCKLIST",
+    MALFORMED_FUNCTION_CALL = "MALFORMED_FUNCTION_CALL",
     MAX_TOKENS = "MAX_TOKENS",
-    // (undocumented)
     OTHER = "OTHER",
-    // (undocumented)
+    PROHIBITED_CONTENT = "PROHIBITED_CONTENT",
     RECITATION = "RECITATION",
-    // (undocumented)
     SAFETY = "SAFETY",
-    // (undocumented)
+    SPII = "SPII",
     STOP = "STOP"
 }
 
@@ -188,11 +190,8 @@ export interface FunctionCallingConfig {
 
 // @public (undocumented)
 export enum FunctionCallingMode {
-    // (undocumented)
     ANY = "ANY",
-    // (undocumented)
     AUTO = "AUTO",
-    // (undocumented)
     NONE = "NONE"
 }
 
@@ -377,21 +376,15 @@ export interface GroundingMetadata {
 
 // @public (undocumented)
 export enum HarmBlockMethod {
-    // (undocumented)
     PROBABILITY = "PROBABILITY",
-    // (undocumented)
     SEVERITY = "SEVERITY"
 }
 
 // @public
 export enum HarmBlockThreshold {
-    // (undocumented)
     BLOCK_LOW_AND_ABOVE = "BLOCK_LOW_AND_ABOVE",
-    // (undocumented)
     BLOCK_MEDIUM_AND_ABOVE = "BLOCK_MEDIUM_AND_ABOVE",
-    // (undocumented)
     BLOCK_NONE = "BLOCK_NONE",
-    // (undocumented)
     BLOCK_ONLY_HIGH = "BLOCK_ONLY_HIGH"
 }
 
@@ -409,25 +402,17 @@ export enum HarmCategory {
 
 // @public
 export enum HarmProbability {
-    // (undocumented)
     HIGH = "HIGH",
-    // (undocumented)
     LOW = "LOW",
-    // (undocumented)
     MEDIUM = "MEDIUM",
-    // (undocumented)
     NEGLIGIBLE = "NEGLIGIBLE"
 }
 
 // @public
 export enum HarmSeverity {
-    // (undocumented)
     HARM_SEVERITY_HIGH = "HARM_SEVERITY_HIGH",
-    // (undocumented)
     HARM_SEVERITY_LOW = "HARM_SEVERITY_LOW",
-    // (undocumented)
     HARM_SEVERITY_MEDIUM = "HARM_SEVERITY_MEDIUM",
-    // (undocumented)
     HARM_SEVERITY_NEGLIGIBLE = "HARM_SEVERITY_NEGLIGIBLE"
 }
 

docs-devsite/database.thenablereference.md

@@ -19,3 +19,25 @@ export declare interface ThenableReference extends DatabaseReference, Pick<Promi
 ```
 <b>Extends:</b> [DatabaseReference](./database.databasereference.md#databasereference_interface)<!-- -->, Pick&lt;Promise&lt;[DatabaseReference](./database.databasereference.md#databasereference_interface)<!-- -->&gt;, 'then' \| 'catch'&gt;
 
+## Properties
+
+|  Property | Type | Description |
+|  --- | --- | --- |
+|  [key](./database.thenablereference.md#thenablereferencekey) | string |  |
+|  [parent](./database.thenablereference.md#thenablereferenceparent) | [DatabaseReference](./database.databasereference.md#databasereference_interface) |  |
+
+## ThenableReference.key
+
+<b>Signature:</b>
+
+```typescript
+key: string;
+```
+
+## ThenableReference.parent
+
+<b>Signature:</b>
+
+```typescript
+parent: DatabaseReference;
+```

docs-devsite/vertexai.counttokensrequest.md

@@ -23,6 +23,9 @@ export interface CountTokensRequest
 |  Property | Type | Description |
 |  --- | --- | --- |
 |  [contents](./vertexai.counttokensrequest.md#counttokensrequestcontents) | [Content](./vertexai.content.md#content_interface)<!-- -->\[\] |  |
+|  [generationConfig](./vertexai.counttokensrequest.md#counttokensrequestgenerationconfig) | [GenerationConfig](./vertexai.generationconfig.md#generationconfig_interface) | Configuration options that control how the model generates a response. |
+|  [systemInstruction](./vertexai.counttokensrequest.md#counttokensrequestsysteminstruction) | string \| [Part](./vertexai.md#part) \| [Content](./vertexai.content.md#content_interface) | Instructions that direct the model to behave a certain way. |
+|  [tools](./vertexai.counttokensrequest.md#counttokensrequesttools) | [Tool](./vertexai.md#tool)<!-- -->\[\] | <code>[Tool](./vertexai.md#tool)</code> configuration. |
 
 ## CountTokensRequest.contents
 
@@ -31,3 +34,33 @@ export interface CountTokensRequest
 ```typescript
 contents: Content[];
 ```
+
+## CountTokensRequest.generationConfig
+
+Configuration options that control how the model generates a response.
+
+<b>Signature:</b>
+
+```typescript
+generationConfig?: GenerationConfig;
+```
+
+## CountTokensRequest.systemInstruction
+
+Instructions that direct the model to behave a certain way.
+
+<b>Signature:</b>
+
+```typescript
+systemInstruction?: string | Part | Content;
+```
+
+## CountTokensRequest.tools
+
+<code>[Tool](./vertexai.md#tool)</code> configuration.
+
+<b>Signature:</b>
+
+```typescript
+tools?: Tool[];
+```