feat(companion): add connection snapshot helper

src/companion/runtimeClient.test.ts

@@ -721,6 +721,33 @@ describe('CompanionRuntimeClient', () => {
     await pendingWait;
   });
 
+  it('returns connection snapshot', async () => {
+    const client = new CompanionRuntimeClient({
+      url: 'ws://127.0.0.1:1',
+    });
+    const pendingWait = client.waitForEvent('agent.stream', { timeoutMs: 10_000 }).catch(() => undefined);
+
+    expect(client.getConnectionSnapshot()).toEqual({
+      connected: false,
+      eventSubscriptionCount: 1,
+      pendingRequestCount: 0,
+      pendingEventWaitCount: 1,
+      hasPendingWork: true,
+      idle: false,
+    });
+
+    client.clearEventSubscriptions();
+    await pendingWait;
+    expect(client.getConnectionSnapshot()).toEqual({
+      connected: false,
+      eventSubscriptionCount: 0,
+      pendingRequestCount: 0,
+      pendingEventWaitCount: 0,
+      hasPendingWork: false,
+      idle: true,
+    });
+  });
+
   it('waitForIdle resolves immediately when no work is pending', async () => {
     const client = new CompanionRuntimeClient({
       url: 'ws://127.0.0.1:1',