Files
buzz/mobile/test/shared/agents/remote_agents_test.dart
Tom Brow b41caeb510 fix(mobile): time out relay connects that never finish the handshake (#8878)
When a phone's network silently stops working (crowded event Wi-Fi, a
weak cell signal), Buzz Mobile can stay offline for minutes. In a device
test, the app took 30s to notice the dead connection, then hid the
channel's messages behind a loading skeleton. It tried to reconnect
once, and that attempt hung for 5 minutes (303s). It never retried,
because it only retries after an attempt fails.

This PR gives every reconnect attempt a 10s limit. When an attempt runs
out of time, the app closes it and tries again with its normal backoff.

### What was wrong

Opening the relay connection has two code paths. The one used with
hosted relay auth already had a 10s limit. The other path had none, so a
stuck attempt waited for the operating system to give up, which takes
minutes. Both paths now use the same limit. Each attempt also gets its
own HTTP client, so a timed-out attempt is actually closed rather than
left running in the background.

### Validation

I tested on an iPhone SE (iOS 27.0.1) running a profile build, with its
relay traffic routed through a Mac proxy that could silently drop
everything.

- **Before:** during a 5.6 minute outage, the app made one reconnect
attempt, which hung for 303s.
- **After:** during a 2.5 minute outage, each attempt gave up after 10s
and the app kept retrying. It reconnected 36s after the network came
back, a delay mostly set by the 30s cap on time between retries.

Added tests: `relay_socket_liveness_test` now covers an attempt that
never completes, with and without hosted relay auth headers. It checks
that the attempt fails and that the abandoned connection is closed. The
test fails without the fix.

Two existing tests were opening real relay connections by accident or
design:

- `deep_link_dispatcher_test` now uses a fake channel list, like its
neighboring tests.
- `remote_agents_test` talks to a real local relay on purpose, so it now
uses a real HTTP client instead of the test framework's mock.

The full mobile test suite passes.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Signed-off-by: Tom Brow <tomb@squareup.com>
Co-authored-by: Tom Brow <tomb@squareup.com>
2026-11-01 07:32:28 -08:00

1029 lines
34 KiB
Dart

