starpc 0.49.18 → 0.50.0

package/dist/srpc/invoker.js

@@ -6,7 +6,7 @@ import { MethodKind } from '@aptre/protobuf-es-lite';
 // createInvokeFn builds an InvokeFn from a method definition and a function prototype.
 export function createInvokeFn(methodInfo, methodProto) {
     const requestDecode = buildDecodeMessageTransform(methodInfo.I);
-    return async (dataSource, dataSink) => {
+    return async (dataSource, dataSink, invocation) => {
         // responseSink is a Sink for response messages.
         const responseSink = pushable({
             objectMode: true,
@@ -34,7 +34,7 @@ export function createInvokeFn(methodInfo, methodProto) {
         }
         // Call the implementation.
         try {
-            const responseObj = methodProto(requestArg);
+            const responseObj = methodProto(requestArg, invocation);
             if (!responseObj) {
                 throw new Error('return value was undefined');
             }

package/dist/srpc/rpcproto.pb.d.ts

@@ -1,5 +1,49 @@
-import type { MessageType } from '@aptre/protobuf-es-lite';
+import type { MessageType } from '@aptre/protobuf-es-lite/message';
 export declare const protobufPackage = "srpc";
+/**
+ * TerminalKind is the terminal state of a held unary invocation.
+ *
+ * @generated from enum srpc.TerminalKind
+ */
+export declare enum TerminalKind {
+    /**
+     * TERMINAL_KIND_UNSPECIFIED is not a valid terminal state.
+     *
+     * @generated from enum value: TERMINAL_KIND_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * TERMINAL_KIND_COMMITTED identifies an explicit remote CallData completion.
+     *
+     * @generated from enum value: TERMINAL_KIND_COMMITTED = 1;
+     */
+    COMMITTED = 1,
+    /**
+     * TERMINAL_KIND_CANCELED identifies a remote CallCancel packet.
+     *
+     * @generated from enum value: TERMINAL_KIND_CANCELED = 2;
+     */
+    CANCELED = 2,
+    /**
+     * TERMINAL_KIND_TRANSPORT_LOST identifies a remote error or transport failure.
+     *
+     * @generated from enum value: TERMINAL_KIND_TRANSPORT_LOST = 3;
+     */
+    TRANSPORT_LOST = 3,
+    /**
+     * TERMINAL_KIND_CLOSED identifies a bare remote close without completion.
+     *
+     * @generated from enum value: TERMINAL_KIND_CLOSED = 4;
+     */
+    CLOSED = 4,
+    /**
+     * TERMINAL_KIND_ABANDONED identifies owner-context expiry without a remote terminal.
+     *
+     * @generated from enum value: TERMINAL_KIND_ABANDONED = 5;
+     */
+    ABANDONED = 5
+}
+export declare const TerminalKind_Enum: import("@aptre/protobuf-es-lite/enum").EnumType;
 /**
  * CallStart requests starting a new RPC call.
  *

package/dist/srpc/rpcproto.pb.js

@@ -1,10 +1,64 @@
 // @generated by protoc-gen-es-lite unknown with parameter "target=ts,ts_nocheck=false"
 // @generated from file github.com/aperturerobotics/starpc/srpc/rpcproto.proto (package srpc, syntax proto3)
 /* eslint-disable */
-import { createMessageType, ScalarType } from '@aptre/protobuf-es-lite';
+import { createEnumType } from '@aptre/protobuf-es-lite/enum';
+import { createMessageType } from '@aptre/protobuf-es-lite/message';
+import { ScalarType } from '@aptre/protobuf-es-lite/scalar';
 export const protobufPackage = 'srpc';
-// CallStart contains the message type declaration for CallStart.
-export const CallStart = createMessageType({
+/**
+ * TerminalKind is the terminal state of a held unary invocation.
+ *
+ * @generated from enum srpc.TerminalKind
+ */
+export var TerminalKind;
+(function (TerminalKind) {
+    /**
+     * TERMINAL_KIND_UNSPECIFIED is not a valid terminal state.
+     *
+     * @generated from enum value: TERMINAL_KIND_UNSPECIFIED = 0;
+     */
+    TerminalKind[TerminalKind["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+    /**
+     * TERMINAL_KIND_COMMITTED identifies an explicit remote CallData completion.
+     *
+     * @generated from enum value: TERMINAL_KIND_COMMITTED = 1;
+     */
+    TerminalKind[TerminalKind["COMMITTED"] = 1] = "COMMITTED";
+    /**
+     * TERMINAL_KIND_CANCELED identifies a remote CallCancel packet.
+     *
+     * @generated from enum value: TERMINAL_KIND_CANCELED = 2;
+     */
+    TerminalKind[TerminalKind["CANCELED"] = 2] = "CANCELED";
+    /**
+     * TERMINAL_KIND_TRANSPORT_LOST identifies a remote error or transport failure.
+     *
+     * @generated from enum value: TERMINAL_KIND_TRANSPORT_LOST = 3;
+     */
+    TerminalKind[TerminalKind["TRANSPORT_LOST"] = 3] = "TRANSPORT_LOST";
+    /**
+     * TERMINAL_KIND_CLOSED identifies a bare remote close without completion.
+     *
+     * @generated from enum value: TERMINAL_KIND_CLOSED = 4;
+     */
+    TerminalKind[TerminalKind["CLOSED"] = 4] = "CLOSED";
+    /**
+     * TERMINAL_KIND_ABANDONED identifies owner-context expiry without a remote terminal.
+     *
+     * @generated from enum value: TERMINAL_KIND_ABANDONED = 5;
+     */
+    TerminalKind[TerminalKind["ABANDONED"] = 5] = "ABANDONED";
+})(TerminalKind || (TerminalKind = {}));
+export const TerminalKind_Enum = /* @__PURE__ */ createEnumType('srpc.TerminalKind', [
+    [0, 'TERMINAL_KIND_UNSPECIFIED'],
+    [1, 'TERMINAL_KIND_COMMITTED'],
+    [2, 'TERMINAL_KIND_CANCELED'],
+    [3, 'TERMINAL_KIND_TRANSPORT_LOST'],
+    [4, 'TERMINAL_KIND_CLOSED'],
+    [5, 'TERMINAL_KIND_ABANDONED'],
+]);
+export const CallStart = 
+/* @__PURE__ */ createMessageType({
     typeName: 'srpc.CallStart',
     fields: [
         { no: 1, name: 'rpc_service', kind: 'scalar', T: ScalarType.STRING },
@@ -14,8 +68,8 @@ export const CallStart = createMessageType({
     ],
     packedByDefault: true,
 });
-// CallData contains the message type declaration for CallData.
-export const CallData = createMessageType({
+export const CallData = 
+/* @__PURE__ */ createMessageType({
     typeName: 'srpc.CallData',
     fields: [
         { no: 1, name: 'data', kind: 'scalar', T: ScalarType.BYTES },
@@ -25,8 +79,7 @@ export const CallData = createMessageType({
     ],
     packedByDefault: true,
 });
-// Packet contains the message type declaration for Packet.
-export const Packet = createMessageType({
+export const Packet = /* @__PURE__ */ createMessageType({
     typeName: 'srpc.Packet',
     fields: [
         {

package/dist/srpc/server-invocation.d.ts

@@ -0,0 +1,17 @@
+import type { TerminalKind } from './rpcproto.pb.js';
+export declare class ServerInvocation implements AbortSignal {
+    readonly signal: AbortSignal;
+    private readonly waitFn;
+    constructor(signal: AbortSignal, waitFn: (ownerSignal: AbortSignal) => Promise<TerminalKind>);
+    get aborted(): boolean;
+    get onabort(): typeof this.signal.onabort;
+    set onabort(value: typeof this.signal.onabort);
+    get reason(): any;
+    throwIfAborted(): void;
+    addEventListener<K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => unknown, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => unknown, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    dispatchEvent(event: Event): boolean;
+    waitTerminal(ownerSignal: AbortSignal): Promise<TerminalKind>;
+}

package/dist/srpc/server-invocation.js

@@ -0,0 +1,37 @@
+// ServerInvocation exposes the invocation signal and terminal wait.
+export class ServerInvocation {
+    signal;
+    waitFn;
+    constructor(signal, waitFn) {
+        this.signal = signal;
+        this.waitFn = waitFn;
+    }
+    get aborted() {
+        return this.signal.aborted;
+    }
+    get onabort() {
+        return this.signal.onabort;
+    }
+    set onabort(value) {
+        this.signal.onabort = value;
+    }
+    get reason() {
+        return this.signal.reason;
+    }
+    throwIfAborted() {
+        this.signal.throwIfAborted();
+    }
+    addEventListener(type, listener, options) {
+        this.signal.addEventListener(type, listener, options);
+    }
+    removeEventListener(type, listener, options) {
+        this.signal.removeEventListener(type, listener, options);
+    }
+    dispatchEvent(event) {
+        return this.signal.dispatchEvent(event);
+    }
+    // waitTerminal waits for a remote terminal or owner-signal cancellation.
+    waitTerminal(ownerSignal) {
+        return this.waitFn(ownerSignal);
+    }
+}

package/dist/srpc/server-rpc.js

@@ -1,4 +1,5 @@
 import { CommonRPC } from './common-rpc.js';
+import { ServerInvocation } from './server-invocation.js';
 // ServerRPC is an ongoing RPC from the server side.
 export class ServerRPC extends CommonRPC {
     // lookupMethod looks up the incoming RPC methods.
@@ -37,8 +38,9 @@ export class ServerRPC extends CommonRPC {
     // invokeRPC starts invoking the RPC handler.
     async invokeRPC(invokeFn) {
         const dataSink = this._createDataSink();
+        const invocation = new ServerInvocation(this.invocationSignal, (ownerSignal) => this.waitTerminal(ownerSignal));
         try {
-            await invokeFn(this.rpcDataSource, dataSink);
+            await invokeFn(this.rpcDataSource, dataSink, invocation);
         }
         catch (err) {
             this.close(err);

package/echo/echo.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-go-lite. DO NOT EDIT.
-// protoc-gen-go-lite version: v0.12.1
+// protoc-gen-go-lite version: v0.13.0
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 package echo

package/echo/echo.pb.ts

@@ -2,8 +2,10 @@
 // @generated from file github.com/aperturerobotics/starpc/echo/echo.proto (package echo, syntax proto3)
 /* eslint-disable */
 
-import type { MessageType, PartialFieldInfo } from '@aptre/protobuf-es-lite'
-import { createMessageType, ScalarType } from '@aptre/protobuf-es-lite'
+import type { MessageType } from '@aptre/protobuf-es-lite/message'
+import { createMessageType } from '@aptre/protobuf-es-lite/message'
+import { ScalarType } from '@aptre/protobuf-es-lite/scalar'
+import type { PartialFieldInfo } from '@aptre/protobuf-es-lite/field'
 
 export const protobufPackage = 'echo'
 
@@ -19,11 +21,10 @@ export interface EchoMsg {
   body?: string
 }
 
-// EchoMsg contains the message type declaration for EchoMsg.
-export const EchoMsg: MessageType<EchoMsg> = createMessageType({
+export const EchoMsg: MessageType<EchoMsg> = /* @__PURE__ */ createMessageType({
   typeName: 'echo.EchoMsg',
   fields: [
     { no: 1, name: 'body', kind: 'scalar', T: ScalarType.STRING },
-  ] as readonly PartialFieldInfo[],
+  ] satisfies readonly PartialFieldInfo[],
   packedByDefault: true,
 })

package/echo/echo_srpc.pb.cpp

@@ -1,7 +1,7 @@
 //go:build deps_only
 
 // Code generated by protoc-gen-starpc-cpp. DO NOT EDIT.
-// protoc-gen-starpc-cpp version: v0.46.1
+// protoc-gen-starpc-cpp version: v0.49.7
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 #include "echo_srpc.pb.hpp"

package/echo/echo_srpc.pb.go

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-srpc. DO NOT EDIT.
-// protoc-gen-srpc version: v0.46.1
+// protoc-gen-srpc version: v0.49.7
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 package echo

package/echo/echo_srpc.pb.hpp

@@ -1,7 +1,7 @@
 //go:build deps_only && cgo
 
 // Code generated by protoc-gen-starpc-cpp. DO NOT EDIT.
-// protoc-gen-starpc-cpp version: v0.46.1
+// protoc-gen-starpc-cpp version: v0.49.7
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 #pragma once

package/echo/echo_srpc.pb.rs

@@ -1,5 +1,5 @@
 // Code generated by protoc-gen-starpc-rust. DO NOT EDIT.
-// protoc-gen-starpc-rust version: v0.46.1
+// protoc-gen-starpc-rust version: v0.49.7
 // source: github.com/aperturerobotics/starpc/echo/echo.proto
 
 #[allow(unused_imports)]

package/go.mod

@@ -3,31 +3,32 @@ module github.com/aperturerobotics/starpc
 go 1.25.0
 
 require (
-	github.com/aperturerobotics/common v0.33.1-0.20260516193515-675cfc5a0c12 // latest
-	github.com/aperturerobotics/protobuf-go-lite v0.13.0 // latest
-	github.com/aperturerobotics/util v1.34.5 // latest
+	github.com/aperturerobotics/common v0.34.4 // latest
+	github.com/aperturerobotics/protobuf-go-lite v0.16.0 // latest
+	github.com/aperturerobotics/util v1.34.9 // latest
 )
 
 require (
 	github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017 // aperture-2
 	github.com/aperturerobotics/cli v1.1.0 // indirect
-	github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260329113538-218ccd8f20e0 // indirect
-	github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260329113540-600516012db3 // indirect
-	github.com/aperturerobotics/go-websocket v1.8.15-0.20260329113544-74dbfb8f11c6 // master
-	github.com/aperturerobotics/json-iterator-lite v1.0.1-0.20251104042408-0c9eb8a3f726 // indirect
+	github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b // indirect
+	github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17 // indirect
+	github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1 // master
+	github.com/aperturerobotics/json-iterator-lite v1.1.0 // indirect
 	github.com/aperturerobotics/protobuf v0.0.0-20260203024654-8201686529c4 // wasi
 )
 
 require (
-	github.com/libp2p/go-yamux/v4 v4.0.2 // latest
 	github.com/pkg/errors v0.9.1 // latest
-	github.com/sirupsen/logrus v1.9.5-0.20260508084601-d4a50659cfd6 // latest
+	github.com/sirupsen/logrus v1.9.5-0.20260629095817-a23d315dfebb // latest
 )
 
+require github.com/libp2p/go-yamux/v5 v5.1.0
+
 require (
 	github.com/libp2p/go-buffer-pool v0.1.0 // indirect
-	github.com/tetratelabs/wazero v1.11.0 // indirect
+	github.com/tetratelabs/wazero v1.12.0 // indirect
 	github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 // indirect
-	golang.org/x/mod v0.35.0 // indirect
-	golang.org/x/sys v0.44.0 // indirect
+	golang.org/x/mod v0.38.0 // indirect
+	golang.org/x/sys v0.47.0 // indirect
 )

package/go.sum

@@ -2,46 +2,46 @@ github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017 h1:3U7
 github.com/aperturerobotics/abseil-cpp v0.0.0-20260131110040-4bb56e2f9017/go.mod h1:lNSJTKECIUFAnfeSqy01kXYTYe1BHubW7198jNX3nEw=
 github.com/aperturerobotics/cli v1.1.0 h1:7a+YRC+EY3npAnTzhHV5gLCiw91KS0Ts3XwLILGOsT8=
 github.com/aperturerobotics/cli v1.1.0/go.mod h1:M7BFP9wow5ytTzMyJQOOO991fGfsUqdTI7gGEsHfTQ8=
-github.com/aperturerobotics/common v0.33.1-0.20260516193515-675cfc5a0c12 h1:KQiFEDyu5//G8JZ3yTN92kF2P3F+LHjSKsQikgROncU=
-github.com/aperturerobotics/common v0.33.1-0.20260516193515-675cfc5a0c12/go.mod h1:pW7BhBpKzVrTxN8XIz6jb3MJERZ15GDxaGQ7jcIl0Xg=
-github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260329113538-218ccd8f20e0 h1:6/3RSSlPEQ6LeidslB1ZCJkxW+MnfYDkvdWMDklDXw4=
-github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260329113538-218ccd8f20e0/go.mod h1:OBb/beWmr/pDIZAUfi86j/4tBh2v5ctTxKMqSnh9c/4=
-github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260329113540-600516012db3 h1:lp+V8RYcBwTX1p81swkpZn5fhw1wn2xLorzETIxRyZQ=
-github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260329113540-600516012db3/go.mod h1:vEq8i7EKb32+KXGtIEZjjhNns+BdsL2dUMw4uhy3578=
-github.com/aperturerobotics/go-websocket v1.8.15-0.20260329113544-74dbfb8f11c6 h1:Utc1F7jdCc6/HrwwIikJFXt/hXxkWIWETLp/CsG6Gl0=
-github.com/aperturerobotics/go-websocket v1.8.15-0.20260329113544-74dbfb8f11c6/go.mod h1:9KnSGuqxSXbdB/Oi0I6vvfPLkclfJwMGAQaDDGVgGow=
-github.com/aperturerobotics/json-iterator-lite v1.0.1-0.20251104042408-0c9eb8a3f726 h1:4B1F0DzuqPzb6WqgCjWaqDD7JU9RDsevQG5OP0DFBgs=
-github.com/aperturerobotics/json-iterator-lite v1.0.1-0.20251104042408-0c9eb8a3f726/go.mod h1:SvGGBv3OVxUyqO0ZxA/nvs6z3cg7NIbZ64TnbV2OISo=
+github.com/aperturerobotics/common v0.34.4 h1:RQTOm6LxEnucXkED/kruhKKAOL6tbaPzMgfHPKaES4k=
+github.com/aperturerobotics/common v0.34.4/go.mod h1:xnb1VBRs3x2o1PaKg0OlP7SqDaC9Hmrmt9xH85rOS+A=
+github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b h1:MMk+AbWPCMfqc2Lm2bJl8lCCsuvlM2+C0CP10fpE3bc=
+github.com/aperturerobotics/go-protoc-gen-prost v0.0.0-20260705010911-9f53feac967b/go.mod h1:OBb/beWmr/pDIZAUfi86j/4tBh2v5ctTxKMqSnh9c/4=
+github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17 h1:WT1YmZjJf8fUF1zKbeNNKXFA+t8Wtbr8AVMAmdKcrUU=
+github.com/aperturerobotics/go-protoc-wasi v0.0.0-20260712054757-d8078c296c17/go.mod h1:vEq8i7EKb32+KXGtIEZjjhNns+BdsL2dUMw4uhy3578=
+github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1 h1:q2qkdNOrnhAFf6B7TBeUoAYstYWxPvozN+3vJi2jgp0=
+github.com/aperturerobotics/go-websocket v1.8.15-0.20260619192713-a096778f08c1/go.mod h1:9KnSGuqxSXbdB/Oi0I6vvfPLkclfJwMGAQaDDGVgGow=
+github.com/aperturerobotics/json-iterator-lite v1.1.0 h1:ZLLqHhHTKYlmCAP873ras2e/yVU/THtwC+ji3tXLMMg=
+github.com/aperturerobotics/json-iterator-lite v1.1.0/go.mod h1:SvGGBv3OVxUyqO0ZxA/nvs6z3cg7NIbZ64TnbV2OISo=
 github.com/aperturerobotics/protobuf v0.0.0-20260203024654-8201686529c4 h1:4Dy3BAHh2kgVdHAqtlwcFsgY0kAwUe2m3rfFcaGwGQg=
 github.com/aperturerobotics/protobuf v0.0.0-20260203024654-8201686529c4/go.mod h1:tMgO7y6SJo/d9ZcvrpNqIQtdYT9de+QmYaHOZ4KnhOg=
-github.com/aperturerobotics/protobuf-go-lite v0.13.0 h1:jEvCJhHaJEikDY/va2AUnS0DOb/0n82aISLAqxSh4Sk=
-github.com/aperturerobotics/protobuf-go-lite v0.13.0/go.mod h1:lGH3s5ArCTXKI4wJdlNpaybUtwSjfAG0vdWjxOfMcF8=
-github.com/aperturerobotics/util v1.34.5 h1:007MaOJrrsiGm5o1c8Tt7p8nVwUAxkM6pmGflrBww/U=
-github.com/aperturerobotics/util v1.34.5/go.mod h1:mDe7WnncVuV7yjeeVSsagyfrw4xfncu7d+f0+d70niY=
+github.com/aperturerobotics/protobuf-go-lite v0.16.0 h1:McGR0jrc15ZkH8HUpAARDOtazjwqr+uYXVHrrR59K28=
+github.com/aperturerobotics/protobuf-go-lite v0.16.0/go.mod h1:3Ay/E7iaw2KWLirK3+dDdNJZHK0hu8Y1/kKeYeUa+8s=
+github.com/aperturerobotics/util v1.34.9 h1:Eyhu1Citt+od7jKIb+Q92h/CEujWCFsvdvJavQeoRjM=
+github.com/aperturerobotics/util v1.34.9/go.mod h1:GxjGkYQNEj8xvLFz+T8ifqANtK5cMesOlCxh50htvBI=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
 github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
 github.com/libp2p/go-buffer-pool v0.1.0 h1:oK4mSFcQz7cTQIfqbe4MIj9gLW+mnanjyFtc6cdF0Y8=
 github.com/libp2p/go-buffer-pool v0.1.0/go.mod h1:N+vh8gMqimBzdKkSMVuydVDq+UV5QTWy5HSiZacSbPg=
-github.com/libp2p/go-yamux/v4 v4.0.2 h1:nrLh89LN/LEiqcFiqdKDRHjGstN300C1269K/EX0CPU=
-github.com/libp2p/go-yamux/v4 v4.0.2/go.mod h1:C808cCRgOs1iBwY4S71T5oxgMxgLmqUw56qh4AeBW2o=
+github.com/libp2p/go-yamux/v5 v5.1.0 h1:8Qlxj4E9JGJAQVW6+uj2o7mqkqsIVlSUGmTWhlXzoHE=
+github.com/libp2p/go-yamux/v5 v5.1.0/go.mod h1:tgIQ07ObtRR/I0IWsFOyQIL9/dR5UXgc2s8xKmNZv1o=
 github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=
 github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
 github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/sirupsen/logrus v1.9.5-0.20260508084601-d4a50659cfd6 h1:D6qewLO/pJ+JvUwuri1dmCbc32d/eO+xyqg+p3N+9kA=
-github.com/sirupsen/logrus v1.9.5-0.20260508084601-d4a50659cfd6/go.mod h1:FXZFonkDAnFozmO+5hGAFvB0Yg9/j2SIhA/QuIkP180=
+github.com/sirupsen/logrus v1.9.5-0.20260629095817-a23d315dfebb h1:+C8W2sTMIRbihe5hQH6JuT2mi3m/QgdGf0YdFyx2azA=
+github.com/sirupsen/logrus v1.9.5-0.20260629095817-a23d315dfebb/go.mod h1:FXZFonkDAnFozmO+5hGAFvB0Yg9/j2SIhA/QuIkP180=
 github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
 github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=
-github.com/tetratelabs/wazero v1.11.0 h1:+gKemEuKCTevU4d7ZTzlsvgd1uaToIDtlQlmNbwqYhA=
-github.com/tetratelabs/wazero v1.11.0/go.mod h1:eV28rsN8Q+xwjogd7f4/Pp4xFxO7uOGbLcD/LzB1wiU=
+github.com/tetratelabs/wazero v1.12.0 h1:DuWcpNu/FzgEXgGBDp8J1Spc+CWOvvtvVyjKlaZopYU=
+github.com/tetratelabs/wazero v1.12.0/go.mod h1:LvKtzl2RqO4gyF27BiXU+nKAjcV8f38U+kP/q2vgxh0=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 h1:FnBeRrxr7OU4VvAzt5X7s6266i6cSVkkFPS0TuXWbIg=
 github.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=
-golang.org/x/mod v0.35.0 h1:Ww1D637e6Pg+Zb2KrWfHQUnH2dQRLBQyAtpr/haaJeM=
-golang.org/x/mod v0.35.0/go.mod h1:+GwiRhIInF8wPm+4AoT6L0FA1QWAad3OMdTRx4tFYlU=
-golang.org/x/sys v0.44.0 h1:ildZl3J4uzeKP07r2F++Op7E9B29JRUy+a27EibtBTQ=
-golang.org/x/sys v0.44.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/mod v0.38.0 h1:MECBjubtXD7yj4HrhIUcywNaGeNVUdfVnxmPajOk4yk=
+golang.org/x/mod v0.38.0/go.mod h1:V6Xz0pq8TQ3dGqVQ1FVHuelZpAL0uNhSkk9ogYP3c40=
+golang.org/x/sys v0.47.0 h1:o7XGOvZQCADBQQ4Y7VNq2dRWQR7JmOUW8Kxx4ZsNgWs=
+golang.org/x/sys v0.47.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
 google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
 google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=

package/integration/cross-language/go-client/main.go

@@ -2,6 +2,7 @@ package main
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"io"
 	"net"
@@ -14,14 +15,32 @@ import (
 const bodyTxt = "hello world via starpc cross-language e2e test"
 
 func main() {
-	if len(os.Args) < 2 {
-		fmt.Fprintf(os.Stderr, "usage: go-client <addr>\n")
+	receiptMode := len(os.Args) > 1 && os.Args[1] == "receipt"
+	receiptCase := ""
+	addrIndex := 1
+	if receiptMode {
+		if len(os.Args) < 3 {
+			fmt.Fprintf(os.Stderr, "usage: go-client receipt <case> <addr>\n")
+			os.Exit(1)
+		}
+		receiptCase = os.Args[2]
+		addrIndex = 3
+		switch receiptCase {
+		case "commit", "abort", "loss", "bare-close":
+		default:
+			fmt.Fprintf(os.Stderr, "unknown receipt case: %s\n", receiptCase)
+			os.Exit(1)
+		}
+	}
+	if len(os.Args) <= addrIndex {
+		fmt.Fprintf(os.Stderr, "usage: go-client [receipt <case>] <addr>\n")
 		os.Exit(1)
 	}
-	addr := os.Args[1]
-
+	addr := os.Args[addrIndex]
+	var conn net.Conn
 	openStream := func(ctx context.Context, msgHandler srpc.PacketDataHandler, closeHandler srpc.CloseHandler) (srpc.PacketWriter, error) {
-		conn, err := net.Dial("tcp", addr) //nolint:gosec
+		var err error
+		conn, err = net.Dial("tcp", addr) //nolint:gosec
 		if err != nil {
 			return nil, err
 		}
@@ -33,6 +52,14 @@ func main() {
 	client := srpc.NewClient(openStream)
 	echoClient := echo.NewSRPCEchoerClient(client)
 	ctx := context.Background()
+	if receiptMode {
+		if err := testReceipt(ctx, client, &conn, receiptCase); err != nil {
+			fmt.Fprintf(os.Stderr, "receipt test failed: %v\n", err)
+			os.Exit(1)
+		}
+		fmt.Println("All tests passed.")
+		return
+	}
 
 	if err := testUnary(ctx, echoClient); err != nil {
 		fmt.Fprintf(os.Stderr, "unary test failed: %v\n", err)
@@ -70,6 +97,79 @@ func testUnary(ctx context.Context, client echo.SRPCEchoerClient) error {
 	return nil
 }
 
+func testReceipt(
+	ctx context.Context,
+	client srpc.Client,
+	conn *net.Conn,
+	receiptCase string,
+) error {
+	fmt.Printf("Testing held unary receipt (%s)...\n", receiptCase)
+	out := new(echo.EchoMsg)
+	receipt, err := srpc.ExecCallReceipt(
+		ctx, client, echo.SRPCEchoerServiceID, "Echo",
+		&echo.EchoMsg{Body: bodyTxt}, out,
+	)
+	if err != nil {
+		return fmt.Errorf("receipt call: %w", err)
+	}
+	if out.GetBody() != bodyTxt {
+		return fmt.Errorf("expected %q got %q", bodyTxt, out.GetBody())
+	}
+
+	switch receiptCase {
+	case "commit":
+		if err := receipt.Commit(); err != nil {
+			return fmt.Errorf("receipt commit: %w", err)
+		}
+	case "abort":
+		if err := receipt.Abort(); err != nil {
+			return fmt.Errorf("receipt abort: %w", err)
+		}
+	case "loss":
+		if *conn == nil {
+			return errors.New("receipt connection is nil")
+		}
+		tcpConn, ok := (*conn).(*net.TCPConn)
+		if !ok {
+			return errors.New("receipt connection is not TCP")
+		}
+		if err := tcpConn.SetLinger(0); err != nil {
+			return fmt.Errorf("set receipt loss linger: %w", err)
+		}
+		if err := tcpConn.Close(); err != nil {
+			return fmt.Errorf("close lost connection: %w", err)
+		}
+		if err := receipt.Commit(); err == nil {
+			return errors.New("loss receipt commit unexpectedly succeeded")
+		}
+	case "bare-close":
+		if *conn == nil {
+			return errors.New("receipt connection is nil")
+		}
+		tcpConn, ok := (*conn).(*net.TCPConn)
+		if !ok {
+			return errors.New("receipt connection is not TCP")
+		}
+		if err := tcpConn.CloseWrite(); err != nil {
+			return fmt.Errorf("close receipt write side: %w", err)
+		}
+		if err := receipt.Commit(); err == nil {
+			return errors.New("bare-close receipt commit unexpectedly succeeded")
+		}
+	default:
+		return fmt.Errorf("unknown receipt case: %s", receiptCase)
+	}
+
+	if err := emitReceiptEvent(
+		fmt.Sprintf("CLIENT_RECEIPT_RESOLVED %s", receiptTerminalName(receiptCase)),
+	); err != nil {
+		return fmt.Errorf("record receipt resolution: %w", err)
+	}
+
+	fmt.Println("  PASSED")
+	return nil
+}
+
 func testServerStream(ctx context.Context, client echo.SRPCEchoerClient) error {
 	fmt.Println("Testing ServerStream RPC...")
 	strm, err := client.EchoServerStream(ctx, &echo.EchoMsg{Body: bodyTxt})
@@ -149,3 +249,35 @@ func testBidiStream(ctx context.Context, client echo.SRPCEchoerClient) error {
 	fmt.Println("  PASSED")
 	return nil
 }
+
+func receiptTerminalName(receiptCase string) string {
+	switch receiptCase {
+	case "commit":
+		return "committed"
+	case "abort":
+		return "canceled"
+	case "loss":
+		return "transportLost"
+	case "bare-close":
+		return "closed"
+	default:
+		return "unknown"
+	}
+}
+
+func emitReceiptEvent(line string) error {
+	fmt.Println(line)
+	fifo := os.Getenv("RECEIPT_EVENT_FIFO")
+	if fifo == "" {
+		return nil
+	}
+	file, err := os.OpenFile(fifo, os.O_WRONLY, 0) //nolint:gosec // FIFO path is created by the local integration runner.
+	if err != nil {
+		return err
+	}
+	if _, err := file.WriteString(line + "\n"); err != nil {
+		_ = file.Close()
+		return err
+	}
+	return file.Close()
+}