refactor: apply repository naming contract

Apply the accepted pre-release package, service, type, directory, and role renames as one repository-wide change.

packages/web/web/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/web/web/README.md
-README.md: 237c7e28416a1f920042d2713a2b2e67dc882c42
-README.zh.md: 18cfa59d60520587467df673b2869109bbfe0890
+README.md: 8dfc7f032e25e40207bb3880777b814e67175a20
+README.zh.md: 3354037bfcd77ca2b1a07da710b565065baf543b

packages/web/web/README.md

@@ -2,16 +2,16 @@
 
 English | [中文](README.zh.md)
 
-The **`WebService`** (`ctx.web`) defines WHAT web access the harness has — search the web, fetch a URL — over multiple providers, without binding the model contract to one vendor's API shape.
+The **`WebRuntime`** (`ctx.web`) defines WHAT web access the harness has — search the web, fetch a URL — over multiple providers, without binding the model contract to one vendor's API shape.
 
-This package owns the Service Definition role of the web capability. Unlike bash/fs it spans two operations (search and fetch) on one seam, with potentially multiple providers each:
+This package owns the Service Definition role of the web capability. Unlike shell/fs it spans two operations (search and fetch) on one seam, with potentially multiple providers each:
 
 | Package | Role |
 |---|---|
 | `@deepseek-ai/dsh-web` (this) | Service Definition: the service, provider registries, selection policy, request/result vocabulary, the `WebError` taxonomy |
 | `@deepseek-ai/dsh-web-search-exa` | Search provider: Exa |
 | `@deepseek-ai/dsh-web-search-perplexity` | Search provider: Perplexity |
-| `@deepseek-ai/dsh-web-fetch-local` | Fetch provider: anonymous public HTTP(S) |
+| `@deepseek-ai/dsh-web-fetch-http` | Fetch provider: anonymous public HTTP(S) |
 | `@deepseek-ai/dsh-tool-web` | Consumer: the model-facing `web_search` / `web_fetch` tool schemas over `ctx.web` |
 
 Search and fetch share no request schema and no business logic, but they are deliberately one seam: `ctx.web` is a single web-access middle layer with one provider-selection policy owner, one abort/error vocabulary, and one product-facing "how this harness reaches the web" config surface. The `Search`/`Fetch` method pairs are deliberately parallel.

packages/web/web/README.zh.md

@@ -2,16 +2,16 @@
 
 [English](README.md) | 中文
 
-**`WebService`**（`ctx.web`）定义 harness 具备哪些 web 访问能力（搜索 web、抓取 URL），并通过多个提供方实现，不把模型约定绑定到某个厂商的 API 形状。
+**`WebRuntime`**（`ctx.web`）定义 harness 具备哪些 web 访问能力（搜索 web、抓取 URL），并通过多个提供方实现，不把模型约定绑定到某个厂商的 API 形状。
 
-本包承担 web 能力的 Service Definition 角色。与 bash/fs 不同，它在一个 seam 上跨越搜索与抓取两种操作，每种操作都可能有多个提供方：
+本包承担 web 能力的 Service Definition 角色。与 shell/fs 不同，它在一个 seam 上跨越搜索与抓取两种操作，每种操作都可能有多个提供方：
 
 | 包 | 职责 |
 |---|---|
 | `@deepseek-ai/dsh-web`（本包） | Service Definition：服务、提供方注册表、选择策略、请求／结果词汇、`WebError` 分类体系 |
 | `@deepseek-ai/dsh-web-search-exa` | 搜索提供方：Exa |
 | `@deepseek-ai/dsh-web-search-perplexity` | 搜索提供方：Perplexity |
-| `@deepseek-ai/dsh-web-fetch-local` | 抓取提供方：匿名公共 HTTP(S) |
+| `@deepseek-ai/dsh-web-fetch-http` | 抓取提供方：匿名公共 HTTP(S) |
 | `@deepseek-ai/dsh-tool-web` | Consumer：面向模型的 `web_search`／`web_fetch` 工具 schema，构建于 `ctx.web` 之上 |
 
 搜索与抓取没有共享请求 schema 或业务逻辑，但有意共用一个 seam：`ctx.web` 是单一 web 访问中间层，拥有一项提供方选择策略、一套中止／错误词汇和一个面向产品的「该 harness 如何访问 web」配置接口。成对的 `Search`／`Fetch` 方法保持并行是有意为之。

packages/web/web/src/index.ts

