Merge remote-tracking branch 'origin/master' into dshw/pr-2250

# Conflicts: # packages/client/connection/tests/fake-api.client.ts # packages/client/runtime/tests/manager.client.spec.ts # packages/client/runtime/tests/workspaces-service.client.spec.ts # packages/host/apiproxy/tests/rpc-schemas.spec.ts
2026-08-12 04:50:51 +08:00
parent f7e45ae377 82d21ab3c3
commit 3a0baa1e9d
@@ -1,44 +0,0 @@
-/**
- * commands domain zod schemas (names derived from map keys: commandListRequestSchema /
- * commandListValueSchema / commandExecuteRequestSchema / commandExecuteValueSchema).
- */
-
-import { z } from 'zod'
-import type { CommandId } from '@deepseek-ai/dsh-commands/brand'
-import type { RequestPayload, ResponseValue } from './rpc-map.ts'
-import type { Wire } from './rpc.schema.ts'
-import { sessionIdSchema } from './sessions.schema.ts'
-import type { CommandDescriptor } from './commands.ts'
-
-/** CommandDescriptor row of command.list. */
-export const commandDescriptorSchema = z.object({
-  name: z.string().min(1),
-  description: z.string(),
-  input: z.object({ hint: z.string() }).optional(),
-}) satisfies z.ZodType<Wire<CommandDescriptor>>
-
-/** command.list request payload. */
-export const commandListRequestSchema = z.object({
-  sessionId: sessionIdSchema,
-}) satisfies z.ZodType<Wire<RequestPayload<'command.list'>>>
-
-/** command.list response value. */
-export const commandListValueSchema = z.object({
-  commands: z.array(commandDescriptorSchema),
-}) satisfies z.ZodType<Wire<ResponseValue<'command.list'>>>
-
-/** command.execute request payload. */
-export const commandExecuteRequestSchema = z.object({
-  sessionId: sessionIdSchema,
-  line: z.string(),
-}) satisfies z.ZodType<Wire<RequestPayload<'command.execute'>>>
-
-/** CommandId: one brand cast after schema validation (the only cast point in this domain). */
-export const commandIdSchema = z.string().min(1) as unknown as z.ZodType<CommandId>
-
-/** command.execute response value: pure admission — outcomes ride the logged
- * lifecycle events; commandId (present exactly when matched) correlates with them. */
-export const commandExecuteValueSchema = z.object({
-  matched: z.boolean(),
-  commandId: commandIdSchema.optional(),
-}) satisfies z.ZodType<Wire<ResponseValue<'command.execute'>>>
@@ -1,50 +0,0 @@
-/**
- * commands domain contract: the web catalog/dispatch face of the host command
- * registry (`ctx.commands`). Both methods address an ordinary session's Agent
- * via `sessionId`, resuming it when cold. Session-backed subagents reject with
- * `agent-busy` and retain their dedicated continuation owner.
- */
-
-import type { CommandId } from '@deepseek-ai/dsh-commands/brand'
-import type { SessionId } from '@deepseek-ai/dsh-session/types'
-import type { RpcRequest, RpcResponse } from './rpc.ts'
-
-/**
- * Handler-free command view served to clients. Wire mirror of the host
- * registry descriptor (which stays host-side with its cordis dependencies);
- * no source field — the host descriptor has none.
- */
-export interface CommandDescriptor {
-  /** Lowercase command name without the leading slash. */
-  readonly name: string
-  /** Human-readable summary used in discovery UI. */
-  readonly description: string
-  /** Optional free-form input hint advertised to capable clients. */
-  readonly input?: { readonly hint: string }
-}
-
-/** Command-domain unary methods (the map keys command.* of RpcMethodMap). */
-export interface CommandsApi {
-  /**
-   * Lists the addressed agent's effective command catalog (name-sorted,
-   * globals plus its scoped shadows). Session-backed subagents reject with
-   * `agent-busy`.
-   */
-  list(request: RpcRequest<{ sessionId: SessionId }>): Promise<RpcResponse<{ commands: readonly CommandDescriptor[] }>>
-
-  /**
-   * Parses and executes one slash-command line against the addressed agent
-   * without sending it to the model — pure admission semantics. matched=false
-   * when syntax or name does not resolve (the client falls back to its
-   * default sink). The handler's outcome does NOT ride the response: the host
-   * executor durably logs the lifecycle (`command/run`/`command/done`), which
-   * broadcasts on the mux stream and renders as a persistent flow node.
-   * `commandId` is present exactly when matched — the minted lifecycle
-   * pairing id, letting the issuing client correlate this acknowledgment
-   * with that flow node. The signal rides beside the request, never on the
-   * wire: the fetch carrier's request signal cancels the running handler.
-   * Session-backed subagents reject with `agent-busy` before dispatch.
-   */
-  execute(request: RpcRequest<{ sessionId: SessionId; line: string }>, signal: AbortSignal):
-  Promise<RpcResponse<{ matched: boolean; commandId?: CommandId }>>
-}
@@ -7,7 +7,6 @@
 import type { SessionsApi } from './sessions.ts'
 import type { HostApi } from './host.ts'
 import type { WorkspaceApi } from './workspace.ts'
