@belticlabs/agent-risk-sdk 0.5.0 → 0.7.0

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.
@@ -1,29 +1,26 @@
1
+ import {
2
+ summaryOf
3
+ } from "./chunk-M4I3FGZG.js";
1
4
  import {
2
5
  toJsonObject
3
6
  } from "./chunk-FQDHFTVR.js";
4
7
  import {
5
8
  payloadDigest
6
- } from "./chunk-X3W2Z5GC.js";
9
+ } from "./chunk-UXXSE643.js";
10
+ import {
11
+ Money
12
+ } from "./chunk-FNU4CRJJ.js";
7
13
 
8
14
  // src/x402/binding.ts
9
15
  var SESSION_EXTENSION = "beltic.sessionId";
10
16
  var SESSION_HEADER = "Beltic-Session-Id";
11
- var DECISION_EXTENSION = "beltic.decisionId";
12
17
  function sessionIdOf(extensions) {
13
- return stringAt(extensions, SESSION_EXTENSION);
14
- }
15
- function decisionIdOf(extensions) {
16
- return stringAt(extensions, DECISION_EXTENSION);
17
- }
18
- function stringAt(extensions, key) {
19
- const v = extensions?.[key];
18
+ const v = extensions?.[SESSION_EXTENSION];
20
19
  return typeof v === "string" && v.length > 0 ? v : null;
21
20
  }
22
21
 
23
22
  // src/x402/moments.ts
