feat: alias AgentV1SettingsAgentListenProvider to *AgentContextListenProvider

  The 2026-05-06 regen renamed this type to AgentV1SettingsAgentContextListenProvider
  (the new V2 adds an optional language_hint field). Replace the regenerated
  duplicate with a one-line alias to the new canonical name plus namespace merge
  for .V1/.V2, so pinned-name callers (`const p: AgentV1SettingsAgentListenProvider
  = ...`) keep compiling without a cast. Purely additive at the type level — the
  old V2 is a subset of the new V2.

  - src/api/resources/.../AgentV1SettingsAgentListenProvider.ts: alias body
  - .fernignore + AGENTS.md: track the alias as a temporarily-frozen entry
  - tests/unit/compat-aliases.test.ts: Equals<X, Y> identity assertions for the
    alias (top-level + .V1 + .V2), plus compile-time call-site assertions for the
    pre-existing keys.create(request?) optionality patc

Author: GregHolmes

.fernignore

@@ -86,3 +86,13 @@ src/api/types/CreateKeyV1Request.ts
 # Regression coverage in tests/unit/compat-aliases.test.ts.
 # Swap to .bak before regen.
 src/api/resources/agent/resources/v1/types/AgentV1Settings.ts
+
+# src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.ts:
+# the 2026-05-06 regen renamed this type to AgentV1SettingsAgentContextListenProvider
+# (the new V2 adds an optional language_hint field). We replace the regenerated
+# duplicate with a one-line type alias to the new canonical name so pinned-name
+# callers (`const p: AgentV1SettingsAgentListenProvider = ...`) keep compiling
+# without a cast. Purely additive at the type level — the old V2 is a subset of
+# the new V2. Regression coverage in tests/unit/compat-aliases.test.ts.
+# Swap to .bak before regen.
+src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.ts

AGENTS.md

@@ -63,6 +63,7 @@ Current temporarily frozen files:
 - `src/api/resources/manage/resources/v1/resources/projects/resources/keys/client/Client.ts` — keep `manage.v1.projects.keys.create(projectId, request?)` source-compatible with older callers that omit the request body, while still allowing the regenerated request form.
 - `src/api/types/CreateKeyV1Request.ts` — preserve the old exported `CreateKeyV1RequestOne` alias alongside `CreateKeyV1Request` so existing type imports keep compiling.
 - `src/api/resources/agent/resources/v1/types/AgentV1Settings.ts` — backward-compat patch for the `AgentV1Settings.Agent` namespace. The 2026-05-06 regen restructured `Agent` from an interface with named sub-types into a union with anonymous shapes plus a string variant (`{...} | string`) for the new agent-by-ID-string flow. We restore the original interface form so existing imports of the sub-types (`Agent.Context`, `Agent.Listen`, `Agent.Think`, `Agent.Speak`, `Agent.Context.Messages.Item`) AND direct field reads (`settings.agent.context`, `.greeting`, etc.) keep compiling in TS strict mode without a `typeof` narrowing guard. The new agent-by-ID-string variant is surfaced as the opt-in `AgentReference = Agent | string` alias for callers who want to pass a string ID at the type level. Mirrors the Python SDK's compat shims for the same regen. Regression coverage in `tests/unit/compat-aliases.test.ts`.
+- `src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.ts` — backward-compat alias for the type renamed by the 2026-05-06 regen to `AgentV1SettingsAgentContextListenProvider`. The new V2 only adds an optional `language_hint` field, so the regenerated duplicate is replaced with a one-line `type AgentV1SettingsAgentListenProvider = AgentV1SettingsAgentContextListenProvider` (plus namespace merge for `.V1`/`.V2` access). Purely additive at the type level — pinned-name callers (`const p: AgentV1SettingsAgentListenProvider = ...`) keep compiling without a cast. Regression coverage in `tests/unit/compat-aliases.test.ts`.
 
 **Note:** If you need to patch a Fern-generated file, add it to `.fernignore` with a comment describing the patch, and add it to the "temporarily frozen" list above.
 

src/api/resources/agent/resources/v1/types/AgentV1SettingsAgentListenProvider.ts

@@ -1,33 +1,16 @@
-// This file was auto-generated by Fern from our API Definition.
+// Backward-compat alias for the type renamed by the 2026-05-06 regen to
+// `AgentV1SettingsAgentContextListenProvider`. The new V2 only adds an optional
+// `language_hint` field, so this alias is purely additive: every literal that
+// satisfied the old V2 still satisfies the new V2, and pinned-name callers
+// (`const p: AgentV1SettingsAgentListenProvider = ...`) keep compiling without
+// a cast. See AGENTS.md for the patch rationale; regression coverage in
+// tests/unit/compat-aliases.test.ts.
 
 import type * as Deepgram from "../../../../../index.js";
 
