DeepSeek Native Provider

This is the current implementation guide. The original SDK-wrapper listing is available in git history at c829f4de; do not reinstall removed packages to follow it. For a new integration, start at Provider Onboarding Tiers.

Runtime and configuration

src/lib/providers/deepseek.ts extends OpenAIChatCompletionsProvider. It uses direct HTTP JSON requests for ordinary generate() and SSE for stream(); message conversion, multi-step tool execution, and stream lifecycle handling live in the shared native base.

Setting	Value
Provider ID	deepseek
Credentials key	deepseek
Default base URL	https://api.deepseek.com
Endpoint override	DEEPSEEK_BASE_URL
API key override	DEEPSEEK_API_KEY
Model	Explicit model or the provider's environment/default resolution

Provider-specific behavior

• generate({ schema }) uses json_object when DeepSeek rejects the stronger json_schema format. The base ensures the prompt contains the JSON instruction required by that mode.
• Native reasoning_content is surfaced in streamed reasoning chunks. Model support for tool use and thinking differs; do not infer support from the provider name alone.
• API-key/balance/model errors are classified by the provider. Model alternatives come from getFallbackModels().
• Vision is not a supported DeepSeek surface here. Explicit image tests should report unsupported capability rather than claim success from text alone.

SDK: exercise both modes

Use an available model ID for your account or loaded local model. The example below calls the two public surfaces independently; it does not pass a Vercel model adapter into NeuroLink.

import { NeuroLink } from "@juspay/neurolink";

const sdk = new NeuroLink();
const options = {
  provider: "deepseek",
  model: "deepseek-chat",
  input: { text: "Reply with HELLO." },
  disableTools: true,
  maxTokens: 256,
};

try {
  const generated = await sdk.generate(options);
  console.log(generated.content);

  const streamed = await sdk.stream(options);
  for await (const chunk of streamed.stream) {
    if ("content" in chunk) process.stdout.write(chunk.content);
  }
} finally {
  await sdk.shutdown();
}

Per-call credentials.deepseek accepts apiKey and baseURL; it overrides instance/environment defaults. For local providers, omit the example's model to test discovery instead of specifying a fallback label.

Tools and schemas

Register tools with sdk.registerTool() or pass the package's tool() helper. Use the top-level schema option for structured generate() output; a prose answer alone is not proof that the schema or a tool was honored. Tests should assert an executed tool result and validate structuredData, not merely check that content is nonempty. Check stream tool execution independently.

Verification and limitations

pnpm run build
pnpm run test:new-providers
pnpm exec tsx test/continuous-test-suite-provider-matrix.ts --provider=deepseek

Live checks require credentials or the relevant local server. Use deterministic HTTP stand-ins to verify wire bodies, retries, and cancellation even when live access is unavailable. Record blocked/skipped live cells explicitly.

• Native architecture
• New-provider test coverage