Lemme give you an idea mare.

src/JSONInterfaceAdaptor/JSONInterfaceAdaptor.ts

@@ -0,0 +1,47 @@
+// SPDX-FileCopyrightText: 2025 Gnuxie <[email protected]>
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// SPDX-FileAttributionText: <text>
+// This modified file incorporates work from @the-draupnir-project/interface-manager
+// https://github.com/the-draupnir-project/interface-manager
+// </text>
+
+import { Result } from "@gnuxie/typescript-result";
+import { CommandDescription, CommandMeta } from "../Command";
+import { DescribeJSONRenderer } from "./JSONRendererDescription";
+
+export type JSONErrorResponse<
+  JSONBody extends Record<string, unknown> = Record<string, unknown>,
+> = {
+  readonly statusCode: number;
+  readonly body: JSONBody;
+};
+
+export type AsyncCommandResultCB = (
+  result: Result<Record<string, unknown>, JSONErrorResponse>
+) => void;
+
+export interface JSONInterfaceAdaptor<AdaptorContext, InvocationContext> {
+  parseAndInvoke(
+    jsonBody: Record<string, unknown>,
+    context: AdaptorContext,
+    invocationInfo: InvocationContext
+  ): Promise<Result<Record<string, unknown>, JSONErrorResponse>>;
+  asyncParseThenInvoke(
+    jsonBody: Record<string, unknown>,
+    context: AdaptorContext,
+    invocationInfo: InvocationContext,
+    cb: AsyncCommandResultCB
+  ): Promise<Result<void, JSONErrorResponse>>;
+  describeRenderer<TCommandMeta extends CommandMeta>(
+    commandDescription: CommandDescription<TCommandMeta>,
+    rendererDescription: DescribeJSONRenderer<TCommandMeta["CommandResult"]>
+  ): JSONInterfaceAdaptor<AdaptorContext, InvocationContext>;
+  isDescribingRendererForCommand<
+    TCommandDescription extends CommandDescription,
+  >(
+    commandDescription: TCommandDescription
+  ): boolean;
+  renderedCommands(): CommandDescription[];
+}

src/JSONInterfaceAdaptor/JSONRendererDescription.ts

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2025 Gnuxie <[email protected]>
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// SPDX-FileAttributionText: <text>
+// This modified file incorporates work from @the-draupnir-project/interface-manager
+// https://github.com/the-draupnir-project/interface-manager
+// </text>
+
+import { Result } from "@gnuxie/typescript-result";
+import { JSONErrorResponse } from "./JSONInterfaceAdaptor";
+
+export type JSONRendererDescription<CommandResult = unknown> = {
+  JSONRenderer?(
+    commandResult: Result<CommandResult>
+  ): Result<Record<string, unknown>, JSONErrorResponse>;
+  confirmationJSONRenderer?(
+    commandResult: Result<CommandResult>
+  ): Result<Record<string, unknown>, JSONErrorResponse>;
+};
+
+export type DescribeJSONRenderer<CommandResult = unknown> =
+  JSONRendererDescription<CommandResult>;

src/JSONInterfaceAdaptor/StandardJSONInterfaceAdaptor.ts

@@ -0,0 +1,40 @@
+// SPDX-FileCopyrightText: 2025 Gnuxie <[email protected]>
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// SPDX-FileAttributionText: <text>
+// This modified file incorporates work from @the-draupnir-project/interface-manager
+// https://github.com/the-draupnir-project/interface-manager
+// </text>
+
+import { CommandDescription } from "../Command";
+import {
+  AsyncCommandResultCB,
+  JSONInterfaceAdaptor,
+} from "./JSONInterfaceAdaptor";
+import { JSONRendererDescription } from "./JSONRendererDescription";
+
+export class StandardJSONInterfaceAdaptor<AdaptorContext, InvocationContext>
+  implements JSONInterfaceAdaptor<AdaptorContext, InvocationContext>
+{
+  private readonly renderers = new Map<
+    CommandDescription,
+    JSONRendererDescription
+  >();
+
+  constructor(private readonly defaultRenderer: JSONRendererDescription) {
+    // nothing to do.
+  }
+
+  public asyncParseThenInvoke(
+    jsonBody: Record<string, unknown>,
+    context: AdaptorContext,
+    invocationInfo: InvocationContext,
+    cb: AsyncCommandResultCB
+  ) {
+    // to do this properly we need to call the parser on the JSON body.
+    // that should return a presentation argument stream from which we
+    // can create a partial command.
+    // From there we just do the ususal stuff.
+  }
+}