@agentunion/fastaun 0.5.26 → 0.5.28
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +77 -0
- package/_packed_docs/CHANGELOG.md +77 -0
- package/_packed_docs/INDEX.md +37 -14
- package/_packed_docs/KITE_DOCS_GUIDE.md +23 -15
- package/_packed_docs/aun/345/210/206/345/270/203/345/274/217/346/265/213/350/257/225/350/277/220/350/241/214/346/214/207/345/215/227.md +16 -1
- package/_packed_docs/aun/346/265/213/350/257/225/350/277/220/350/241/214/346/214/207/345/215/227.md +37 -9
- package/_packed_docs/cli/AUN-CLI/350/256/276/350/256/241/346/226/207/346/241/243.md +20 -9
- package/_packed_docs/cli/CLI/346/211/213/345/206/214.md +57 -12
- package/_packed_docs/sdk/0.5.22-SDK/345/274/200/345/217/221/344/270/216/347/247/273/346/244/215/346/214/207/345/215/227.md +2 -2
- package/_packed_docs/sdk/06-API/346/211/213/345/206/214.md +2 -2
- package/_packed_docs/sdk/09-/345/207/255/350/257/201/346/234/215/345/212/241RPC/346/211/213/345/206/214.md +187 -73
- package/_packed_docs/sdk/09-/347/273/204/347/273/207/346/234/215/345/212/241RPC/346/211/213/345/206/214.md +1 -1
- package/_packed_docs/sdk/AUN_DOCS_GUIDE.md +13 -9
- package/_packed_docs/sdk/INDEX.md +23 -13
- package/_packed_docs/sdk//345/207/255/350/257/201/344/270/216/347/273/204/347/273/207/346/234/215/345/212/241SDK/345/272/224/347/224/250/351/233/206/346/210/220/346/214/207/345/215/227.md +973 -266
- package/_packed_docs/sdk//345/207/255/350/257/201/344/270/216/347/273/204/347/273/207/346/234/215/345/212/241SDK/345/274/200/345/217/221/344/270/216/347/247/273/346/244/215/346/214/207/345/215/227.md +950 -242
- package/dist/agent-md-changes.d.ts +42 -0
- package/dist/agent-md-changes.js +339 -0
- package/dist/agent-md-changes.js.map +1 -0
- package/dist/agent-md-schema.d.ts +1 -0
- package/dist/agent-md-schema.js +31 -14
- package/dist/agent-md-schema.js.map +1 -1
- package/dist/agent-md.d.ts +11 -0
- package/dist/agent-md.js +91 -15
- package/dist/agent-md.js.map +1 -1
- package/dist/aid-store.d.ts +11 -0
- package/dist/aid-store.js +102 -21
- package/dist/aid-store.js.map +1 -1
- package/dist/aid.js +3 -3
- package/dist/aid.js.map +1 -1
- package/dist/auth.d.ts +10 -0
- package/dist/auth.js +65 -23
- package/dist/auth.js.map +1 -1
- package/dist/cert-utils.d.ts +1 -1
- package/dist/cert-utils.js +4 -4
- package/dist/cert-utils.js.map +1 -1
- package/dist/client/control-messages.d.ts +31 -0
- package/dist/client/control-messages.js +474 -0
- package/dist/client/control-messages.js.map +1 -0
- package/dist/client/delivery.js +10 -2
- package/dist/client/delivery.js.map +1 -1
- package/dist/client/lifecycle.d.ts +1 -1
- package/dist/client/lifecycle.js +10 -0
- package/dist/client/lifecycle.js.map +1 -1
- package/dist/client/rpc-pipeline.js +84 -14
- package/dist/client/rpc-pipeline.js.map +1 -1
- package/dist/client/v2-e2ee.d.ts +3 -0
- package/dist/client/v2-e2ee.js +12 -0
- package/dist/client/v2-e2ee.js.map +1 -1
- package/dist/client.d.ts +38 -0
- package/dist/client.js +572 -36
- package/dist/client.js.map +1 -1
- package/dist/discovery.d.ts +3 -0
- package/dist/discovery.js +52 -2
- package/dist/discovery.js.map +1 -1
- package/dist/events.js +14 -1
- package/dist/events.js.map +1 -1
- package/dist/facades.d.ts +38 -0
- package/dist/facades.js +49 -5
- package/dist/facades.js.map +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.js +3 -0
- package/dist/index.js.map +1 -1
- package/dist/org-protocol.d.ts +1 -0
- package/dist/org-protocol.js +39 -36
- package/dist/org-protocol.js.map +1 -1
- package/dist/ownership-v21.js +7 -7
- package/dist/ownership-v21.js.map +1 -1
- package/dist/register-flow.js +2 -2
- package/dist/register-flow.js.map +1 -1
- package/dist/risk-control.d.ts +68 -0
- package/dist/risk-control.js +344 -0
- package/dist/risk-control.js.map +1 -0
- package/dist/semantic-facade.d.ts +176 -0
- package/dist/semantic-facade.js +611 -0
- package/dist/semantic-facade.js.map +1 -0
- package/dist/semantic-protocol.d.ts +810 -0
- package/dist/semantic-protocol.js +894 -0
- package/dist/semantic-protocol.js.map +1 -0
- package/dist/storage/lowlevel.d.ts +1 -0
- package/dist/storage/lowlevel.js +2 -2
- package/dist/storage/lowlevel.js.map +1 -1
- package/dist/tools/cross-sdk-agent.d.ts +11 -1
- package/dist/tools/cross-sdk-agent.js +388 -7
- package/dist/tools/cross-sdk-agent.js.map +1 -1
- package/dist/transport.d.ts +22 -1
- package/dist/transport.js +227 -22
- package/dist/transport.js.map +1 -1
- package/dist/v2/e2ee/decrypt.d.ts +5 -0
- package/dist/v2/e2ee/decrypt.js +22 -2
- package/dist/v2/e2ee/decrypt.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,344 @@
|
|
|
1
|
+
import { p256 } from '@noble/curves/nist.js';
|
|
2
|
+
import { StateError } from './errors.js';
|
|
3
|
+
import { canonicalJson } from './v2/crypto/canonical.js';
|
|
4
|
+
function object(value) { return value !== null && typeof value === 'object' && !Array.isArray(value); }
|
|
5
|
+
function integer(value) { return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0; }
|
|
6
|
+
function decodeBase64Url(value, length) {
|
|
7
|
+
if (!/^[A-Za-z0-9_-]+$/.test(value))
|
|
8
|
+
throw new Error('risk signature encoding invalid');
|
|
9
|
+
const bytes = Uint8Array.from(atob(value.replace(/-/g, '+').replace(/_/g, '/') + '='.repeat((4 - value.length % 4) % 4)), (char) => char.charCodeAt(0));
|
|
10
|
+
if (bytes.length !== length || btoa(String.fromCharCode(...bytes)).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '') !== value)
|
|
11
|
+
throw new Error('risk signature encoding invalid');
|
|
12
|
+
return bytes;
|
|
13
|
+
}
|
|
14
|
+
function validatePublicKey(publicKey) {
|
|
15
|
+
if (publicKey.length !== 65 || publicKey[0] !== 4)
|
|
16
|
+
throw new Error('risk signing key invalid');
|
|
17
|
+
p256.Point.fromBytes(publicKey).assertValidity();
|
|
18
|
+
}
|
|
19
|
+
function stableJson(value) { return new TextDecoder().decode(canonicalJson(value)); }
|
|
20
|
+
function scopeMatches(scope, request) {
|
|
21
|
+
if (!Array.isArray(scope))
|
|
22
|
+
return false;
|
|
23
|
+
return scope.some((item) => typeof item === 'string' && (item === request || (item.endsWith('*') && request.startsWith(item.slice(0, -1)))));
|
|
24
|
+
}
|
|
25
|
+
function validateIntegers(value) {
|
|
26
|
+
if (typeof value === 'number' && !Number.isSafeInteger(value))
|
|
27
|
+
throw new Error('risk integer required');
|
|
28
|
+
if (Array.isArray(value))
|
|
29
|
+
value.forEach(validateIntegers);
|
|
30
|
+
else if (object(value))
|
|
31
|
+
Object.values(value).forEach(validateIntegers);
|
|
32
|
+
}
|
|
33
|
+
function validScope(value) {
|
|
34
|
+
return Array.isArray(value) && value.length > 0 && value.every((scope) => typeof scope === 'string' && /^(rpc|http):(?:\*|[A-Za-z][A-Za-z0-9_./:-]*(?:\*)?)$/.test(scope));
|
|
35
|
+
}
|
|
36
|
+
export class RiskController {
|
|
37
|
+
options;
|
|
38
|
+
target = null;
|
|
39
|
+
keyId = '';
|
|
40
|
+
publicKey = new Uint8Array();
|
|
41
|
+
serverTime = 0;
|
|
42
|
+
configuredAt = 0;
|
|
43
|
+
snapshots = new Map();
|
|
44
|
+
inflight = new Map();
|
|
45
|
+
buckets = new Map();
|
|
46
|
+
keys = new Map();
|
|
47
|
+
timer = null;
|
|
48
|
+
eventState = 'recovered';
|
|
49
|
+
restoring = false;
|
|
50
|
+
persistenceTail = Promise.resolve();
|
|
51
|
+
persistenceFailed = false;
|
|
52
|
+
constructor(options = {}) {
|
|
53
|
+
this.options = options;
|
|
54
|
+
}
|
|
55
|
+
configure(target, key, serverTimeMs) {
|
|
56
|
+
if (key.algorithm !== 'ECDSA-P256-SHA256' || !key.key_id || !integer(serverTimeMs))
|
|
57
|
+
throw new Error('risk signing key invalid');
|
|
58
|
+
const publicKey = decodeBase64Url(key.public_key, 65);
|
|
59
|
+
validatePublicKey(publicKey);
|
|
60
|
+
const identityChanged = this.target?.aid !== target.aid || this.target?.device_id !== target.device_id;
|
|
61
|
+
if (identityChanged) {
|
|
62
|
+
this.snapshots.clear();
|
|
63
|
+
this.keys.clear();
|
|
64
|
+
this.serverTime = 0;
|
|
65
|
+
this.buckets.clear();
|
|
66
|
+
}
|
|
67
|
+
else if (this.target?.connection_id !== target.connection_id) {
|
|
68
|
+
for (const [name, snapshot] of this.snapshots)
|
|
69
|
+
if (snapshot.envelope.subject.type === 'connection')
|
|
70
|
+
this.snapshots.delete(name);
|
|
71
|
+
}
|
|
72
|
+
this.target = { ...target };
|
|
73
|
+
this.keyId = key.key_id;
|
|
74
|
+
this.publicKey = publicKey;
|
|
75
|
+
this.keys.set(key.key_id, this.publicKey);
|
|
76
|
+
this.serverTime = Math.max(serverTimeMs, this.serverTime ? this.trustedNow() : serverTimeMs);
|
|
77
|
+
this.configuredAt = this.now();
|
|
78
|
+
this.scheduleTransition();
|
|
79
|
+
}
|
|
80
|
+
async apply(raw) {
|
|
81
|
+
const envelope = raw;
|
|
82
|
+
this.validate(envelope);
|
|
83
|
+
const { signature, ...unsigned } = envelope;
|
|
84
|
+
let valid = false;
|
|
85
|
+
try {
|
|
86
|
+
valid = p256.verify(decodeBase64Url(signature, 64), canonicalJson(unsigned), this.keys.get(envelope.signing_key_id), { prehash: true, lowS: false, format: 'compact' });
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
valid = false;
|
|
90
|
+
}
|
|
91
|
+
if (!valid)
|
|
92
|
+
throw new Error('risk signature invalid');
|
|
93
|
+
const body = stableJson({ issuer: envelope.issuer, subject: envelope.subject, revision: envelope.revision, policies: envelope.policies });
|
|
94
|
+
const subjectKey = stableJson(envelope.subject);
|
|
95
|
+
const existing = this.snapshots.get(subjectKey);
|
|
96
|
+
if (existing && envelope.revision < existing.envelope.revision)
|
|
97
|
+
return 'received';
|
|
98
|
+
if (existing && envelope.revision === existing.envelope.revision) {
|
|
99
|
+
if (body !== existing.body)
|
|
100
|
+
throw new Error('risk revision conflict');
|
|
101
|
+
if (this.persistenceFailed)
|
|
102
|
+
await this.persist();
|
|
103
|
+
return 'received';
|
|
104
|
+
}
|
|
105
|
+
const oldRestricted = this.isRestricted();
|
|
106
|
+
this.snapshots.set(subjectKey, { envelope: structuredClone(envelope), body });
|
|
107
|
+
this.scheduleTransition();
|
|
108
|
+
await this.persist();
|
|
109
|
+
const restricted = this.isRestricted();
|
|
110
|
+
if (restricted || oldRestricted)
|
|
111
|
+
await this.emit({
|
|
112
|
+
state: restricted ? (this.shouldDisconnect() ? 'blocked' : 'restricted') : 'recovered', revision: envelope.revision,
|
|
113
|
+
...(restricted ? { reason: this.activeReasons()[0], policy_ids: this.activePolicyIds() } : { policy_ids: [] }),
|
|
114
|
+
...(this.nextReconnectAt() !== null ? { reconnect_at_ms: this.nextReconnectAt() } : {}),
|
|
115
|
+
});
|
|
116
|
+
return 'applied';
|
|
117
|
+
}
|
|
118
|
+
acquire(request) {
|
|
119
|
+
if (!this.target)
|
|
120
|
+
return () => { };
|
|
121
|
+
if (this.isRestricted() && ['rpc:gateway.risk_ack', 'rpc:auth.connect', 'rpc:ping', 'rpc:meta.ping', 'rpc:system.ping', 'rpc:gateway.ping', 'rpc:auth.disconnect', 'rpc:gateway.risk_status'].includes(request))
|
|
122
|
+
return this.acquireControl();
|
|
123
|
+
const actions = this.activeActions(request);
|
|
124
|
+
const paused = actions.find(({ action }) => action.type === 'disconnect' || (action.type === 'pause_requests' && this.trustedNow() < Number(action.until_ms)));
|
|
125
|
+
if (paused)
|
|
126
|
+
throw new StateError('request blocked by risk policy', { stringCode: 'risk_restricted', retryable: true, data: { policy_id: paused.policy.policy_id } });
|
|
127
|
+
const limits = actions.filter(({ action }) => action.type === 'limit_requests');
|
|
128
|
+
const candidates = [];
|
|
129
|
+
for (const { action, key } of limits) {
|
|
130
|
+
const currentInflight = this.inflight.get(key) ?? 0;
|
|
131
|
+
if (integer(action.max_inflight) && action.max_inflight > 0 && currentInflight >= action.max_inflight)
|
|
132
|
+
throw new StateError('request concurrency limited by risk policy', { stringCode: 'risk_restricted', retryable: true });
|
|
133
|
+
const now = this.now();
|
|
134
|
+
const rate = Number(action.rate_per_sec), burst = Number(action.burst);
|
|
135
|
+
const bucket = this.buckets.get(key) ?? { tokens: burst, at: now };
|
|
136
|
+
const tokens = Math.min(burst, bucket.tokens + Math.max(0, now - bucket.at) * rate / 1000);
|
|
137
|
+
if (tokens < 1)
|
|
138
|
+
throw new StateError('request rate limited by risk policy', { stringCode: 'risk_restricted', retryable: true });
|
|
139
|
+
candidates.push({ key, tokens: tokens - 1, at: now });
|
|
140
|
+
}
|
|
141
|
+
for (const { key, tokens, at } of candidates) {
|
|
142
|
+
this.buckets.set(key, { tokens: tokens, at });
|
|
143
|
+
this.inflight.set(key, (this.inflight.get(key) ?? 0) + 1);
|
|
144
|
+
}
|
|
145
|
+
let released = false;
|
|
146
|
+
return () => {
|
|
147
|
+
if (released)
|
|
148
|
+
return;
|
|
149
|
+
released = true;
|
|
150
|
+
for (const { key } of candidates) {
|
|
151
|
+
const count = this.inflight.get(key) ?? 0;
|
|
152
|
+
if (count <= 1)
|
|
153
|
+
this.inflight.delete(key);
|
|
154
|
+
else
|
|
155
|
+
this.inflight.set(key, count - 1);
|
|
156
|
+
}
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
check(request) {
|
|
160
|
+
if (!this.target || ['rpc:gateway.risk_ack', 'rpc:auth.connect', 'rpc:ping', 'rpc:meta.ping', 'rpc:system.ping', 'rpc:gateway.ping', 'rpc:auth.disconnect', 'rpc:gateway.risk_status'].includes(request))
|
|
161
|
+
return;
|
|
162
|
+
const paused = this.activeActions(request).find(({ action }) => action.type === 'disconnect' || action.type === 'pause_requests');
|
|
163
|
+
if (paused)
|
|
164
|
+
throw new StateError('request blocked by risk policy', { stringCode: 'risk_restricted', retryable: true, data: { policy_id: paused.policy.policy_id } });
|
|
165
|
+
}
|
|
166
|
+
reconnectDelayMs() {
|
|
167
|
+
const deadline = this.nextReconnectAt();
|
|
168
|
+
return deadline === null ? 0 : Math.max(0, deadline - this.trustedNow());
|
|
169
|
+
}
|
|
170
|
+
shouldDisconnect() { return this.activeActions().some(({ action }) => action.type === 'disconnect'); }
|
|
171
|
+
get state() {
|
|
172
|
+
const active = this.activeActions();
|
|
173
|
+
return { state: this.shouldDisconnect() ? 'blocked' : active.length ? 'restricted' : 'recovered', revision: Math.max(0, ...Array.from(this.snapshots.values()).map(({ envelope }) => envelope.revision)), policy_ids: this.activePolicyIds(), ...(this.nextReconnectAt() !== null ? { reconnect_at_ms: this.nextReconnectAt() } : {}) };
|
|
174
|
+
}
|
|
175
|
+
exportState(includeConnection = false) {
|
|
176
|
+
const signingKeys = {};
|
|
177
|
+
for (const [id, key] of this.keys)
|
|
178
|
+
signingKeys[id] = Array.from(key);
|
|
179
|
+
return { issuer: this.target?.aid.slice(this.target.aid.indexOf('.') + 1) ?? '', target: this.target, signing_keys: signingKeys, states: Array.from(this.snapshots.values()).filter(({ envelope }) => includeConnection || envelope.subject.type !== 'connection').map(({ envelope }) => envelope), saved_at_ms: Date.now(), server_time_ms: Math.floor(this.trustedNow()) };
|
|
180
|
+
}
|
|
181
|
+
async restore(state) {
|
|
182
|
+
if (!Array.isArray(state.states))
|
|
183
|
+
return;
|
|
184
|
+
if (state.issuer !== this.target?.aid.slice(this.target.aid.indexOf('.') + 1))
|
|
185
|
+
throw new Error('risk issuer mismatch');
|
|
186
|
+
if (object(state.signing_keys))
|
|
187
|
+
for (const [id, bytes] of Object.entries(state.signing_keys)) {
|
|
188
|
+
if (!this.keys.has(id) && Array.isArray(bytes) && bytes.length === 65 && bytes.every((byte) => integer(byte) && byte <= 255)) {
|
|
189
|
+
const publicKey = Uint8Array.from(bytes);
|
|
190
|
+
try {
|
|
191
|
+
validatePublicKey(publicKey);
|
|
192
|
+
this.keys.set(id, publicKey);
|
|
193
|
+
}
|
|
194
|
+
catch {
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
if (integer(state.server_time_ms) && integer(state.saved_at_ms)) {
|
|
200
|
+
this.serverTime = Math.max(this.serverTime, state.server_time_ms + Math.max(0, Date.now() - state.saved_at_ms));
|
|
201
|
+
this.configuredAt = this.now();
|
|
202
|
+
}
|
|
203
|
+
this.restoring = true;
|
|
204
|
+
try {
|
|
205
|
+
for (const raw of state.states)
|
|
206
|
+
if (object(raw))
|
|
207
|
+
await this.apply(raw);
|
|
208
|
+
}
|
|
209
|
+
finally {
|
|
210
|
+
this.restoring = false;
|
|
211
|
+
}
|
|
212
|
+
await this.persist();
|
|
213
|
+
}
|
|
214
|
+
close() { if (this.timer !== null)
|
|
215
|
+
clearTimeout(this.timer); this.timer = null; }
|
|
216
|
+
async restorePinned(state, target) {
|
|
217
|
+
if (!object(state.target) || state.target.aid !== target.aid || state.target.device_id !== target.device_id || !object(state.signing_keys))
|
|
218
|
+
throw new Error('risk persisted subject mismatch');
|
|
219
|
+
const [keyId, bytes] = Object.entries(state.signing_keys)[0] ?? [];
|
|
220
|
+
if (!keyId || !Array.isArray(bytes) || bytes.length !== 65 || !bytes.every((byte) => integer(byte) && byte <= 255))
|
|
221
|
+
throw new Error('risk persisted key invalid');
|
|
222
|
+
validatePublicKey(Uint8Array.from(bytes));
|
|
223
|
+
const publicKey = btoa(String.fromCharCode(...bytes)).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '');
|
|
224
|
+
this.configure(target, { key_id: keyId, public_key: publicKey, algorithm: 'ECDSA-P256-SHA256' }, Number(state.server_time_ms));
|
|
225
|
+
await this.restore(state);
|
|
226
|
+
}
|
|
227
|
+
reset() { this.close(); this.target = null; this.snapshots.clear(); this.keys.clear(); this.buckets.clear(); this.inflight.clear(); this.serverTime = 0; this.eventState = 'recovered'; }
|
|
228
|
+
appliesTo(aid, deviceId) { return this.target?.aid === aid && this.target.device_id === deviceId; }
|
|
229
|
+
async persist() {
|
|
230
|
+
if (this.restoring)
|
|
231
|
+
return;
|
|
232
|
+
const state = this.exportState();
|
|
233
|
+
const run = this.persistenceTail.then(async () => {
|
|
234
|
+
try {
|
|
235
|
+
await this.options.persist?.(state);
|
|
236
|
+
this.persistenceFailed = false;
|
|
237
|
+
}
|
|
238
|
+
catch {
|
|
239
|
+
this.persistenceFailed = true;
|
|
240
|
+
}
|
|
241
|
+
});
|
|
242
|
+
this.persistenceTail = run;
|
|
243
|
+
await run;
|
|
244
|
+
}
|
|
245
|
+
async emit(event) {
|
|
246
|
+
this.eventState = event.state;
|
|
247
|
+
try {
|
|
248
|
+
await this.options.onState?.(event);
|
|
249
|
+
}
|
|
250
|
+
catch { /* 应用回调不改变已生效限制 */ }
|
|
251
|
+
}
|
|
252
|
+
scheduleTransition() {
|
|
253
|
+
this.close();
|
|
254
|
+
const now = this.trustedNow();
|
|
255
|
+
const deadlines = [];
|
|
256
|
+
for (const snapshot of this.snapshots.values())
|
|
257
|
+
for (const policy of snapshot.envelope.policies) {
|
|
258
|
+
for (const deadline of [policy.effective_at_ms, policy.expires_at_ms, ...policy.actions.map((action) => Number(action.until_ms ?? action.not_before_ms ?? 0))])
|
|
259
|
+
if (deadline > now)
|
|
260
|
+
deadlines.push(deadline);
|
|
261
|
+
}
|
|
262
|
+
if (!deadlines.length)
|
|
263
|
+
return;
|
|
264
|
+
this.timer = setTimeout(() => {
|
|
265
|
+
this.timer = null;
|
|
266
|
+
const state = this.state;
|
|
267
|
+
if (state.state !== this.eventState)
|
|
268
|
+
void this.emit(state);
|
|
269
|
+
void this.persist();
|
|
270
|
+
this.scheduleTransition();
|
|
271
|
+
}, Math.min(0x7fffffff, Math.max(1, Math.min(...deadlines) - now)));
|
|
272
|
+
}
|
|
273
|
+
validate(e) {
|
|
274
|
+
validateIntegers(e);
|
|
275
|
+
if (!object(e) || e.version !== 1 || !integer(e.revision) || !integer(e.server_time_ms)
|
|
276
|
+
|| typeof e.issuer !== 'string' || typeof e.delivery_id !== 'string' || !e.delivery_id || !object(e.subject) || !Array.isArray(e.policies)
|
|
277
|
+
|| !this.keys.has(e.signing_key_id) || typeof e.signature !== 'string' || !this.target)
|
|
278
|
+
throw new Error('risk envelope invalid');
|
|
279
|
+
const subject = e.subject;
|
|
280
|
+
if (!['aid', 'device', 'connection'].includes(subject.type) || e.issuer !== this.target.aid.slice(this.target.aid.indexOf('.') + 1) || subject.aid !== this.target.aid
|
|
281
|
+
|| (subject.type !== 'aid' && subject.device_id !== this.target.device_id)
|
|
282
|
+
|| (subject.type === 'connection' && (subject.slot_id !== this.target.slot_id || subject.connection_id !== this.target.connection_id)))
|
|
283
|
+
throw new Error('risk subject mismatch');
|
|
284
|
+
for (const policy of e.policies) {
|
|
285
|
+
if (!object(policy) || typeof policy.policy_id !== 'string' || typeof policy.incident_id !== 'string' || typeof policy.reason !== 'string'
|
|
286
|
+
|| !integer(policy.issued_at_ms) || !integer(policy.effective_at_ms) || !integer(policy.expires_at_ms) || policy.expires_at_ms <= policy.effective_at_ms || !Array.isArray(policy.actions))
|
|
287
|
+
throw new Error('risk policy invalid');
|
|
288
|
+
for (const action of policy.actions) {
|
|
289
|
+
if (!object(action) || typeof action.type !== 'string')
|
|
290
|
+
throw new Error('risk action invalid');
|
|
291
|
+
if (action.type === 'pause_requests' && (!Array.isArray(action.request_scope) || !integer(action.until_ms)))
|
|
292
|
+
throw new Error('risk action invalid');
|
|
293
|
+
if (action.type === 'limit_requests' && (!Array.isArray(action.request_scope) || !integer(action.rate_per_sec) || action.rate_per_sec < 1 || !integer(action.burst) || action.burst < 1 || !integer(action.max_inflight)))
|
|
294
|
+
throw new Error('risk action invalid');
|
|
295
|
+
if (action.type === 'reconnect_after' && !integer(action.not_before_ms))
|
|
296
|
+
throw new Error('risk action invalid');
|
|
297
|
+
if (!['pause_requests', 'limit_requests', 'reconnect_after', 'disconnect'].includes(action.type))
|
|
298
|
+
throw new Error('risk action invalid');
|
|
299
|
+
if (['pause_requests', 'limit_requests'].includes(action.type) && !validScope(action.request_scope))
|
|
300
|
+
throw new Error('risk scope invalid');
|
|
301
|
+
}
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
activeActions(request) {
|
|
305
|
+
const now = this.trustedNow();
|
|
306
|
+
const result = [];
|
|
307
|
+
for (const [subjectKey, snapshot] of this.snapshots) {
|
|
308
|
+
for (const policy of snapshot.envelope.policies) {
|
|
309
|
+
if (now < policy.effective_at_ms || now >= policy.expires_at_ms)
|
|
310
|
+
continue;
|
|
311
|
+
for (const [index, action] of policy.actions.entries()) {
|
|
312
|
+
if (action.type === 'pause_requests' && Number(action.until_ms) <= now)
|
|
313
|
+
continue;
|
|
314
|
+
if (action.type === 'reconnect_after' && Number(action.not_before_ms) <= now)
|
|
315
|
+
continue;
|
|
316
|
+
if (request === undefined || action.type === 'disconnect' || scopeMatches(action.request_scope, request))
|
|
317
|
+
result.push({ policy, action, key: `${subjectKey}:${policy.policy_id}:${index}` });
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
return result;
|
|
322
|
+
}
|
|
323
|
+
activeReasons() { return Array.from(new Set(this.activeActions().map(({ policy }) => policy.reason))); }
|
|
324
|
+
activePolicyIds() { return Array.from(new Set(this.activeActions().map(({ policy }) => policy.policy_id))); }
|
|
325
|
+
isRestricted() { return this.activeReasons().length > 0; }
|
|
326
|
+
nextReconnectAt() {
|
|
327
|
+
const deadlines = this.activeActions().filter(({ action }) => action.type === 'reconnect_after' || action.type === 'disconnect').map(({ action, policy }) => Math.min(policy.expires_at_ms, action.type === 'disconnect' ? policy.expires_at_ms : Number(action.not_before_ms)));
|
|
328
|
+
return deadlines.length ? Math.max(...deadlines) : null;
|
|
329
|
+
}
|
|
330
|
+
trustedNow() { return this.serverTime + Math.max(0, this.now() - this.configuredAt); }
|
|
331
|
+
acquireControl() {
|
|
332
|
+
const now = this.now();
|
|
333
|
+
const bucket = this.buckets.get('sdk-control') ?? { tokens: 4, at: now };
|
|
334
|
+
bucket.tokens = Math.min(4, bucket.tokens + Math.max(0, now - bucket.at) * 2 / 1000);
|
|
335
|
+
bucket.at = now;
|
|
336
|
+
this.buckets.set('sdk-control', bucket);
|
|
337
|
+
if (bucket.tokens < 1)
|
|
338
|
+
throw new StateError('risk control budget exhausted', { stringCode: 'risk_restricted', retryable: true });
|
|
339
|
+
bucket.tokens -= 1;
|
|
340
|
+
return () => { };
|
|
341
|
+
}
|
|
342
|
+
now() { return this.options.monotonicNow?.() ?? (typeof performance !== 'undefined' ? performance.now() : Date.now()); }
|
|
343
|
+
}
|
|
344
|
+
//# sourceMappingURL=risk-control.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"risk-control.js","sourceRoot":"","sources":["../src/risk-control.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
import type { CredentialSigner } from './org-protocol.js';
|
|
2
|
+
import { type AID, type AuthorizationRequest, type AuthenticatedAUNContext, type CredentialLineageEntry, type CredentialPackage, type CredentialRevisionRef, type CredentialStatusProof, type DecisionInput, type Digest, type JsonObject, type PolicyRef, type RecordVerificationContext, type SemanticCredential, type SemanticErrorData, type SemanticFacadeInput, type SemanticGetParams, type SemanticGetResult, type SemanticRegisterParams, type SemanticRegisterResult, type SemanticReviseParams, type SemanticReviseResult, type SemanticRevokeParams, type SemanticRevokeResult, type SemanticRevocationListParams, type SemanticRevocationPage, type SemanticStatusParams, type SemanticUsageInput, type SemanticVerificationReport, type SignatureDomain, type SignedJsonBytes, type StateCheckPolicy, type UsageTransitionReceipt, type VerifiedBody, type UsageAllocation, type AllocationStatusProof, type AUNEvidenceLocator, type EvidenceRef, type EvidenceResolver, type SemanticMessageArchive, type SemanticMessageVerificationContext } from './semantic-protocol.js';
|
|
3
|
+
export type { SemanticMessageArchive, SemanticMessageVerificationContext } from './semantic-protocol.js';
|
|
4
|
+
type Raw = Record<string, any>;
|
|
5
|
+
export interface SemanticPersistentState {
|
|
6
|
+
sequences?: Record<string, {
|
|
7
|
+
state_seq: number;
|
|
8
|
+
status: string;
|
|
9
|
+
revision: CredentialRevisionRef;
|
|
10
|
+
}>;
|
|
11
|
+
revoked?: Record<string, true>;
|
|
12
|
+
scopes?: Record<string, {
|
|
13
|
+
after_event_seq: number;
|
|
14
|
+
upper_event_seq: number;
|
|
15
|
+
next_cursor: string | null;
|
|
16
|
+
}>;
|
|
17
|
+
requests?: Record<string, {
|
|
18
|
+
request_hash: Digest;
|
|
19
|
+
nonce: string;
|
|
20
|
+
expires_at: number;
|
|
21
|
+
accepted?: boolean;
|
|
22
|
+
}>;
|
|
23
|
+
nonces?: Record<string, {
|
|
24
|
+
request_id: string;
|
|
25
|
+
request_hash: Digest;
|
|
26
|
+
expires_at: number;
|
|
27
|
+
}>;
|
|
28
|
+
mergedPages?: Record<string, true>;
|
|
29
|
+
allocations?: Record<string, {
|
|
30
|
+
allocation_hash: Digest;
|
|
31
|
+
state_seq: number;
|
|
32
|
+
state: AllocationStatusProof['state'];
|
|
33
|
+
}>;
|
|
34
|
+
proofs?: Record<string, true>;
|
|
35
|
+
}
|
|
36
|
+
export interface SemanticFacadeClient {
|
|
37
|
+
call(method: string, params: any): Promise<any>;
|
|
38
|
+
readonly aid?: string | null;
|
|
39
|
+
readonly currentAid?: CredentialSigner | null;
|
|
40
|
+
_semanticServiceAid?(): string | Promise<string>;
|
|
41
|
+
_semanticContextKey?(): string;
|
|
42
|
+
_semanticVerificationContext?(): RecordVerificationContext;
|
|
43
|
+
_semanticMessageVerificationContext?(): SemanticMessageVerificationContext;
|
|
44
|
+
_loadSemanticState?(): SemanticPersistentState | Promise<SemanticPersistentState>;
|
|
45
|
+
_saveSemanticState?(state: SemanticPersistentState): void | Promise<void>;
|
|
46
|
+
}
|
|
47
|
+
export interface SemanticFacadeOptions {
|
|
48
|
+
serviceAid?: string;
|
|
49
|
+
verificationContext?: RecordVerificationContext;
|
|
50
|
+
monotonicNow?: () => number;
|
|
51
|
+
}
|
|
52
|
+
export interface SemanticOperationOptions {
|
|
53
|
+
serviceAid?: string;
|
|
54
|
+
verificationContext?: RecordVerificationContext;
|
|
55
|
+
}
|
|
56
|
+
export interface SemanticPackageVerificationContext extends Partial<RecordVerificationContext> {
|
|
57
|
+
audience: AID;
|
|
58
|
+
expectedServiceAid?: AID;
|
|
59
|
+
originalSigner?: (entry: CredentialLineageEntry) => AID | Promise<AID>;
|
|
60
|
+
serviceFor?: (cid: string) => AID | Promise<AID>;
|
|
61
|
+
legacyVerifier?: (entry: CredentialLineageEntry, audience: AID, now: number) => void | Promise<void>;
|
|
62
|
+
statePolicy?: StateCheckPolicy;
|
|
63
|
+
elapsedSeconds?: number;
|
|
64
|
+
queries?: Record<string, {
|
|
65
|
+
request_hash: Digest;
|
|
66
|
+
nonce: string;
|
|
67
|
+
}>;
|
|
68
|
+
}
|
|
69
|
+
export interface SemanticAllocationVerificationContext extends Partial<RecordVerificationContext> {
|
|
70
|
+
parent: CredentialLineageEntry;
|
|
71
|
+
child: CredentialLineageEntry;
|
|
72
|
+
audience: AID;
|
|
73
|
+
}
|
|
74
|
+
export interface SemanticAllocationStatusVerificationContext extends Partial<RecordVerificationContext> {
|
|
75
|
+
allocation: UsageAllocation;
|
|
76
|
+
query: {
|
|
77
|
+
request_hash: Digest;
|
|
78
|
+
nonce: string;
|
|
79
|
+
};
|
|
80
|
+
elapsedSeconds: number;
|
|
81
|
+
}
|
|
82
|
+
export declare class SemanticRPCFailure extends Error {
|
|
83
|
+
readonly data: SemanticErrorData;
|
|
84
|
+
readonly code = -32000;
|
|
85
|
+
readonly retryable: boolean;
|
|
86
|
+
constructor(message: string, data: SemanticErrorData);
|
|
87
|
+
}
|
|
88
|
+
export declare class SemanticCredentialFacade {
|
|
89
|
+
private readonly client;
|
|
90
|
+
private readonly options;
|
|
91
|
+
private state;
|
|
92
|
+
private tail;
|
|
93
|
+
private readonly proofFirstSeen;
|
|
94
|
+
private readonly allocationProofFirstSeen;
|
|
95
|
+
private readonly statusCache;
|
|
96
|
+
constructor(client: SemanticFacadeClient, options?: SemanticFacadeOptions);
|
|
97
|
+
configure(options: SemanticFacadeOptions): void;
|
|
98
|
+
private clock;
|
|
99
|
+
private monotonic;
|
|
100
|
+
private identity;
|
|
101
|
+
private guard;
|
|
102
|
+
private service;
|
|
103
|
+
private context;
|
|
104
|
+
private mutate;
|
|
105
|
+
private invoke;
|
|
106
|
+
private responseRecord;
|
|
107
|
+
private registered;
|
|
108
|
+
private revisionHeads;
|
|
109
|
+
register(input: SemanticFacadeInput<SemanticRegisterParams>, options?: SemanticOperationOptions): Promise<SemanticRegisterResult>;
|
|
110
|
+
revise(input: SemanticFacadeInput<SemanticReviseParams>, options?: SemanticOperationOptions): Promise<SemanticReviseResult>;
|
|
111
|
+
prepareUsage(input: SemanticUsageInput<'usage_prepare'>, options?: SemanticOperationOptions): Promise<UsageTransitionReceipt>;
|
|
112
|
+
commitUsage(input: SemanticUsageInput<'usage_commit'>, options?: SemanticOperationOptions): Promise<UsageTransitionReceipt>;
|
|
113
|
+
abortUsage(input: SemanticUsageInput<'usage_abort'>, options?: SemanticOperationOptions): Promise<UsageTransitionReceipt>;
|
|
114
|
+
get(input: SemanticFacadeInput<SemanticGetParams>, options?: SemanticOperationOptions): Promise<SemanticGetResult>;
|
|
115
|
+
private proofIdentity;
|
|
116
|
+
private rememberProof;
|
|
117
|
+
private observe;
|
|
118
|
+
status(input: SemanticFacadeInput<SemanticStatusParams>, options?: SemanticOperationOptions): Promise<CredentialStatusProof>;
|
|
119
|
+
revoke(input: SemanticFacadeInput<SemanticRevokeParams>, options?: SemanticOperationOptions): Promise<SemanticRevokeResult>;
|
|
120
|
+
revocations(input: SemanticFacadeInput<SemanticRevocationListParams>, options?: SemanticOperationOptions): Promise<SemanticRevocationPage>;
|
|
121
|
+
private signer;
|
|
122
|
+
signCredential(value: unknown, signer?: CredentialSigner, options?: {
|
|
123
|
+
timestamp?: number;
|
|
124
|
+
}): Promise<SignedJsonBytes>;
|
|
125
|
+
signMetadata(value: unknown, signer?: CredentialSigner, options?: {
|
|
126
|
+
timestamp?: number;
|
|
127
|
+
}): Promise<SignedJsonBytes>;
|
|
128
|
+
verifyAllocation(value: unknown, context: SemanticAllocationVerificationContext): Promise<SemanticVerificationReport>;
|
|
129
|
+
signAllocation(value: unknown, signer?: CredentialSigner, options?: {
|
|
130
|
+
timestamp?: number;
|
|
131
|
+
}): Promise<SignedJsonBytes>;
|
|
132
|
+
signUsageRecord(domain: SignatureDomain, value: unknown, signer?: CredentialSigner, options?: {
|
|
133
|
+
timestamp?: number;
|
|
134
|
+
}): Promise<SignedJsonBytes>;
|
|
135
|
+
verifyAllocationStatus(value: unknown, context: SemanticAllocationStatusVerificationContext): Promise<SemanticVerificationReport>;
|
|
136
|
+
verifyUsageRecord(domain: SignatureDomain, value: unknown, context?: Partial<RecordVerificationContext>): Promise<SemanticVerificationReport>;
|
|
137
|
+
verifyOriginal(value: unknown, context?: Partial<RecordVerificationContext>): Promise<SemanticVerificationReport>;
|
|
138
|
+
verifyMetadata(value: unknown, context?: Partial<RecordVerificationContext>): Promise<SemanticVerificationReport>;
|
|
139
|
+
verifyReceipt(value: unknown, context?: Partial<RecordVerificationContext>): Promise<SemanticVerificationReport>;
|
|
140
|
+
verifyStatus(value: unknown, context?: Partial<RecordVerificationContext> & {
|
|
141
|
+
expectedServiceAid?: string;
|
|
142
|
+
policy?: StateCheckPolicy;
|
|
143
|
+
elapsedSeconds?: number;
|
|
144
|
+
query?: {
|
|
145
|
+
request_hash: Digest;
|
|
146
|
+
nonce: string;
|
|
147
|
+
};
|
|
148
|
+
}): Promise<SemanticVerificationReport>;
|
|
149
|
+
buildPackage(lineage: CredentialLineageEntry[]): Promise<CredentialPackage>;
|
|
150
|
+
private effective;
|
|
151
|
+
private lineageBindings;
|
|
152
|
+
verifyPackage(value: CredentialPackage, context: SemanticPackageVerificationContext): Promise<SemanticVerificationReport>;
|
|
153
|
+
requestHash(request: Omit<AuthorizationRequest, 'request_binding'> | AuthorizationRequest): Promise<Digest>;
|
|
154
|
+
buildRequest(input: Omit<AuthorizationRequest, 'params_hash' | 'request_binding'>, options?: {
|
|
155
|
+
now?: number;
|
|
156
|
+
}): Promise<AuthorizationRequest>;
|
|
157
|
+
private requestShape;
|
|
158
|
+
private rememberRequest;
|
|
159
|
+
verifyRequest(request: AuthorizationRequest, authentication: AuthenticatedAUNContext, options?: {
|
|
160
|
+
now?: number;
|
|
161
|
+
representedActor?: (actor: string, sub: string) => boolean | Promise<boolean>;
|
|
162
|
+
}): Promise<{
|
|
163
|
+
request_hash: Digest;
|
|
164
|
+
checked: string[];
|
|
165
|
+
required: string[];
|
|
166
|
+
}>;
|
|
167
|
+
buildDecisionInput(request: AuthorizationRequest, bodies: VerifiedBody[], facts: JsonObject, policy: PolicyRef): Promise<DecisionInput>;
|
|
168
|
+
createEvidenceRef(bytes: Uint8Array, profile: string, locator?: AUNEvidenceLocator): Promise<EvidenceRef>;
|
|
169
|
+
resolveEvidence(ref: EvidenceRef, resolvers?: Record<string, EvidenceResolver>): Promise<Uint8Array>;
|
|
170
|
+
archiveMessage(envelope: Uint8Array | string | Raw, received: {
|
|
171
|
+
received_by: string;
|
|
172
|
+
received_at: number;
|
|
173
|
+
source: string;
|
|
174
|
+
}): Promise<SemanticMessageArchive>;
|
|
175
|
+
verifyMessageBody(value: SemanticCredential | SignedJsonBytes, context?: Partial<SemanticMessageVerificationContext>): Promise<VerifiedBody>;
|
|
176
|
+
}
|