simplify: remove dispatchRaw + RawDispatchOutput + grpc-integration doc

No consumer; synthesizes id:0 which breaks correlation/cancellation;
SEP-2598 (which would govern the mapping) is still draft. Re-add when
a real gRPC transport is in scope.

Author: felixweinberger

docs/grpc-integration.md

@@ -29,14 +29,6 @@ export type DispatchOutput =
     | { kind: 'notification'; message: JSONRPCNotification }
     | { kind: 'response'; message: JSONRPCResponse | JSONRPCErrorResponse };
 
-/**
- * Envelope-agnostic output from {@linkcode Dispatcher.dispatchRaw}. No JSON-RPC `{jsonrpc, id}` wrapping.
- */
-export type RawDispatchOutput =
-    | { kind: 'notification'; method: string; params?: Record<string, unknown> }
-    | { kind: 'result'; result: Result }
-    | { kind: 'error'; code: number; message: string; data?: unknown };
-
 type RawHandler<ContextT> = (request: JSONRPCRequest, ctx: ContextT) => Promise<Result>;
 
 /** Signature of {@linkcode Dispatcher.dispatch}. Target type for {@linkcode DispatchMiddleware}. */
@@ -191,31 +183,6 @@ export class Dispatcher<ContextT extends BaseContext = BaseContext> {
         yield { kind: 'response', message: final! };
     }
 
-    /**
-     * Envelope-agnostic dispatch for non-JSON-RPC drivers (gRPC, protobuf, REST).
-     * Takes `{method, params}` directly and yields unwrapped notifications and a terminal
-     * result/error. The JSON-RPC `{jsonrpc, id}` envelope is synthesized internally so
-     * registered handlers (which receive `JSONRPCRequest`) work unchanged.
-     *
-     * @experimental Shape may change to align with SEP-1319 named param/result types.
-     */
-    async *dispatchRaw(
-        method: string,
-        params: Record<string, unknown> | undefined,
-        env: RequestEnv = {}
-    ): AsyncGenerator<RawDispatchOutput, void, void> {
-        const synthetic: JSONRPCRequest = { jsonrpc: '2.0', id: 0, method, params };
-        for await (const out of this.dispatch(synthetic, env)) {
-            if (out.kind === 'notification') {
-                yield { kind: 'notification', method: out.message.method, params: out.message.params };
-            } else if ('result' in out.message) {
-                yield { kind: 'result', result: out.message.result };
-            } else {
-                yield { kind: 'error', ...out.message.error };
-            }
-        }
-    }
-
     /**
      * Dispatch one inbound notification to its handler. Errors are reported via the
      * returned promise; unknown methods are silently ignored.

packages/core/src/shared/dispatcher.ts

@@ -212,35 +212,3 @@ describe('Dispatcher.setRequestHandler 3-arg (custom method + paramsSchema)', ()
         expect(r.error.message).toMatch(/Invalid params for acme\/search/);
     });
 });
-
-describe('Dispatcher.dispatchRaw (envelope-agnostic)', () => {
-    test('yields result without JSON-RPC envelope', async () => {
-        const d = new Dispatcher();
-        d.setRawRequestHandler('greet', async r => ({ hello: (r.params as { name: string }).name }) as Result);
-        const out = [];
-        for await (const o of d.dispatchRaw('greet', { name: 'proto' })) out.push(o);
-        expect(out).toEqual([{ kind: 'result', result: { hello: 'proto' } }]);
-    });
-
-    test('yields error without envelope', async () => {
-        const d = new Dispatcher();
-        d.setRawRequestHandler('boom', async () => {
-            throw new ProtocolError(ProtocolErrorCode.InvalidParams, 'bad');
-        });
-        const out = [];
-        for await (const o of d.dispatchRaw('boom', {})) out.push(o);
-        expect(out).toEqual([{ kind: 'error', code: ProtocolErrorCode.InvalidParams, message: 'bad' }]);
-    });
-
-    test('yields notifications then result', async () => {
-        const d = new Dispatcher();
-        d.setRawRequestHandler('work', async (_r, ctx) => {
-            await ctx.mcpReq.notify({ method: 'notifications/progress', params: { progressToken: 't', progress: 1 } });
-            return { done: true } as Result;
-        });
-        const out = [];
-        for await (const o of d.dispatchRaw('work', {})) out.push(o);
-        expect(out[0]).toMatchObject({ kind: 'notification', method: 'notifications/progress' });
-        expect(out[1]).toEqual({ kind: 'result', result: { done: true } });
-    });
-});