24
- function x402Currency(network, asset) {
25
- return `${network}/${asset}`;
26
- }
23
+ import { z } from "zod";
27
24
  function x402Summary(accepts, opts = {}) {
28
25
  const payer = opts.payer?.toLowerCase();
29
26
  return {
@@ -31,7 +28,7 @@ function x402Summary(accepts, opts = {}) {
31
28
  payee: accepts?.payTo ?? "unknown",
32
29
  amount: {
33
30
  value: accepts?.amount ?? "0",
34
- currency: accepts ? x402Currency(accepts.network ?? "unknown", accepts.asset ?? "unknown") : "unknown"
31
+ currency: accepts ? Money.x402Currency(accepts.network ?? "unknown", accepts.asset ?? "unknown") : "unknown"
35
32
  },
36
33
  ...payer ? { payer } : {}
37
34
  };
@@ -68,7 +65,7 @@ var x402Moments = {
68
65
  return fromAccepts(
69
66
  {
70
67
  payTo: typeof accepts.payTo === "string" ? accepts.payTo : "dynamic",
71
- amount: priceValue(accepts.price),
68
+ amount: PriceSchema.parse(accepts.price),
72
69
  network: accepts.network,
73
70
  asset: extra?.asset ?? "route"
74
71
  },
@@ -86,24 +83,22 @@ var x402Moments = {
86
83
  );
87
84
  }
88
85
  };
89
- function priceValue(price) {
90
- if (typeof price === "string") return price.replace(/[^0-9.]/g, "") || "0";
91
- if (typeof price === "number") return String(price);
92
- if (price && typeof price === "object" && typeof price.amount === "string")
93
- return price.amount;
94
- return "0";
95
- }
86
+ var PriceSchema = z.union([
87
+ z.string().transform((s) => s.replace(/[^0-9.]/g, "") || "0"),
88
+ z.number().transform(String),
89
+ z.object({ amount: z.string() }).transform((p) => p.amount)
90
+ ]).catch("0");
96
91
 
97
92
  // src/x402/adapter.ts
98
- function attachX402(beltic, server, http, opts = {}) {
93
+ function attachX402(beltic, server, http) {
99
94
  const inFlight = /* @__PURE__ */ new Map();
100
95
  http?.onProtectedRequest(async (ctx, route) => {
101
96
  if (ctx.paymentHeader) return;
102
97
  const bound = ctx.adapter.getHeader(SESSION_HEADER) ?? ctx.adapter.getHeader(SESSION_HEADER.toLowerCase());
103
98
  if (!bound) return;
104
- const session = await beltic.sessions.ensure(bound);
99
+ const stream = await beltic.streams.ensure(bound);
105
100
  const accepts = Array.isArray(route.accepts) ? route.accepts[0] : route.accepts;
106
- await session.emit(
101
+ await stream.emit(
107
102
  "payment.requested",
108
103
  x402Moments.route(accepts, {
109
104
  path: ctx.path,
@@ -115,49 +110,33 @@ function attachX402(beltic, server, http, opts = {}) {
115
110
  server.onBeforeVerify(async (ctx) => {
116
111
  const payload = ctx.paymentPayload;
117
112
  const requirements = ctx.requirements;
118
- const session = await beltic.sessions.ensure(sessionIdOf(payload.extensions));
119
- if (session.born === "seller")
120
- await session.emit("payment.requested", x402Moments.requirements(requirements));
113
+ const stream = await beltic.streams.ensure(sessionIdOf(payload.extensions));
114
+ if (stream.born === "seller")
115
+ await stream.emit("payment.requested", x402Moments.requirements(requirements));
121
116
  const presented = x402Moments.payload(payload);
122
- await session.emit("payment.presented", presented);
123
- inFlight.set(payloadDigest(payload), session);
124
- const out = await beltic.evaluate(session.id, presented);
125
- if (!out) return;
126
- opts.onDecision?.({
127
- sessionId: session.id,
128
- decision: out.decision,
129
- reasonCodes: out.reasonCodes,
130
- born: session.born,
131
- buyerDecisionId: decisionIdOf(payload.extensions)
132
- });
133
- if (out.verdict.blocks(beltic.onReview)) {
134
- return {
135
- abort: true,
136
- reason: `BELTIC_${out.verdict.value}`,
137
- message: out.reasonCodes.join(",")
138
- };
139
- }
140
- return;
117
+ await stream.emit("payment.presented", presented);
118
+ inFlight.set(payloadDigest(payload), stream);
119
+ const decision = await beltic.evaluate(stream.id, summaryOf(presented));
120
+ if (decision.absent || decision.allowed) return;
121
+ return {
122
+ abort: true,
123
+ reason: `BELTIC_${decision.value}`,
124
+ message: decision.reasonCodes.join(",")
125
+ };
141
126
  });
142
127
  server.onAfterSettle(async (ctx) => {
143
128
  const key = payloadDigest(ctx.paymentPayload);
144
- const session = inFlight.get(key);
145
- if (!session) return;
129
+ const stream = inFlight.get(key);
130
+ if (!stream) return;
146
131
  inFlight.delete(key);
147
- if (ctx.result.success) await session.close("settled", { transaction: ctx.result.transaction });
132
+ if (ctx.result.success) await stream.close("settled", { transaction: ctx.result.transaction });
148
133
  });
149
- return { inFlight };
150
134
  }
151
135
 
152
136
  export {
153
137
  SESSION_EXTENSION,
154
138
  SESSION_HEADER,
155
- DECISION_EXTENSION,
156
- sessionIdOf,
157
- decisionIdOf,
158
- x402Currency,
159
139
  x402Summary,
160
- payerOf,
161
140
  x402Moments,
162
141
  attachX402
163
142
  };
@@ -0,0 +1,38 @@
1
+ // src/core/record.ts
2
+ function errorOf(err) {
3
+ const e = err;
4
+ return { name: String(e?.name ?? "Error"), message: String(e?.message ?? err) };
5
+ }
6
+ function openCall(stream, kind, callId, start) {
7
+ const started = Date.now();
8
+ const opened = stream.emit(`${kind}.start`, { callId, ...start });
9
+ const close = async (outcome) => {
10
+ await opened;
11
+ return stream.emit(
12
+ `${kind}.end`,
13
+ { callId, ...outcome, durationMs: Date.now() - started }
14
+ );
15
+ };
16
+ return {
17
+ callId,
18
+ opened,
19
+ end: (outcome = {}) => close(outcome),
20
+ fail: (error, outcome = {}) => close({ error: errorOf(error), ...outcome })
21
+ };
22
+ }
23
+ async function recordCall(span, run, end = () => ({})) {
24
+ await span.opened;
25
+ try {
26
+ const result = await run();
27
+ await span.end(await end(result));
28
+ return result;
29
+ } catch (err) {
30
+ await span.fail(err);
31
+ throw err;
32
+ }
33
+ }
34
+
35
+ export {
36
+ openCall,
37
+ recordCall
38
+ };
@@ -0,0 +1,13 @@
1
+ // src/core/payment-moment.ts
2
+ function summaryOf(m) {
3
+ return {
4
+ protocol: m.protocol,
5
+ payee: m.payee,
6
+ amount: { value: m.amount.value, currency: m.amount.currency },
7
+ ...m.payer ? { payer: m.payer } : {}
8
+ };
9
+ }
10
+
11
+ export {
12
+ summaryOf
13
+ };
@@ -9,28 +9,6 @@ function uuidv7(now = Date.now()) {
9
9
  return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
10
10
  }
11
11
 
12
- // ../canon/src/base58.ts
13
- var ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
14
- var MAP = new Map([...ALPHABET].map((c, i) => [c, i]));
15
- function base58Encode(bytes) {
16
- let zeros = 0;
17
- while (zeros < bytes.length && bytes[zeros] === 0) zeros++;
18
- const digits = [];
19
- for (let i = zeros; i < bytes.length; i++) {
20
- let carry = bytes[i];
21
- for (let j = 0; j < digits.length; j++) {
22
- carry += digits[j] << 8;
23
- digits[j] = carry % 58;
24
- carry = carry / 58 | 0;
25
- }
26
- while (carry > 0) {
27
- digits.push(carry % 58);
28
- carry = carry / 58 | 0;
29
- }
30
- }
31
- return "1".repeat(zeros) + digits.reverse().map((d) => ALPHABET[d]).join("");
32
- }
33
-
34
12
  // ../canon/src/encoding.ts
35
13
  function toHex(buf) {
36
14
  return Buffer.from(buf).toString("hex");
@@ -293,6 +271,28 @@ var Chain = class _Chain {
293
271
  }
294
272
  };
295
273
 
274
+ // ../canon/src/base58.ts
275
+ var ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
276
+ var MAP = new Map([...ALPHABET].map((c, i) => [c, i]));
277
+ function base58Encode(bytes) {
278
+ let zeros = 0;
279
+ while (zeros < bytes.length && bytes[zeros] === 0) zeros++;
280
+ const digits = [];
281
+ for (let i = zeros; i < bytes.length; i++) {
282
+ let carry = bytes[i];
283
+ for (let j = 0; j < digits.length; j++) {
284
+ carry += digits[j] << 8;
285
+ digits[j] = carry % 58;
286
+ carry = carry / 58 | 0;
287
+ }
288
+ while (carry > 0) {
289
+ digits.push(carry % 58);
290
+ carry = carry / 58 | 0;
291
+ }
292
+ }
293
+ return "1".repeat(zeros) + digits.reverse().map((d) => ALPHABET[d]).join("");
294
+ }
295
+
296
296
  // ../canon/src/did-key.ts
297
297
  var ED25519_PUB_MULTICODEC = Buffer.from([237, 1]);
298
298
  var PREFIX = "did:key:z";
@@ -301,11 +301,13 @@ function didKeyFromEd25519(publicKey) {
301
301
  return PREFIX + base58Encode(Buffer.concat([ED25519_PUB_MULTICODEC, Buffer.from(publicKey)]));
302
302
  }
303
303
 
304
+ // ../canon/src/session-id.ts
305
+ import { randomBytes as randomBytes2 } from "crypto";
306
+
304
307
  export {
305
308
  toHex,
306
309
  fromHex,
307
310
  sha256,
308
- canonicalize,
309
311
  canonicalBytes,
310
312
  payloadDigest,
311
313
  memorySigner,
@@ -0,0 +1,71 @@
1
+ import { N as PaymentSummary } from './index-DAVKGJs5.js';
2
+ import { b as SessionOptions, S as Session, a as Decision } from './session-DAN29XoB.js';
3
+
4
+ /**
5
+ * One SDK, two halves (Fraud SDK RFC › Summary). `Beltic` is the single
6
+ * client: `session` for the buyer half, `evaluate` for whichever half is
7
+ * about to let a payment through. Protocol integrations are plain
8
+ * functions behind subpath exports, each pulling exactly one optional peer:
9
+ *
10
+ * @belticlabs/agent-risk-sdk/ai → middleware(session), wrapTools(session, …)
11
+ * @belticlabs/agent-risk-sdk/x402 → belticFetch(session), x402Summary(…), attachX402(beltic, …)
12
+ * @belticlabs/agent-risk-sdk/hono → belticPaymentMiddleware(beltic, …)
13
+ *
14
+ * Neither half decides risk locally: verdicts are platform-side.
15
+ *
16
+ * A client is configured or it is not constructed — `Beltic.fromEnv()`
17
+ * reads `BELTIC_*`, and there is no disabled client (GAP-78). Evidence is
18
+ * a side channel of the work it observes, so a platform outage never
19
+ * throws into that work (GAP-70): the transport waits it out, `session`
20
+ * runs without a stream, `evaluate` answers `Decision.absent()` — never an
21
+ * invented verdict. What the platform *rejects* (a 4xx, a forked chain)
22
+ * is the client's fault and throws.
23
+ */
24
+
25
+ declare const SDK_VERSION = "0.7.0";
26
+ interface BelticOptions {
27
+ apiKey: string;
28
+ baseUrl: string;
29
+ /** The agent's 32-byte Ed25519 seed as 64 hex — the buyer half. Without it, `session` is unavailable; the seller half works. */
30
+ agentSeed?: string | undefined;
31
+ }
32
+ declare class Beltic {
33
+ private readonly api;
34
+ private readonly transport;
35
+ /** Open handles by conversation id (GAP-84). */
36
+ private readonly sessions;
37
+ /**
38
+ * The client the environment describes: `BELTIC_API_KEY` and
39
+ * `BELTIC_BASE_URL`, both required, and `BELTIC_AGENT_SEED` (64 hex) for
40
+ * the buyer half. A missing required variable is a configuration error,
41
+ * thrown (GAP-78).
42
+ */
43
+ static fromEnv(env?: Record<string, string | undefined>): Beltic;
44
+ constructor(opts: BelticOptions);
45
+ /**
46
+ * A conversation: new without an id, resumed with one — the id `session.id()`
47
+ * answered in this or any earlier process (GAP-84). One handle per
48
+ * conversation in-process until it closes; the options count when a
49
+ * session is opened. See `Session`.
50
+ */
51
+ session(id?: string, opts?: SessionOptions): Session;
52
+ /**
53
+ * The platform's verdict on a payment — the seller's before it verifies,
54
+ * the buyer's before it presents (Fraud SDK RFC › Evaluation Client).
55
+ * Read-your-writes: the session's buffered evidence is flushed first so
56
+ * the platform judges what the caller already saw (GAP-16/88). With a `callId`
57
+ * the platform answers the decision already taken for that call anywhere
58
+ * in the conversation (GAP-84). Absent when the platform could not be
59
+ * reached (GAP-70).
60
+ */
61
+ evaluate(sessionId: string, payment: PaymentSummary, opts?: {
62
+ callId?: string | undefined;
63
+ }): Promise<Decision>;
64
+ /** Send everything buffered now — every session's — and wait for that attempt. */
65
+ flush(): Promise<void>;
66
+ shutdown(): Promise<void>;
67
+ /** `process.env` where there is a `process` (Node); `{}` on workerd, where the shell passes its `env`. */
68
+ private static processEnv;
69
+ }
70
+
71
+ export { Beltic as B, SDK_VERSION as S, type BelticOptions as a };