`;
for (const c of agentContracts) {
const other = c.from === agentId
? AGENTS.find(a => a.id === c.to)
: AGENTS.find(a => a.id === c.from);
- const dir = c.from === agentId ? '->' : '<-';
- html += `
`;
- html += `
[${escapeHtml(c.type.toUpperCase().replace('_', ' '))}]`;
- html += `
${dir} ${escapeHtml(other ? other.name : '?')} ${escapeHtml(c.amount)} ${escapeHtml(c.currency)}`;
+ const direction = c.direction === 'outgoing' ? '->' : '<-';
+ const directionLabel = c.direction === 'outgoing' ? 'OUTGOING' : 'INCOMING';
+ const typeBackground = CONTRACT_STYLES_CSS[c.type] || 'rgba(100,136,100,0.15)';
+ html += `
`;
+ html += `
`;
+ html += `
`;
+ html += `
`;
+ html += `[${escapeHtml(c.type.toUpperCase().replaceAll('_', ' '))}]`;
+ html += `${direction} ${escapeHtml(other ? other.name : '?')}`;
html += `${escapeHtml(c.state)}`;
html += `
`;
+ html += `
`;
+ html += `${escapeHtml(directionLabel)}`;
+ html += `${escapeHtml(c.amount)} ${escapeHtml(c.currency)}`;
+ html += `TERM ${escapeHtml(c.term || '?')}`;
+ html += `ID ${escapeHtml(c.id)}`;
+ html += `
`;
+ html += `
`;
}
+ html += `
`;
+ } else {
+ html += `
No contracts recorded for this agent.
`;
}
// Source badges
diff --git a/tests/beacon_contract_history.test.mjs b/tests/beacon_contract_history.test.mjs
new file mode 100644
index 000000000..750253a18
--- /dev/null
+++ b/tests/beacon_contract_history.test.mjs
@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: MIT
+
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+import {
+ buildContractHistory,
+ contractTimeMillis,
+ contractTimestampIso,
+ formatContractTimestamp,
+} from '../site/beacon/contract-history.mjs';
+
+test('buildContractHistory filters both directions and sorts newest first', () => {
+ const history = buildContractHistory([
+ {
+ id: 'ctr-old-incoming', from: 'bcn_bob', to: 'bcn_alice',
+ type: 'rent', amount: 4, currency: 'RTC', term: '7d',
+ state: 'completed', created_at: 1_700_000_000,
+ },
+ {
+ id: 'ctr-unrelated', from: 'bcn_carol', to: 'bcn_dan',
+ type: 'buy', amount: 9, currency: 'RTC', term: 'once',
+ state: 'active', created_at: 1_900_000_000,
+ },
+ {
+ id: 'ctr-new-outgoing', from: 'bcn_alice', to: 'bcn_carol',
+ type: 'bounty', amount: 15, currency: 'RTC', term: '14d',
+ state: 'active', created_at: 1_800_000_000,
+ },
+ ], 'bcn_alice');
+
+ assert.deepEqual(history.map(contract => contract.id), [
+ 'ctr-new-outgoing',
+ 'ctr-old-incoming',
+ ]);
+ assert.deepEqual(
+ history.map(({ direction, counterpartyId }) => ({ direction, counterpartyId })),
+ [
+ { direction: 'outgoing', counterpartyId: 'bcn_carol' },
+ { direction: 'incoming', counterpartyId: 'bcn_bob' },
+ ],
+ );
+});
+
+test('buildContractHistory is deterministic for tied and unknown timestamps', () => {
+ const contracts = [
+ { id: 'ctr-z', from: 'bcn_alice', to: 'bcn_zed', created_at: null },
+ { id: 'ctr-b', from: 'bcn_alice', to: 'bcn_bob', created_at: 1_700_000_000 },
+ { id: 'ctr-a', from: 'bcn_ann', to: 'bcn_alice', created_at: 1_700_000_000 },
+ ];
+
+ assert.deepEqual(
+ buildContractHistory(contracts, 'bcn_alice').map(contract => contract.id),
+ ['ctr-a', 'ctr-b', 'ctr-z'],
+ );
+ assert.deepEqual(buildContractHistory([...contracts].reverse(), 'bcn_alice').map(contract => contract.id), [
+ 'ctr-a', 'ctr-b', 'ctr-z',
+ ]);
+});
+
+test('contract timestamps accept API seconds, milliseconds, and ISO text', () => {
+ const expectedMilliseconds = 1_700_000_000_000;
+ assert.equal(contractTimeMillis(1_700_000_000), expectedMilliseconds);
+ assert.equal(contractTimeMillis(expectedMilliseconds), expectedMilliseconds);
+ assert.equal(contractTimeMillis('2023-11-14T22:13:20Z'), expectedMilliseconds);
+ assert.equal(contractTimestampIso(1_700_000_000), '2023-11-14T22:13:20.000Z');
+ assert.equal(formatContractTimestamp(1_700_000_000), '2023-11-14 22:13:20 UTC');
+});
+
+test('invalid inputs fail closed without breaking the selected-agent panel', () => {
+ assert.equal(contractTimeMillis('not-a-date'), null);
+ assert.equal(contractTimestampIso(null), '');
+ assert.equal(formatContractTimestamp(undefined), 'TIME UNKNOWN');
+ assert.deepEqual(buildContractHistory(null, 'bcn_alice'), []);
+ assert.deepEqual(buildContractHistory([], ''), []);
+});
diff --git a/tests/test_beacon_contract_history_ui.py b/tests/test_beacon_contract_history_ui.py
new file mode 100644
index 000000000..c01ca5e05
--- /dev/null
+++ b/tests/test_beacon_contract_history_ui.py
@@ -0,0 +1,49 @@
+# SPDX-License-Identifier: MIT
+import unittest
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+UI_JS = ROOT / "site" / "beacon" / "ui.js"
+STYLES = ROOT / "site" / "beacon" / "styles.css"
+
+
+class TestBeaconContractHistoryUI(unittest.TestCase):
+ def test_selected_agent_panel_renders_complete_timeline_fields(self):
+ source = UI_JS.read_text(encoding="utf-8")
+
+ self.assertIn(
+ "import { buildContractHistory, formatContractTimestamp } "
+ "from './contract-history.mjs';",
+ source,
+ )
+ self.assertIn("buildContractHistory(CONTRACTS, agentId)", source)
+ self.assertIn("-- CONTRACT HISTORY (${agentContracts.length}) --", source)
+ self.assertIn('class="contract-timeline" role="list"', source)
+ self.assertIn("formatContractTimestamp(c.created_at)", source)
+ self.assertIn("direction-${escapeHtml(c.direction)}", source)
+ self.assertIn("state-${escapeHtml(c.state)}", source)
+ self.assertIn("${escapeHtml(c.amount)} ${escapeHtml(c.currency)}", source)
+ self.assertIn("TERM ${escapeHtml(c.term || '?')}", source)
+ self.assertIn("ID ${escapeHtml(c.id)}", source)
+ self.assertIn("No contracts recorded for this agent.", source)
+
+ def test_timeline_styles_cover_layout_and_terminal_states(self):
+ source = STYLES.read_text(encoding="utf-8")
+
+ for selector in (
+ ".contract-timeline",
+ ".contract-timeline-item",
+ ".contract-timeline-marker",
+ ".contract-timeline-time",
+ ".contract-timeline-details",
+ ".direction-outgoing",
+ ".direction-incoming",
+ ".state-completed",
+ ".state-rejected",
+ ):
+ self.assertIn(selector, source)
+
+
+if __name__ == "__main__":
+ unittest.main()