refactor(llm-deepseek)!: rename the provider route to deepseek-official

The native adapter's route was named deepseek, colliding with pi-ai's
catalog provider of the same name, so the two DeepSeek paths could never
be mounted side by side. The web settings page needs both configurable at
once. Compositions, fixtures, goldens, scaffolding defaults, and docs all
move together (pre-release, no shim); TUI/session-query-spill/
missing-credential goldens re-recorded through their keyless refresh
modes because provider-name length shifts box padding and spill
truncation points.

packages/sdk/create-sdk/src/args.ts

@@ -11,7 +11,7 @@ import type { PackageManagerName, RunInterface } from '@deepseek-ai/dsh-helper'
 export interface CreateArgs {
   directory?: string
   description?: string
-  provider?: 'deepseek' | 'custom'
+  provider?: 'deepseek-official' | 'custom'
   baseURL?: string
   apiKey?: string
   model?: string
@@ -27,7 +27,7 @@ export interface CreateArgs {
 
 interface CommanderCreateOptions {
   description?: string
-  provider?: 'deepseek' | 'custom'
+  provider?: 'deepseek-official' | 'custom'
   baseUrl?: string
   apiKey?: string
   model?: string
@@ -57,7 +57,7 @@ function createProgram(): Command {
     .argument('[directory]')
     .option('-h, --help')
     .option('--description <text>')
-    .addOption(new Option('--provider <name>').choices(['deepseek', 'custom']))
+    .addOption(new Option('--provider <name>').choices(['deepseek-official', 'custom']))
     .option('--base-url <url>')
     .option('--api-key <key>')
     .option('--model <name>')

packages/sdk/create-sdk/src/create-questions.ts

@@ -24,7 +24,7 @@ export interface ProjectAnswers {
   directory: string
   name: string
   description: string
-  provider: 'deepseek' | 'custom'
+  provider: 'deepseek-official' | 'custom'
   baseURL: string
   apiKey: string
   model: string
@@ -142,14 +142,14 @@ const PROJECT_QUESTION_STEPS: readonly WizardStep<ProjectAnswerState>[] = [
     apply: (state, value) => { state.description = value },
   }),
   questionStep({
-    question: () => new SelectQuestion<'deepseek' | 'custom'>({
+    question: () => new SelectQuestion<'deepseek-official' | 'custom'>({
       id: 'provider',
       message: 'Model provider',
       options: [
-        { value: 'deepseek', label: 'DeepSeek' },
+        { value: 'deepseek-official', label: 'DeepSeek' },
         { value: 'custom', label: 'Custom endpoint (pi-ai)' },
       ],
-      initialValue: 'deepseek',
+      initialValue: 'deepseek-official',
     }),
     prefilled: state => state.args.provider,
     apply: (state, value) => { state.provider = value },

packages/sdk/create-sdk/src/headless.ts

@@ -18,7 +18,7 @@ import type { CreateArgs } from './args.ts'
 interface HeadlessCreateSpec {
   directory?: string
   description?: string
-  provider?: 'deepseek' | 'custom'
+  provider?: 'deepseek-official' | 'custom'
   baseURL?: string
   apiKey?: string
   model?: string

packages/sdk/create-sdk/src/templates/assets/usage.txt.tpl

@@ -2,7 +2,7 @@ Usage: create-sdk [directory] [options]
 
 Options:
   --description <text>
-  --provider <deepseek|custom>
+  --provider <deepseek-official|custom>
   --base-url <url>
   --api-key <key>
   --model <name>

packages/sdk/create-sdk/tests/create.snapshot.ts

@@ -87,7 +87,7 @@ describe.skipIf(process.platform === 'win32')('create-sdk terminal contract', ()
       'my-agent',
       'my-agent',
       'Snapshot agent',
-      'deepseek',
+      'deepseek-official',
       'secret-key',
       'acp',
       [
@@ -166,7 +166,7 @@ describe.skipIf(process.platform === 'win32')('create-sdk terminal contract', ()
             "message": "Project description",
           },
           {
-            "initialValue": "deepseek",
+            "initialValue": "deepseek-official",
             "kind": "select",
             "message": "Model provider",
             "options": [
@@ -330,7 +330,7 @@ describe.skipIf(process.platform === 'win32')('create-sdk terminal contract', ()
             {
               "id": "provider",
               "options": [
-                "deepseek",
+                "deepseek-official",
               ],
             },
             {

packages/sdk/create-sdk/tests/create.spec.ts

@@ -131,13 +131,13 @@ afterEach(async () => {
 describe('create arguments', () => {
   it('parses public options and the private repository link mode', () => {
     expect(parseCreateArgs([
-      'agent', '--description=demo', '--provider', 'deepseek', '--base-url=https://api.example',
+      'agent', '--description=demo', '--provider', 'deepseek-official', '--base-url=https://api.example',
       '--api-key', 'key', '--model=m', '--interface', 'acp', '--pm=pnpm', '--no-install',
       '--link-workspace',
     ])).toEqual({
       directory: 'agent',
       description: 'demo',
-      provider: 'deepseek',
+      provider: 'deepseek-official',
       baseURL: 'https://api.example',
       apiKey: 'key',
       model: 'm',
@@ -205,7 +205,7 @@ describe('CreateWizard and scaffolder', () => {
     const args = parseCreateArgs([
       'my-agent',
       '--description=demo',
-      '--provider=deepseek',
+      '--provider=deepseek-official',
       '--api-key=deepseek-key',
       '--model=deepseek-v4-flash',
       '--interface=tui',
@@ -246,7 +246,7 @@ describe('CreateWizard and scaffolder', () => {
     ]
     const resolved = await new CreateWizard({
       args: parseCreateArgs([
-        'my-agent', '--description=demo', '--provider=deepseek', '--api-key=deepseek-key',
+        'my-agent', '--description=demo', '--provider=deepseek-official', '--api-key=deepseek-key',
         '--model=deepseek-v4-flash', '--interface=tui', '--pm=npm', '--no-install',
       ]),
       port: new HeadlessPromptPort(),
@@ -274,7 +274,7 @@ describe('CreateWizard and scaffolder', () => {
     ] as unknown as FeatureSelection[]
     await expect(new CreateWizard({
       args: parseCreateArgs([
-        'my-agent', '--description=demo', '--provider=deepseek', '--api-key=k',
+        'my-agent', '--description=demo', '--provider=deepseek-official', '--api-key=k',
         '--model=m', '--interface=tui', '--pm=npm', '--no-install',
       ]),
       port: new HeadlessPromptPort(),
@@ -295,7 +295,7 @@ describe('CreateWizard and scaffolder', () => {
       packageManager: new NpmPackageManager('10.0.0'),
       releaseVersion: '0.0.1',
       features: [
-        { id: featureId('provider'), options: ['deepseek'], secrets: { apiKey: 'key' } },
+        { id: featureId('provider'), options: ['deepseek-official'], secrets: { apiKey: 'key' } },
         { id: featureId('bash'), options: ['local'] },
         { id: featureId('app'), options: ['embed'] },
         { id: featureId('persistence'), options: ['jsonl'] },
@@ -346,7 +346,7 @@ describe('CreateWizard and scaffolder', () => {
     ])
     const resolved = await new CreateWizard({
       args: parseCreateArgs([
-        'workflow-agent', '--description=test', '--provider=deepseek', '--api-key=key',
+        'workflow-agent', '--description=test', '--provider=deepseek-official', '--api-key=key',
         '--interface=embed', '--pm=npm', '--no-install',
       ]),
       port,
@@ -371,7 +371,7 @@ describe('CreateWizard and scaffolder', () => {
     ])
     const resolved = await new CreateWizard({
       args: parseCreateArgs([
-        'empty-key-agent', '--description=test', '--provider=deepseek',
+        'empty-key-agent', '--description=test', '--provider=deepseek-official',
         '--interface=embed', '--pm=npm', '--no-install',
       ]),
       port,
@@ -398,7 +398,7 @@ describe('CreateWizard and scaffolder', () => {
       'embed',
       [
         { value: featureId('persistence'), choices: ['jsonl'] },
-        { value: featureId('web'), choices: ['deepseek'] },
+        { value: featureId('web'), choices: ['deepseek-official'] },
       ],
       true,
       'none',
@@ -426,14 +426,14 @@ describe('CreateWizard and scaffolder', () => {
       'agent',
       [
         { value: featureId('persistence'), choices: ['jsonl'] },
-        { value: featureId('web'), choices: ['deepseek'] },
+        { value: featureId('web'), choices: ['deepseek-official'] },
         { value: featureId('timeout-policy'), choices: ['default'] },
       ],
       'none',
     ])
     const resolved = await new CreateWizard({
       args: parseCreateArgs([
-        'agent', '--description=test', '--provider=deepseek', '--api-key=key',
+        'agent', '--description=test', '--provider=deepseek-official', '--api-key=key',
         '--interface=embed', '--pm=npm', '--no-install',
       ]),
       port,
@@ -451,7 +451,7 @@ describe('CreateWizard and scaffolder', () => {
     ])
     const resolved = await new CreateWizard({
       args: parseCreateArgs([
-        name, '--description=test', '--provider=deepseek', '--api-key=key',
+        name, '--description=test', '--provider=deepseek-official', '--api-key=key',
         '--interface=embed', '--pm=npm', '--no-install',
       ]),
       port,
@@ -467,7 +467,7 @@ describe('CreateWizard and scaffolder', () => {
 
 describe('create command composition', () => {
   const argv = (directory: string, install: boolean): string[] => [
-    directory, '--description=test', '--provider=deepseek', '--api-key=key',
+    directory, '--description=test', '--provider=deepseek-official', '--api-key=key',
     '--interface=embed', '--pm=npm', install ? '--install' : '--no-install',
   ]
 
@@ -490,7 +490,7 @@ describe('create command composition', () => {
     const root = await mkdtemp(join(tmpdir(), 'create-headless-cmd-'))
     temporary.push(root)
     const spec = JSON.stringify({
-      directory: 'agent', description: 'test', provider: 'deepseek', apiKey: 'key',
+      directory: 'agent', description: 'test', provider: 'deepseek-official', apiKey: 'key',
       model: 'deepseek-v4-flash', interface: 'embed', pm: 'npm', install: false,
       features: [{ id: 'persistence', options: ['jsonl'] }],
     })
@@ -510,7 +510,7 @@ describe('create command composition', () => {
     const ok = commandContext(root)
     ok.stdin.isTTY = false
     ok.stdout.isTTY = false
-    const okSpec = JSON.stringify({ ...base, directory: 'done-agent', provider: 'deepseek', apiKey: 'key', features: [] })
+    const okSpec = JSON.stringify({ ...base, directory: 'done-agent', provider: 'deepseek-official', apiKey: 'key', features: [] })
     await expect(runCreateCommand(['--config-json', okSpec, '--json'], ok)).resolves.toBe(0)
     expect(ok.readStdout()).toContain('{"type":"done"}')
     // stdout stays pure NDJSON: every line parses, human progress goes to stderr
@@ -573,7 +573,7 @@ describe('create command composition', () => {
     expect(install).toHaveBeenCalledOnce()
     expect(build).toHaveBeenCalledOnce()
     const spec = JSON.stringify({
-      directory: 'json-agent', description: 'test', provider: 'deepseek', apiKey: 'key',
+      directory: 'json-agent', description: 'test', provider: 'deepseek-official', apiKey: 'key',
       model: 'deepseek-v4-flash', interface: 'embed', pm: 'npm', install: true, features: [],
     })
     const json = commandContext(root)

packages/sdk/create-sdk/tests/link-workspace.e2e.ts

@@ -64,7 +64,7 @@ describe.skipIf(!existsSync(builtScripts))('live-linked generated projects', ()
         releaseVersion: '0.0.1',
         linkWorkspaceRoot: repoRoot,
         features: [
-          { id: featureId('provider'), options: ['deepseek'], secrets: { apiKey: 'test-key' } },
+          { id: featureId('provider'), options: ['deepseek-official'], secrets: { apiKey: 'test-key' } },
           { id: featureId('bash'), options: ['local'] },
           { id: featureId('app'), options: ['embed'] },
           { id: featureId('persistence'), options: ['jsonl'] },