-export type AgentV1SettingsAgentListenProvider =
-    | Deepgram.agent.AgentV1SettingsAgentListenProvider.V1
-    | Deepgram.agent.AgentV1SettingsAgentListenProvider.V2;
+export type AgentV1SettingsAgentListenProvider = Deepgram.agent.AgentV1SettingsAgentContextListenProvider;
 
 export namespace AgentV1SettingsAgentListenProvider {
-    export interface V1 {
-        version: "v1";
-        /** Provider type for speech-to-text */
-        type: "deepgram";
-        /** Model to use for speech to text using the V1 API (e.g. Nova-3, Nova-2) */
-        model?: string | undefined;
-        /** Language code to use for speech-to-text. Can be a BCP-47 language tag (e.g. `en`), or `multi` for code-switching transcription */
-        language?: string | undefined;
-        /** Prompt keyterm recognition to improve Keyword Recall Rate */
-        keyterms?: string[] | undefined;
-        /** Applies smart formatting to improve transcript readability */
-        smart_format?: boolean | undefined;
-    }
-
-    export interface V2 {
-        version: "v2";
-        /** Provider type for speech-to-text */
-        type: "deepgram";
-        /** Model to use for speech to text using the V2 API (e.g. flux-general-en) */
-        model: string;
-        /** Prompt keyterm recognition to improve Keyword Recall Rate */
-        keyterms?: string[] | undefined;
-    }
+    export type V1 = Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V1;
+    export type V2 = Deepgram.agent.AgentV1SettingsAgentContextListenProvider.V2;
 }

tests/unit/compat-aliases.test.ts

@@ -5,9 +5,16 @@ import type {
     AgentV1SettingsAgentListenProvider,
     CreateKeyV1Request,
     CreateKeyV1RequestOne,
+    DeepgramClient,
 } from "../../src";
 import { Deepgram } from "../../src";
 
+// Type-only handle for compile-time call-site assertions. Never assigned at
+// runtime — the `declare` binding lets us write expressions like
+// `client.manage.v1.projects.keys.create("project_id")` purely for type
+// checking. Any closure that references it must not be invoked.
+declare const client: DeepgramClient;
+
 /**
  * Regression test for backward-compatibility aliases preserved across SDK
  * regenerations.
@@ -130,31 +137,69 @@ describe("Backwards-compatibility aliases", () => {
         });
     });
 
-    describe("AgentV1SettingsAgentListenProvider (renamed to *AgentContextListenProvider 2026-05-06)", () => {
+    describe("manage.v1.projects.keys.create (request? optionality patch)", () => {
+        it("accepts a project_id without a request body at the type level", () => {
+            // Type-only: if a future regen drops the `request?` optionality
+            // patch on KeysClient#create, this call site fails to compile and
+            // the test run fails before any test body executes. The arrow
+            // function is constructed but never invoked, so the unbound
+            // `client` reference is safe at runtime.
+            const _noArgIsCallable = (): unknown => client.manage.v1.projects.keys.create("project_id");
+            expect(typeof _noArgIsCallable).toBe("function");
+        });
+
+        it("still accepts a request body as the second argument", () => {
+            const _withBodyIsCallable = (): unknown =>
+                client.manage.v1.projects.keys.create("project_id", {
+                    comment: "compat check",
+                    scopes: ["usage:read"],
+                });
+            expect(typeof _withBodyIsCallable).toBe("function");
+        });
+    });
+
+    describe("AgentV1SettingsAgentListenProvider (aliased to *AgentContextListenProvider 2026-05-06)", () => {
         it("old name still exists at the top-level export", () => {
             // Sanity: the old type is still in the public surface even though
             // generated code now uses the new context-prefixed name.
             const _old: AgentV1SettingsAgentListenProvider = { version: "v1", type: "deepgram", model: "nova-3" };
             expect(_old.type).toBe("deepgram");
         });
 
-        it("old and new provider types are bidirectionally assignable (V2 added optional language_hint only)", () => {
-            // V1 of both unions is structurally identical; V2 of the new
-            // context-listen-provider only adds an optional `language_hint`
-            // field, so structural typing makes the two unions assignable in
-            // both directions for shared shapes.
-            const fromOld: AgentV1SettingsAgentContextListenProvider = {
-                version: "v1",
-                type: "deepgram",
-                model: "nova-3",
-            } as AgentV1SettingsAgentListenProvider;
-            const fromNew: AgentV1SettingsAgentListenProvider = {
+        it("old name is a type-identical alias for the new context-prefixed name", () => {
+            // The patched AgentV1SettingsAgentListenProvider.ts collapses the
+            // regenerated duplicate into a one-line alias, so the two names
+            // resolve to the exact same type. If a future regen blows away
+            // the alias, this Equals<X, Y> identity check fails to compile.
+            const _equality: Equals<
+                AgentV1SettingsAgentListenProvider,
+                AgentV1SettingsAgentContextListenProvider
+            > = true;
+            expect(_equality).toBe(true);
+        });
+
+        it("nested .V1 and .V2 namespaces resolve through the alias", () => {
+            const _v1Equality: Equals<
+                AgentV1SettingsAgentListenProvider.V1,
+                AgentV1SettingsAgentContextListenProvider.V1
+            > = true;
+            const _v2Equality: Equals<
+                AgentV1SettingsAgentListenProvider.V2,
+                AgentV1SettingsAgentContextListenProvider.V2
+            > = true;
+            expect(_v1Equality).toBe(true);
+            expect(_v2Equality).toBe(true);
+        });
+
+        it("legacy V2 literal (no language_hint) still compiles under the alias", () => {
+            // Pre-regen V2 had no `language_hint`. Because the new V2 adds it
+            // as optional, old literals continue to type-check unchanged.
+            const _legacy: AgentV1SettingsAgentListenProvider.V2 = {
                 version: "v2",
                 type: "deepgram",
                 model: "flux-general-en",
-            } as AgentV1SettingsAgentContextListenProvider;
-            expect(fromOld.version).toBe("v1");
-            expect(fromNew.version).toBe("v2");
+            };
+            expect(_legacy.version).toBe("v2");
         });
     });
 });