-import type { CommandsApi } from './commands.ts'
 import type { AgentPresetsApi } from './agent-presets.ts'
 import type { SkillsApi } from './skills.ts'
 import type { SubagentsApi } from './subagents.ts'
@@ -25,7 +24,6 @@ export interface ApiProxy {
  subagents: SubagentsApi
  host: HostApi
  workspace: WorkspaceApi
-  commands: CommandsApi
  skills: SkillsApi
  agentPresets: AgentPresetsApi
  events: EventsApi
@@ -52,7 +50,6 @@ export type {
 } from './subagents.ts'
 export type { TaskView } from './tasks.ts'
 export type { WorkspaceApi, WorkspaceId, WorkspaceView } from './workspace.ts'
-export type { CommandsApi, CommandDescriptor } from './commands.ts'
 export type { SkillsApi, SkillEntry } from './skills.ts'
 export type { AgentPresetsApi, AgentPresetEntry } from './agent-presets.ts'
 export type { EventsApi, MuxFrame, HostFrame, QueuedInboxItem, ToolCallView, ToolEventView, ToolResultView } from './events.ts'
@@ -7,7 +7,6 @@
 import type { SessionsApi } from './sessions.ts'
 import type { HostApi } from './host.ts'
 import type { WorkspaceApi } from './workspace.ts'
-import type { CommandsApi } from './commands.ts'
 import type { AgentPresetsApi } from './agent-presets.ts'
 import type { SkillsApi } from './skills.ts'
 import type { GoalsApi } from './goals.ts'
@@ -51,8 +50,6 @@ export interface RpcMethodMap {
  'workspace.insertBefore': WorkspaceApi['insertBefore']
  'workspace.insertSessionBefore': WorkspaceApi['insertSessionBefore']
  'workspace.archiveSession': WorkspaceApi['archiveSession']
-  'command.list': CommandsApi['list']
-  'command.execute': CommandsApi['execute']
  'skill.list': SkillsApi['list']
  'agentPreset.list': AgentPresetsApi['list']
  'agentPreset.select': AgentPresetsApi['select']
@@ -91,6 +91,9 @@ export function rpcResultSchema<T>(value: z.ZodType<T>): z.ZodUnion<readonly [z.
 }

 // ---- The four wire full-form schemas (payload/result.value slots stay wide — business layer does the second parse) ----
+// The wide value slot is optional: a void business result serializes with no
+// `value` field at all. Each endpoint's own second parse still requires its
+// declared value, so absence never passes for a method that returns data.

 /** ClientRequest full form (payload stays wide — the business layer runs the second parse). */
 export const clientRequestSchema = z.object({
@@ -104,7 +107,7 @@ export const clientRequestSchema = z.object({
 export const serverResponseSchema = z.object({
  type: z.literal('server-response'),
  rpcId: rpcIdSchema,
-  result: rpcResultSchema(z.unknown()),
+  result: rpcResultSchema(z.unknown().optional()),
 }) as unknown as z.ZodType<ServerResponse>

 /** ServerRequest full form (payload stays wide). */
@@ -119,7 +122,7 @@ export const serverRequestSchema = z.object({
 export const clientResponseSchema = z.object({
  type: z.literal('client-response'),
  rpcId: rpcIdSchema,
-  result: rpcResultSchema(z.unknown()),
+  result: rpcResultSchema(z.unknown().optional()),
 }) as unknown as z.ZodType<ClientResponse>

 /** Wire full-form union (discriminated by type). */