import 'dart:convert';
import 'dart:io';
import 'package:buzz/features/profile/presence_cache_provider.dart';
import 'package:buzz/shared/agents/remote_agents.dart';
import 'package:buzz/shared/community/community.dart';
import 'package:buzz/shared/community/community_provider.dart';
import 'package:buzz/shared/crypto/nip_oa.dart';
import 'package:buzz/shared/hosted/account_identity_store.dart';
import 'package:buzz/shared/hosted/builderlab_account.dart';
import 'package:buzz/shared/hosted/hosted_environment.dart';
import 'package:buzz/shared/hosted/hosted_relay_auth.dart';
import 'package:buzz/shared/relay/relay.dart';
import 'package:buzz/shared/storage/secure_storage.dart';
import 'package:flutter_secure_storage/flutter_secure_storage.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:hooks_riverpod/hooks_riverpod.dart';
import 'package:nostr/nostr.dart' as nostr;
import 'package:shared_preferences/shared_preferences.dart';
import '../../helpers/remote_agents_fixture.dart';
final _scope = 'remote-agents:${HostedEnvironment.origin.host}:$fakeSubject';
/// Deterministic test keys.
nostr.Keys _keys(String last) => nostr.Keys('0' * 63 + last);
/// Starts signed out, like a cold start, until its saved session is restored.
class _RestoringRegistry extends FakeRegistry {
_RestoringRegistry() : super(signedIn: false);
@override
Future<BuilderlabAccount?> restore() async {
await Future<void>.delayed(Duration.zero);
signedIn = true;
return account;
}
}
Community _community({String? pubkey}) => Community.create(
name: 'Test',
relayUrl: 'wss://test.${HostedEnvironment.communitySuffix}',
pubkey: pubkey ?? fakeOwner.public,
nsec: fakeOwner.nsec,
);
Future<RelayFakeController> _controller(FakeRegistry registry) async {
await AccountIdentityStore().forSubject(fakeSubject).create(fakeOwner.nsec);
final controller = RelayFakeController(registry);
addTearDown(() {
controller.dispose();
controller.relayAuth.dispose();
registry.dispose();
});
return controller;
}
void main() {
TestWidgetsFlutterBinding.ensureInitialized();
// Registrations go to a real loopback relay. The binding's mocked HTTP
// client would reject the WebSocket upgrade.
HttpOverrides.global = null;
setUp(() {
FlutterSecureStorage.setMockInitialValues({});
SharedPreferences.setMockInitialValues({});
});
Future<(RelayFakeController, FakeRegistry)> editableAgent() async {
final registry = FakeRegistry(bound: fakeOwner.public);
registry.listed = [
{
'agent_pubkey': fakeAgent,
'agent_name': 'Scout',
'agent_id': 'agent',
'status': 2,
'model_id': 'old-model',
'reasoning_effort': 'low',
},
];
final controller = await _controller(registry);
await controller.run(controller.refresh);
return (controller, registry);
}
Future<bool> saveModel(
RelayFakeController controller, {
String effort = 'high',
bool current = true,
String? key,
}) async {
final model = (await controller.modelCatalog()).first;
return controller.updateModel(
community: _community(),
pubkey: key ?? fakeAgent,
model: model,
effort: effort,
isCurrent: () => current,
);
}
test(
'model changes save model and effort and confirm server readback',
() async {
final (controller, registry) = await editableAgent();
expect(await saveModel(controller), isTrue);
expect(registry.bodies['/v3/beekeeper/update-agent'], {
'agent_pubkey': fakeAgent,
'model_id': 'test-model',
'reasoning_effort': 'high',
});
expect(controller.agents.single['model_id'], 'test-model');
},
);
test(
'rejected model writes preserve the saved model and surface failure',
() async {
final (controller, registry) = await editableAgent();
registry.failInstructions = true;
expect(await saveModel(controller), isFalse);
expect(controller.agents.single['model_id'], 'old-model');
expect(controller.failure, contains('unavailable'));
},
);
test('unconfirmed model write does not report success', () async {
final (controller, registry) = await editableAgent();
registry.ignoreModelUpdate = true;
expect(await saveModel(controller), isFalse);
expect(controller.failure, contains('not confirmed'));
expect(controller.agents.single['model_id'], 'old-model');
});
test(
'model writes reject stale community, foreign agent and unsupported effort',
() async {
final (controller, registry) = await editableAgent();
expect(await saveModel(controller, current: false), isFalse);
expect(await saveModel(controller, key: 'a' * 64), isFalse);
expect(await saveModel(controller, effort: 'invalid'), isFalse);
expect(registry.calls, isNot(contains('update-agent')));
},
);
test(
'model writes require current account binding and community owner',
() async {
final (controller, registry) = await editableAgent();
registry.bound = 'a' * 64;
expect(await saveModel(controller), isFalse);
expect(registry.calls, isNot(contains('update-agent')));
},
);
test('model catalog rejects malformed reasoning choices', () async {
final (controller, registry) = await editableAgent();
registry.models = [
{'id': 'bad', 'display_name': 'Bad', 'supported_reasoning_efforts': []},
];
expect(controller.modelCatalog(), throwsStateError);
});
test(
'reconnect adopts only the server-bound saved community identity',
() async {
final raw = jsonEncode([
{'name': 'Pilot', 'nsec': fakeOwner.nsec, 'pubkey': fakeOwner.public},
{'name': 'Other', 'nsec': fakeAgentKeys.nsec, 'pubkey': fakeAgent},
]);
await communitySecureStorage.write(key: 'buzz_communities', value: raw);
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = RelayFakeController(registry);
addTearDown(() {
controller.dispose();
controller.relayAuth.dispose();
registry.dispose();
});
expect(await controller.run(controller.refresh), isTrue);
expect(controller.owner, fakeOwner.public);
expect(
(await AccountIdentityStore().forSubject(fakeSubject).read())?.pubkey,
fakeOwner.public,
);
expect(await communitySecureStorage.read(key: 'buzz_communities'), raw);
expect(registry.calls, ['list-agents']);
},
);
test(
'reconnect never adopts an unrelated device key or rebinds the account',
() async {
await communitySecureStorage.write(
key: 'buzz_communities',
value: jsonEncode([
{'name': 'Other', 'nsec': fakeAgentKeys.nsec, 'pubkey': fakeAgent},
]),
);
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = RelayFakeController(registry);
addTearDown(() {
controller.dispose();
controller.relayAuth.dispose();
registry.dispose();
});
expect(await controller.run(controller.refresh), isFalse);
expect(
await AccountIdentityStore().forSubject(fakeSubject).read(),
isNull,
);
expect(registry.calls, isEmpty);
expect(controller.failure, contains('absent'));
},
);
test('reconnect adopts a matching retained paired identity', () async {
await AccountIdentityStore()
.forPairing(fakeOwner.public)
.create(fakeOwner.nsec);
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = RelayFakeController(registry);
addTearDown(() {
controller.dispose();
controller.relayAuth.dispose();
registry.dispose();
});
expect(await controller.run(controller.refresh), isTrue);
expect(
(await AccountIdentityStore().forSubject(fakeSubject).read())?.pubkey,
fakeOwner.public,
);
expect(
(await AccountIdentityStore().forPairing(fakeOwner.public).read())
?.pubkey,
fakeOwner.public,
);
});
test(
'creation normalizes saved HTTPS community URLs for attestation',
() async {
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = await _controller(registry);
final community = Community.create(
name: 'Pilot',
relayUrl: 'https://test.${HostedEnvironment.communitySuffix}',
pubkey: fakeOwner.public,
nsec: fakeOwner.nsec,
);
expect(
await controller.create(
community,
'Tester',
modelId: 'test-model',
reasoningEffort: 'high',
),
isTrue,
);
expect(
registry.bodies['/v3/beekeeper/attest-agent']?['community_url'],
'wss://test.${HostedEnvironment.communitySuffix}',
);
expect(
registry.calls.where((call) => call == 'register-agent'),
hasLength(1),
);
},
);
test('model setup requires a catalog-confirmed selection', () async {
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = await _controller(registry);
expect(await controller.create(_community(), 'Scout'), isFalse);
expect(controller.pending, isNull);
expect(registry.calls, isEmpty);
expect(controller.failure, 'Choose a model and reasoning effort.');
expect(
await controller.create(
_community(),
'Scout',
modelId: 'test-model',
reasoningEffort: 'max',
),
isFalse,
);
expect(registry.calls, ['get-model-catalog']);
expect(controller.pending, isNull);
final catalog = await controller.modelCatalog();
expect(catalog.first.id, 'test-model');
expect(catalog.last.efforts, ['max']);
});
test('remote agents follow the build-time Builderlab gate', () {
expect(supportsRemoteAgents(_community()), HostedEnvironment.enabled);
expect(supportsRemoteAgents(null), isFalse);
final selfHosted = Community.create(
name: 'Self hosted',
relayUrl: 'wss://relay.example.com',
pubkey: fakeOwner.public,
);
expect(supportsRemoteAgents(selfHosted), isFalse);
});
test('every remote agent surface waits for Builderlab sign-in', () async {
final registry = FakeRegistry(signedIn: false);
addTearDown(registry.dispose);
final container = ProviderContainer(
overrides: [
builderlabAccountProvider.overrideWithValue(registry),
activeCommunityProvider.overrideWith((ref) async => _community()),
],
);
addTearDown(container.dispose);
await container.read(activeCommunityProvider.future);
expect(container.read(remoteAgentsEnabledProvider), isFalse);
registry.signedIn = true;
expect(
container.read(remoteAgentsEnabledProvider),
HostedEnvironment.enabled,
);
// A community refresh keeps the surfaces open on the previous value.
container.invalidate(activeCommunityProvider, asReload: true);
expect(container.read(activeCommunityProvider).isLoading, isTrue);
expect(
container.read(remoteAgentsEnabledProvider),
HostedEnvironment.enabled,
);
registry.signedIn = false;
expect(container.read(remoteAgentsEnabledProvider), isFalse);
});
test('a saved Builderlab session is restored on cold start', () async {
final registry = _RestoringRegistry();
addTearDown(registry.dispose);
final container = ProviderContainer(
overrides: [builderlabAccountProvider.overrideWithValue(registry)],
);
addTearDown(container.dispose);
expect(container.read(builderlabSignedInProvider), isFalse);
// Nothing else restores the account; the gate itself must.
await Future<void>.delayed(Duration.zero);
expect(
container.read(builderlabSignedInProvider),
HostedEnvironment.enabled,
);
});
test('a failed listing is reported instead of an empty registry', () async {
final registry = FakeRegistry(bound: fakeOwner.public)..failListing = true;
final controller = await _controller(registry);
expect(await controller.run(controller.refresh), isFalse);
expect(controller.listingFailed, isTrue);
registry.failListing = false;
expect(await controller.run(controller.refresh), isTrue);
expect(controller.listingFailed, isFalse);
});
test('listing requires a signed-in account bound to the saved key', () async {
final registry = FakeRegistry(bound: fakeOwner.public, signedIn: false);
final controller = await _controller(registry);
registry.listed = [
{
'agent_pubkey': fakeAgent,
'agent_name': 'Scout',
'status': 'BEEKEEPER_AGENT_STATUS_ACTIVE',
},
];
expect(await controller.run(controller.refresh), isTrue);
expect(registry.calls, isEmpty);
expect(controller.activeAgents, isEmpty);
expect(controller.failure, isEmpty);
registry
..signedIn = true
..bound = nostr.Keys('0' * 63 + '3').public;
expect(await controller.run(controller.refresh), isFalse);
expect(registry.calls, isEmpty);
expect(controller.failure, 'Buzz identity: mismatch.');
registry.bound = fakeOwner.public;
expect(await controller.run(controller.refresh), isTrue);
expect(registry.calls, ['list-agents']);
expect(controller.owner, fakeOwner.public);
expect(controller.activeAgents, {fakeAgent});
registry.signedIn = false;
expect(controller.activeAgents, isEmpty);
});
test(
'failed setup resumes the same identity; instructions stay private',
() async {
final registry = FakeRegistry(bound: fakeOwner.public)
..failInstructions = true;
final controller = await _controller(registry);
final community = _community();
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'x' * 20001,
),
isFalse,
);
expect(
await controller.create(
_community(pubkey: 'f' * 64),
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
),
isFalse,
);
expect(registry.calls, isEmpty);
expect(controller.pending, isNull);
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'Reply concisely.',
pictureUrl: 'https://example.com/avatar.png',
),
isFalse,
);
expect(registry.calls, [
'get-model-catalog',
'register-agent',
'attest-agent',
'update-agent',
]);
expect(controller.pending?['pubkey'], fakeAgent);
expect(controller.pending?['picture'], 'https://example.com/avatar.png');
expect(
registry.bodies['/v3/beekeeper/register-agent']?['agent_picture_url'],
'https://example.com/avatar.png',
);
final prefs = await SharedPreferences.getInstance();
expect(prefs.getString('$_scope:pending'), isNotNull);
expect(
prefs.getString('$_scope:pending'),
isNot(contains('Reply concisely.')),
);
// A fresh controller restores the pending setup from storage.
final resumed = RelayFakeController(registry);
addTearDown(() {
resumed.dispose();
resumed.relayAuth.dispose();
});
registry
..failInstructions = false
..calls.clear();
expect(
await resumed.create(community, 'Other', instructions: 'Other'),
isTrue,
);
expect(registry.calls, [
'get-model-catalog',
'attest-agent',
'update-agent',
'publish-policy',
'list-agents',
]);
expect(
registry.bodies['/v3/beekeeper/update-agent']?['agent_instructions'],
'Reply concisely.',
);
expect(
registry.bodies['/v3/beekeeper/attest-agent']?['community_url'],
community.relayUrl,
);
expect(registry.calls, isNot(contains('add-buzz-subscription')));
expect(
registry.bodies['/v3/beekeeper/update-agent']?['model_id'],
'test-model',
);
expect(
registry.bodies['/v3/beekeeper/update-agent']?['reasoning_effort'],
'high',
);
expect(resumed.pending, isNull);
expect(prefs.getString('$_scope:pending'), isNull);
},
);
test(
'deletion requires confirmed registration absence; disabled stays retryable',
() async {
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = await _controller(registry);
registry.listed = [
{'agent_pubkey': fakeAgent, 'agent_id': 'remote-id'},
];
await controller.run(controller.refresh);
registry.calls.clear();
var registrationExists = true;
var current = true;
Future<bool> remove() => controller.deleteAgent(
pubkey: fakeAgent,
community: _community(),
isCurrent: () => current,
fetch: (filter) async {
registry.calls.add('read-registration');
expect(filter.kinds, [30177]);
expect(filter.authors, [fakeOwner.public]);
expect(filter.tags, {
'#d': [fakeAgent],
});
return registrationExists
? [
NostrEvent(
id: 'registration',
pubkey: fakeOwner.public,
createdAt: 1,
kind: 30177,
tags: [
['d', fakeAgent],
],
content: '{}',
sig: '',
),
]
: [];
},
);
controller.rejectRemoval = true;
expect(await remove(), isFalse);
expect(registry.calls, ['remove-registration']);
registry.calls.clear();
controller.rejectRemoval = false;
expect(await remove(), isFalse);
expect(registry.calls, ['remove-registration', 'read-registration']);
registry
..calls.clear()
..deleteStatus = 2;
registrationExists = false;
expect(await remove(), isFalse);
expect(controller.failure, contains('disabled'));
expect(controller.agents, hasLength(1));
// The relay registration is gone, but the listing keeps a retry row.
registry.listed = [];
await controller.run(controller.refresh);
expect(controller.agents.single['agent_id'], 'remote-id');
registry.calls.clear();
current = false;
expect(await remove(), isFalse);
expect(registry.calls, isEmpty);
current = true;
registry.deleteStatus = 'DELETE_AGENT_STATUS_NOT_FOUND';
expect(await remove(), isTrue);
expect(registry.calls.last, 'delete-agent');
expect(controller.agents, isEmpty);
expect(controller.deletedAgents, {fakeAgent});
await controller.run(controller.refresh);
expect(controller.agents, isEmpty);
},
);
test('a setup whose instructions were lost asks for them again', () async {
final registry = FakeRegistry(bound: fakeOwner.public)
..failInstructions = true;
final controller = await _controller(registry);
final community = _community();
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'Private.',
),
isFalse,
);
final request = controller.pending!['request'];
// Device-only secure storage is gone; preferences survived (a restore).
await accountSecureStorage.delete(key: '$_scope:instructions:$request');
final restarted = RelayFakeController(registry);
addTearDown(() {
restarted.dispose();
restarted.relayAuth.dispose();
});
expect(await restarted.run(restarted.refresh), isTrue);
expect(restarted.pending?['instructionsMissing'], isTrue);
registry
..failInstructions = false
..calls.clear();
expect(
await restarted.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'Again.',
),
isTrue,
);
expect(
registry.bodies['/v3/beekeeper/update-agent']?['agent_instructions'],
'Again.',
);
expect(restarted.pending, isNull);
final prefs = await SharedPreferences.getInstance();
expect(prefs.getString('$_scope:pending'), isNull);
});
test(
'registrations use a WebSocket URL for https-saved communities',
() async {
final server = await HttpServer.bind(InternetAddress.loopbackIPv4, 0);
addTearDown(() => server.close(force: true));
final kinds = <int>[];
final registrations = <Map<String, dynamic>>[];
final published = <NostrEvent>[];
server.listen((request) async {
final peer = await WebSocketTransformer.upgrade(request);
addTearDown(peer.close);
peer.listen((frame) {
final data = jsonDecode(frame as String) as List;
final event = Map<String, dynamic>.from(data[1] as Map);
if (data.first == 'EVENT') {
kinds.add(event['kind'] as int);
if (event['kind'] == 30177) {
registrations.add(
jsonDecode(event['content'] as String) as Map<String, dynamic>,
);
}
published.add(NostrEvent.fromJson(event));
}
peer.add(jsonEncode(['OK', event['id'], true, '']));
});
peer.add(jsonEncode(['AUTH', 'challenge']));
});
final registry = FakeRegistry(bound: fakeOwner.public);
await AccountIdentityStore()
.forSubject(fakeSubject)
.create(fakeOwner.nsec);
final controller = RemoteAgentController(
account: registry,
keys: AccountIdentityStore(),
relayAuth: HostedRelayAuth(registry),
);
addTearDown(() {
controller.dispose();
controller.relayAuth.dispose();
});
// Stored the way paired communities may keep it: an HTTP(S) origin.
final relay = 'http://127.0.0.1:${server.port}';
await controller.publishPolicy(relay, {
'pubkey': fakeAgent,
'name': 'Scout',
'picture': 'https://example.com/avatar.png',
});
expect(registrations.single['picture'], 'https://example.com/avatar.png');
await controller.removePolicy(relay, fakeAgent);
expect(kinds, [30177, 5]);
},
);
test('a setup without a server identity can be discarded', () async {
final registry = FakeRegistry(bound: fakeOwner.public)
..rejectRegistration = true;
final controller = await _controller(registry);
final community = _community();
final prefs = await SharedPreferences.getInstance();
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'Private.',
),
isFalse,
);
expect(controller.failure, contains('NAME_TAKEN'));
expect(controller.canDiscardPending, isTrue);
// An HTTP rejection is just as definite.
registry
..rejectRegistration = false
..refuseRegistration = true;
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
),
isFalse,
);
expect(controller.failure, contains('rejected'));
expect(controller.canDiscardPending, isTrue);
final request = controller.pending!['request'];
expect(prefs.getString('$_scope:pending'), isNotNull);
expect(await controller.discardPending(), isTrue);
expect(controller.pending, isNull);
expect(prefs.getString('$_scope:pending'), isNull);
expect(
await accountSecureStorage.read(key: '$_scope:instructions:$request'),
isNull,
);
// A lost response may hide a committed identity, so it can only resume.
registry
..refuseRegistration = false
..loseRegistration = true;
expect(
await controller.create(
community,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
instructions: 'Private.',
),
isFalse,
);
expect(controller.pending?['pubkey'], isNull);
expect(controller.canDiscardPending, isFalse);
expect(await controller.discardPending(), isFalse);
final lost = controller.pending!['request'];
expect(jsonDecode(prefs.getString('$_scope:pending')!)['request'], lost);
// Until the identity is known, any listed agent could be the lost one.
final other = _keys('3').public;
registry.listed = [
...registry.listed,
{'agent_pubkey': other, 'agent_id': 'remote-id'},
];
await controller.run(controller.refresh);
final elsewhere = Community.create(
name: 'Other',
relayUrl: 'wss://other.${HostedEnvironment.communitySuffix}',
pubkey: fakeOwner.public,
nsec: fakeOwner.nsec,
);
Future<bool> remove(String pubkey) => controller.deleteAgent(
pubkey: pubkey,
community: elsewhere,
isCurrent: () => true,
fetch: (_) async => [],
);
expect(await remove(other), isFalse);
expect(controller.failure, contains('Resume the unfinished setup'));
// Resume from another community reuses the idempotency key and recovers
// the same identity; finishing it still needs the original community.
registry
..loseRegistration = false
..bodies.clear();
expect(
await controller.create(
elsewhere,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
),
isFalse,
);
expect(controller.failure, contains('Agent identity recovered'));
expect(
registry.bodies['/v3/beekeeper/register-agent']?['idempotency_key'],
lost,
);
registry.bodies.clear();
expect(
await controller.create(
elsewhere,
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
),
isFalse,
);
expect(controller.failure, contains('original community'));
expect(registry.bodies, isEmpty);
expect(controller.pending?['pubkey'], fakeAgent);
expect(await controller.discardPending(), isFalse);
expect(controller.pending?['pubkey'], fakeAgent);
// Once known, the unfinished setup blocks deleting only its own agent.
expect(await remove(fakeAgent), isFalse);
expect(controller.failure, contains('Resume the unfinished setup'));
expect(await remove(other), isTrue);
expect(controller.deletedAgents, {other});
expect(controller.pending?['pubkey'], fakeAgent);
expect(prefs.getString('$_scope:pending'), isNotNull);
});
test('another account never sees the previous registry', () async {
final registry = FakeRegistry(bound: fakeOwner.public);
final controller = await _controller(registry);
registry.listed = [
{
'agent_pubkey': fakeAgent,
'agent_name': 'Scout',
'status': 'BEEKEEPER_AGENT_STATUS_ACTIVE',
},
];
await controller.run(controller.refresh);
expect(controller.activeAgents, {fakeAgent});
var notified = 0;
controller.addListener(() => notified++);
registry.subject = 'other-owner';
expect(notified, 1);
expect(controller.activeAgents, isEmpty);
// The other account has no saved key, so its registry is never listed.
expect(await controller.run(controller.refresh), isFalse);
expect(controller.agents, isEmpty);
expect(controller.owner, isNull);
});
test('a failed registry load retries on the next load', () async {
final registry = FakeRegistry(bound: 'f' * 64);
final controller = await _controller(registry);
final relay = _community().relayUrl;
await controller.load(relay);
expect(controller.failure, 'Buzz identity: mismatch.');
registry.bound = fakeOwner.public;
await controller.load(relay);
expect(registry.calls, ['list-agents']);
await controller.load(relay);
expect(registry.calls, ['list-agents']);
});
test(
'availability requires an owned profile and a live registration',
() async {
String key(String last) => _keys(last).public;
final other = key('3');
final elsewhere = key('5');
final forged = signedAgentProfile(_keys('8'), fakeOwner).toJson()
..['sig'] = '0' * 128;
final profiles = [
signedAgentProfile(fakeAgentKeys, fakeOwner),
// Attested by someone else, so not this owner's agent.
signedAgentProfile(_keys('3'), _keys('4')),
// Signed conditions that exclude this profile, and a forged envelope.
signedAgentProfile(_keys('6'), fakeOwner, conditions: 'kind=1'),
signedAgentProfile(_keys('7'), fakeOwner, conditions: 'created_at<50'),
NostrEvent.fromJson(forged),
];
var registrations = <NostrEvent>[];
Future<List<NostrEvent>> fetch(NostrFilter filter) async {
if (filter.kinds.single == 0) return profiles;
expect(filter.kinds, [30177]);
expect(filter.authors, [fakeOwner.public]);
expect(filter.tags, {
'#d': [fakeAgent],
});
return registrations;
}
final keys = {fakeAgent, other, elsewhere, key('6'), key('7'), key('8')};
// The list keeps owned agents, so an interrupted delete stays retryable.
expect(await ownedCommunityAgents(keys, fakeOwner.public, fetch), {
fakeAgent,
});
expect(await liveCommunityAgents(keys, fakeOwner.public, fetch), isEmpty);
registrations = [_registration(fakeAgent)];
expect(await liveCommunityAgents(keys, fakeOwner.public, fetch), {
fakeAgent,
});
expect(await liveCommunityAgents(keys, null, fetch), isEmpty);
},
);
test('presence stays local until the agent registration is live', () async {
final registry = FakeRegistry(bound: fakeOwner.public)
..listed = [
{
'agent_pubkey': fakeAgent,
'agent_id': 'remote-id',
'status': 'BEEKEEPER_AGENT_STATUS_ACTIVE',
},
];
final controller = await _controller(registry);
final relay = _AgentRelay();
final container = ProviderContainer(
overrides: [
presenceCacheProvider.overrideWith(_AgentPresence.new),
activeCommunityProvider.overrideWith((ref) async => _community()),
remoteAgentControllerProvider.overrideWithValue(controller),
relaySessionProvider.overrideWith(() => relay),
],
);
addTearDown(container.dispose);
await container.read(activeCommunityProvider.future);
await controller.run(controller.refresh);
expect(await container.read(availableRemoteAgentsProvider.future), isEmpty);
expect(container.read(presentedPresenceProvider)[fakeAgent], 'offline');
relay.live = true;
container.invalidate(availableRemoteAgentsProvider);
expect(await container.read(availableRemoteAgentsProvider.future), {
fakeAgent,
});
expect(container.read(presentedPresenceProvider)[fakeAgent], 'online');
// Removing the registration hides it even when the runtime stays ACTIVE.
registry.deleteStatus = 2;
relay.live = false;
expect(
await controller.deleteAgent(
pubkey: fakeAgent,
community: _community(),
isCurrent: () => true,
fetch: (_) async => [],
),
isFalse,
);
expect(controller.activeAgents, {fakeAgent});
expect(await container.read(availableRemoteAgentsProvider.future), isEmpty);
expect(container.read(presentedPresenceProvider)[fakeAgent], 'offline');
// Publishing a registration for the still-ACTIVE agent shows it again.
relay.live = true;
expect(
await controller.create(
_community(),
'Scout',
modelId: 'test-model',
reasoningEffort: 'high',
),
isTrue,
);
expect(controller.activeAgents, {fakeAgent});
expect(await container.read(availableRemoteAgentsProvider.future), {
fakeAgent,
});
expect(container.read(presentedPresenceProvider)[fakeAgent], 'online');
}, skip: !HostedEnvironment.enabled);
test('owner proof verifies for only the provisioned agent key', () {
final other = nostr.Keys('0' * 63 + '3');
final auth = signOwnerAuthorization(fakeOwner, fakeAgent);
expect(verifiedOaOwnerPubkey([auth], fakeAgent), fakeOwner.public);
expect(verifiedOaOwnerPubkey([auth], other.public), isNull);
expect(
() => signOwnerAuthorization(fakeOwner, fakeOwner.public),
throwsStateError,
);
});
test('disabled and missing statuses cannot count as activation', () {
requireStatus({'status': 'ATTEST_AGENT_STATUS_ACTIVE'}, 'ACTIVE', 1);
requireStatus({'status': 1}, 'ACTIVE', 1);
for (final result in [
{'status': 'ATTEST_AGENT_STATUS_FEATURE_DISABLED'},
<String, dynamic>{},
]) {
expect(() => requireStatus(result, 'ACTIVE', 1), throwsStateError);
}
});
test(
'remote availability shows Online without changing local presence',
() async {
final container = ProviderContainer(
overrides: [
presenceCacheProvider.overrideWith(_Presence.new),
availableRemoteAgentsProvider.overrideWith((ref) async => {'remote'}),
],
);
addTearDown(container.dispose);
await container.read(availableRemoteAgentsProvider.future);
expect(container.read(presentedPresenceProvider), {
'remote': 'online',
'local': 'away',
});
expect(container.read(presenceCacheProvider)['remote'], 'offline');
},
);
}
class _Presence extends PresenceCacheNotifier {
@override
Map<String, String> build() => {'remote': 'offline', 'local': 'away'};
}
class _AgentPresence extends PresenceCacheNotifier {
@override
Map<String, String> build() => {fakeAgent: 'offline'};
}
NostrEvent _registration(String agent) => NostrEvent(
id: 'registration-$agent',
pubkey: fakeOwner.public,
createdAt: 1,
kind: 30177,
tags: [
['d', agent],
],
content: '{}',
sig: '',
);
/// Serves the owner's agent profile, and its registration once [live].
class _AgentRelay extends RelaySessionNotifier {
bool live = false;
@override
SessionState build() => const SessionState(status: SessionStatus.connected);
@override
Future<List<NostrEvent>> fetchHistory(
NostrFilter filter, {
Duration timeout = const Duration(seconds: 8),
}) async => switch (filter.kinds.single) {
0 => [signedAgentProfile(fakeAgentKeys, fakeOwner)],
30177 when live => [_registration(fakeAgent)],
_ => [],
};
}