Revert the revert of G's mesh-sdk merge (#191): G's sdk stands again over reader release 3

Main reverted G's half merge (#189, reverted by 8afc3eb in #191) and then took the reader release's S1-S5, which
copied G's code. G's form holds where they differ (process_bus.go, seats.go, state.go and their tests); the
release's kept names stay so main's callers keep building: SeatViewPrefix beside SeatReadPrefix, and QueueInvoke's
empty strings on not-ok (with its test TestQueueInvoke). The tree differs from G's head f30dee54 only by those and
the release's two tests (objects cap option, seat states and stream kinds).

Builds: design 47 G (the milestone's sdk part, as at f30dee54)

Claude-Session: https://claude.ai/code/session_01NcbgfGKaxw984XyAPfLm4h
This commit is contained in:
2026-11-13 12:49:56 +01:00
parent 93e0a7b50d
commit 5fa64be894
211 changed files with 32027 additions and 2484 deletions
+22 -4
View File
@@ -7,6 +7,18 @@ import type { Envelope, EventHeaders } from "../contracts/index.js";
export type { Envelope, EventHeaders };
/** How a publish is asked of the runtime. */
export interface PublishOptions {
/** Resolve once the bus acknowledged the message (the runtime's `mesh/publish` takes `ack: true`). */
readonly ack?: boolean;
}
/** How a subscription is asked of the runtime. */
export interface SubscribeOptions {
/** `new`: only messages published after the subscription (the runtime's `mesh/subscribe` takes `deliver: new`). */
readonly deliver?: "new";
}
/** A request/reply call and a publish/subscribe surface over the mesh broker. */
export interface Broker {
/** Ask one question and await one answer — the client side; the shape mesh-controller's command
@@ -15,10 +27,16 @@ export interface Broker {
/** Answer a question — the server side of request/reply. A tool runtime serves invocations this
* way. Returns an unregister. */
handle<Req, Res>(key: string, handler: (body: Req) => Promise<Res>): Promise<() => void>;
/** Emit an event onto the mesh. */
publish<T>(env: Envelope<T>): Promise<void>;
/** React to events matching a routing-key pattern. Returns an unsubscribe. */
subscribe<T>(pattern: string, handler: (env: Envelope<T>) => Promise<void>): Promise<() => void>;
/**
* Emit an event onto the mesh. With `ack: true` a bundle's publish resolves only once the bus acknowledged it and
* rejects with the reason where it did not (design 47 G §559).
*/
publish<T>(env: Envelope<T>, options?: PublishOptions): Promise<void>;
/**
* React to events matching a routing-key pattern. Returns an unsubscribe. With `deliver: "new"` the handler is given
* only the messages published after the subscription is made (design 47 G §559).
*/
subscribe<T>(pattern: string, handler: (env: Envelope<T>) => Promise<void>, options?: SubscribeOptions): Promise<() => void>;
close(): Promise<void>;
}