CommandService.execute now returns a CommandExecution — the normalized result plus the commandId minted for its command/run/command/done records — and the wire admission value carries commandId exactly when matched, so the issuing client can correlate its RPC acknowledgment with the flow node the lifecycle events produce. apiproxy api/schema/handler, the connection fixture, and the TUI/plan/goal consumers follow the new shape.
40 lines
1.6 KiB
TypeScript
40 lines
1.6 KiB
TypeScript
/**
|
|
* commands domain zod schemas (names derived from map keys: commandListRequestSchema /
|
|
* commandListValueSchema / commandExecuteRequestSchema / commandExecuteValueSchema).
|
|
*/
|
|
|
|
import { z } from 'zod'
|
|
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'>>>
|
|
|
|
/** 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: z.string().min(1).optional(),
|
|
}) satisfies z.ZodType<Wire<ResponseValue<'command.execute'>>>
|