interai-risk-oracle 0.1.6-beta → 0.1.7-beta

package/README.md

@@ -2,15 +2,15 @@
 
 Typed hosted API client for InterAI Risk Oracle.
 
-Package version: `interai-risk-oracle@0.1.6-beta`.
+Package version: `interai-risk-oracle@0.1.7-beta`.
 
 ```bash
-npm install interai-risk-oracle@0.1.6-beta
+npm install interai-risk-oracle@0.1.7-beta
 ```
 
-## Builder workflow
+## Zero-funding builder trial
 
-The client can onboard a builder, retain the returned API key, inspect the account, quote usage, and manage a prepaid top-up without hand-building HTTP requests:
+A new builder can reach a first hosted verification without moving funds. The controlled demo trial is bounded by InterAI's trial TTL, per-client limits, shared budget, and maximum-verification count.
 
 ```ts
 import { InterAIRiskOracleClient } from "interai-risk-oracle"
@@ -20,7 +20,44 @@ const client = new InterAIRiskOracleClient({
 })
 
 const onboarding = await client.onboard({
-  name: "my-agent"
+  name: "my-agent",
+  scope: "demo_trial"
+})
+
+const decision = await client.verify({
+  use_case: "agent-before-tool-execution",
+  action: {
+    type: "read_only_lookup",
+    name: "check_order_status",
+    description: "Read an order status in a sandbox",
+    external_side_effect: false,
+    irreversible: false
+  },
+  context: {
+    agent_id: "my-agent",
+    environment: "sandbox",
+    user_confirmation: true
+  },
+  policy: { require_trust_receipt: true }
+})
+
+const receipt = await client.getTrustReceipt(decision.trust_receipt_id!)
+```
+
+`onboard()` stores the returned API key on the client when one is issued. The demo trial is for bounded integration evaluation; it is not a source of transferable funds and does not bypass normal production funding requirements.
+
+## Funded builder workflow
+
+The same client can create a standard account, retain the returned API key, inspect the account, quote usage, and manage a prepaid top-up without hand-building HTTP requests:
+
+```ts
+const client = new InterAIRiskOracleClient({
+  baseUrl: "https://api.interailabs.dev"
+})
+
+await client.onboard({
+  name: "my-funded-agent",
+  scope: "standard"
 })
 
 const account = await client.me()
@@ -28,7 +65,7 @@ const quote = await client.quote({ mode: "fast" })
 const topup = await client.createTopup("0.10")
 ```
 
-`onboard()` stores the returned API key on the client when one is issued. You can also set a key explicitly with `setApiKey()`.
+You can also set a key explicitly with `setApiKey()`.
 
 Top-up helpers cover `createTopup()`, `topupStatus()`, and `confirmTopup()`. Account helpers include `me()`, `ledger()`, and `usage()`. HTTP failures raise `OracleHttpError` with `status`, structured API `code`, response headers, body, and parsed x402 payment requirements when present.
 
@@ -102,4 +139,4 @@ npm run build
 npm pack --dry-run
 ```
 
-See [the durable SQLite dispatch example](../../examples/execution-boundary/README.md) for restart-safe consumption and terminal executor binding. The low-level validator alone does not prevent replay.
+See [the durable SQLite dispatch example](../../examples/execution-boundary/README.md) for restart-safe consumption and terminal executor binding. The low-level validator alone does not prevent replay.

package/dist/public.d.ts

@@ -0,0 +1,16 @@
+import { InterAIRiskOracleClient as BaseInterAIRiskOracleClient, type InterAIClientOptions, type OnboardResponse } from "./index.js";
+export * from "./index.js";
+export declare const SDK_VERSION: "0.1.7-beta";
+export type OnboardOptions = {
+    name?: string;
+    account_id?: string;
+    api_key_name?: string;
+    recommended_topup_usdc?: string;
+    scope?: "standard" | "demo_trial";
+};
+/** Package-facing client with the complete builder onboarding surface. */
+export declare class InterAIRiskOracleClient extends BaseInterAIRiskOracleClient {
+    constructor(options: InterAIClientOptions);
+    onboard(input?: OnboardOptions): Promise<OnboardResponse>;
+}
+//# sourceMappingURL=public.d.ts.map

package/dist/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,IAAI,2BAA2B,EACtD,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,YAAY,CAAA;AAEnB,cAAc,YAAY,CAAA;AAE1B,eAAO,MAAM,WAAW,EAAG,YAAqB,CAAA;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,KAAK,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;CAClC,CAAA;AAED,0EAA0E;AAC1E,qBAAa,uBAAwB,SAAQ,2BAA2B;gBAC1D,OAAO,EAAE,oBAAoB;IAO1B,OAAO,CAAC,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;CAG7E"}

package/dist/public.js

@@ -0,0 +1,16 @@
+import { InterAIRiskOracleClient as BaseInterAIRiskOracleClient } from "./index.js";
+export * from "./index.js";
+export const SDK_VERSION = "0.1.7-beta";
+/** Package-facing client with the complete builder onboarding surface. */
+export class InterAIRiskOracleClient extends BaseInterAIRiskOracleClient {
+    constructor(options) {
+        super({
+            ...options,
+            clientName: options.clientName || `typescript-sdk/${SDK_VERSION}`
+        });
+    }
+    async onboard(input = {}) {
+        return super.onboard(input);
+    }
+}
+//# sourceMappingURL=public.js.map

package/dist/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,IAAI,2BAA2B,EAGvD,MAAM,YAAY,CAAA;AAEnB,cAAc,YAAY,CAAA;AAE1B,MAAM,CAAC,MAAM,WAAW,GAAG,YAAqB,CAAA;AAUhD,0EAA0E;AAC1E,MAAM,OAAO,uBAAwB,SAAQ,2BAA2B;IACtE,YAAY,OAA6B;QACvC,KAAK,CAAC;YACJ,GAAG,OAAO;YACV,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,kBAAkB,WAAW,EAAE;SAClE,CAAC,CAAA;IACJ,CAAC;IAEQ,KAAK,CAAC,OAAO,CAAC,QAAwB,EAAE;QAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "interai-risk-oracle",
-  "version": "0.1.6-beta",
+  "version": "0.1.7-beta",
   "description": "TypeScript client for InterAI's independent pre-execution decision layer for consequential agent actions.",
   "homepage": "https://api.interailabs.dev/",
   "repository": {
@@ -12,12 +12,12 @@
     "url": "https://github.com/InterAILabs/ai-risk-oracle/issues"
   },
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/public.js",
+  "types": "./dist/public.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./dist/public.d.ts",
+      "import": "./dist/public.js"
     }
   },
   "files": [
@@ -49,4 +49,4 @@
   "devDependencies": {
     "typescript": "^5.0.0"
   }
-}
+}