@@ -34,7 +34,7 @@ export type {
 
 declare module '@deepseek-ai/cordis' {
   interface Context {
-    web: WebService
+    web: WebRuntime
   }
 }
 
@@ -52,7 +52,7 @@ interface Selection<P> {
  * provider auto-selects). Operational overrides such as environment variables
  * must feed these same fields rather than introduce a hidden priority chain.
  */
-export interface WebServiceConfig {
+export interface WebRuntimeConfig {
   /** Explicit search provider id. Omitted = auto-select when exactly one usable. */
   readonly searchProvider?: string
   /** Explicit fetch provider id. Omitted = auto-select when exactly one usable. */
@@ -71,13 +71,13 @@ export interface WebServiceConfig {
  * - No id configured, multiple usable providers → `WEB_PROVIDER_AMBIGUOUS`.
  * - No id configured, no usable provider → `WEB_PROVIDER_UNAVAILABLE`.
  */
-export class WebService extends Service {
+export class WebRuntime extends Service {
   /**
    * Provider selection config. Operational env overrides feed the SAME fields:
    * `$DSH_WEB_SEARCH_PROVIDER` / `$DSH_WEB_FETCH_PROVIDER` are equivalent to
    * `searchProvider` / `fetchProvider` and are NOT a hidden priority chain.
    */
-  static Config: z<WebServiceConfig> = z.object({
+  static Config: z<WebRuntimeConfig> = z.object({
     searchProvider: z.string(),
     fetchProvider: z.string(),
   })
@@ -87,7 +87,7 @@ export class WebService extends Service {
   private readonly searchProviderId: string | undefined
   private readonly fetchProviderId: string | undefined
 
-  constructor(ctx: Context, config: WebServiceConfig = {}) {
+  constructor(ctx: Context, config: WebRuntimeConfig = {}) {
     super(ctx, 'web')
     this.searchProviderId = config.searchProvider ?? process.env.DSH_WEB_SEARCH_PROVIDER
     this.fetchProviderId = config.fetchProvider ?? process.env.DSH_WEB_FETCH_PROVIDER
@@ -199,4 +199,4 @@ function capSources(result: WebSearchResult, maxResults: number | undefined): We
   return { ...result, sources: result.sources.slice(0, maxResults), truncated: true }
 }
 
-export default WebService
+export default WebRuntime

packages/web/web/tests/web.spec.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest'
 import { Context } from '@deepseek-ai/cordis'
-import WebService, {
+import WebRuntime, {
   WebError,
   type WebFetchProvider,
   type WebFetchResult,
@@ -33,14 +33,14 @@ function fetchResult(marker: string): WebFetchResult {
   return { url: 'https://example.com', statusCode: 200, body: { kind: 'text', content: marker }, truncated: false }
 }
 
-/** Mount a WebService on a fresh root context with the given config. */
-async function mountWeb(config: ConstructorParameters<typeof WebService>[1] = {}): Promise<{ ctx: Context; web: WebService }> {
+/** Mount a WebRuntime on a fresh root context with the given config. */
+async function mountWeb(config: ConstructorParameters<typeof WebRuntime>[1] = {}): Promise<{ ctx: Context; web: WebRuntime }> {
   const ctx = new Context()
-  await ctx.plugin(WebService, config)
+  await ctx.plugin(WebRuntime, config)
   return { ctx, web: ctx.web }
 }
 
-describe('WebService registration', () => {
+describe('WebRuntime registration', () => {
   it('registers a search provider and unregisters it via the returned disposer', async () => {
     const { web } = await mountWeb()
 
@@ -75,7 +75,7 @@ describe('WebService registration', () => {
   })
 })
 
-describe('WebService execution resolution', () => {
+describe('WebRuntime execution resolution', () => {
   it('throws WEB_PROVIDER_UNAVAILABLE when nothing is registered', async () => {
     const { web } = await mountWeb()
     await expect(web.search({ query: 'q' })).rejects.toThrow(expect.objectContaining({ code: 'WEB_PROVIDER_UNAVAILABLE' }))
@@ -156,7 +156,7 @@ describe('WebService execution resolution', () => {
   })
 })
 
-describe('WebService maxResults enforcement', () => {
+describe('WebRuntime maxResults enforcement', () => {
   it('truncates sources and sets truncated when a provider over-returns', async () => {
     const { web } = await mountWeb()
     web.registerSearchProvider(makeSearchProvider('exa', available, () => Promise.resolve(searchResult('exa', {
@@ -188,12 +188,12 @@ describe('WebService maxResults enforcement', () => {
   })
 })
 
-describe('WebService fetch capability', () => {
+describe('WebRuntime fetch capability', () => {
   it('resolves and runs the fetch provider independently of search', async () => {
     const { web } = await mountWeb()
-    web.registerFetchProvider(makeFetchProvider('local-http', available, fetchResult('local-http')))
+    web.registerFetchProvider(makeFetchProvider('http', available, fetchResult('http')))
     const result = await web.fetch({ url: 'https://example.com' })
-    expect(result.body.content).toBe('local-http')
+    expect(result.body.content).toBe('http')
     expect(result.statusCode).toBe(200)
   })
 

packages/web/web/tsconfig.json

@@ -21,7 +21,7 @@
       "path": "../../llm/llm"
     },
     {
-      "path": "../../support/invariants"
+      "path": "../../runtime-diagnostics/invariants"
     }
   ]
 }