@atbash/sdk 0.2.1 → 0.3.1

package/README.md

@@ -13,12 +13,12 @@ Requires Node.js 18 or higher. Server-side only — private keys are used for lo
 ## Quickstart
 
 ```ts
-import { createAgent, judgeAction } from "@atbash/sdk";
+import { loadAgent, judgeAction } from "@atbash/sdk";
 
 // 1. Load your agent identity — paste the private key from the Atbash
-//    dashboard (https://atbash.ai/risk-engine/agents). createAgent()
+//    dashboard (https://atbash.ai/risk-engine/agents). loadAgent()
 //    validates the key and derives the matching public key for you.
-const agent = createAgent(process.env.ATBASH_AGENT_PRIVKEY!);
+const agent = loadAgent(process.env.ATBASH_AGENT_PRIVKEY!);
 
 // 2. Submit an action for judgment, before executing it.
 //    The SDK signs and broadcasts log_tool_call to the Chromia chain
@@ -60,11 +60,11 @@ If you need finer control, you can call `logToolCall()` and the judge API separa
 Generate one programmatically for local development:
 
 ```ts
-import { generateKeyPair, createAgent } from "@atbash/sdk";
+import { generateKeyPair, loadAgent } from "@atbash/sdk";
 
 const { privKey } = generateKeyPair();
 console.log("Save this private key somewhere safe:", privKey);
-const agent = createAgent(privKey);
+const agent = loadAgent(privKey);
 ```
 
 For production, always create agents in the dashboard so operators can attach policy packs and manage tier / jail state.
@@ -175,14 +175,14 @@ interface JudgmentStatus {
 ### Agent identity
 
 ```ts
-createAgent(privkey: string): AgentAuth
+loadAgent(privkey: string): AgentAuth
 generateKeyPair(): { privKey: string; pubKey: string }
 derivePublicKey(privKeyHex: string): string
 isValidPrivateKey(hex: string): boolean
 toPubkeyHex(val: unknown): string
 ```
 
-`createAgent(privkey)` is the canonical loader — pass in the private key from the dashboard, get back `{ pubkey, privkey }` ready for `judgeAction`. It accepts `0x`-prefixed, padded, or mixed-case input and throws on malformed keys. Use `generateKeyPair()` only for local development; for production, create agents in the dashboard so operators can attach policies.
+`loadAgent(privkey)` is the canonical loader — pass in the private key from the dashboard, get back `{ pubkey, privkey }` ready for `judgeAction`. It accepts `0x`-prefixed, padded, or mixed-case input and throws on malformed keys. Use `generateKeyPair()` only for local development; for production, create agents in the dashboard so operators can attach policies.
 
 ### Query APIs
 

package/dist/index.cjs

@@ -33,7 +33,6 @@ __export(index_exports, {
   DEFAULT_BLOCKCHAIN_RID: () => DEFAULT_BLOCKCHAIN_RID,
   DEFAULT_CHROMIA_NODE_URLS: () => DEFAULT_CHROMIA_NODE_URLS,
   DEFAULT_ENDPOINT: () => DEFAULT_ENDPOINT,
-  createAgent: () => createAgent,
   derivePublicKey: () => derivePublicKey,
   generateKeyPair: () => generateKeyPair,
   getAgentDetail: () => getAgentDetail,
@@ -50,6 +49,7 @@ __export(index_exports, {
   getToolCalls: () => getToolCalls,
   isValidPrivateKey: () => isValidPrivateKey,
   judgeAction: () => judgeAction,
+  loadAgent: () => loadAgent,
   logToolCall: () => logToolCall,
   toPubkeyHex: () => toPubkeyHex
 });
@@ -82,7 +82,7 @@ function generateKeyPair() {
     pubKey: ecdh.getPublicKey("hex", "compressed")
   };
 }
-function createAgent(privkey) {
+function loadAgent(privkey) {
   const clean = privkey.replace(/^0x/, "").trim().toLowerCase();
   if (!isValidPrivateKey(clean)) {
     throw new Error(
@@ -351,7 +351,6 @@ async function getSafetyStats(opts) {
   DEFAULT_BLOCKCHAIN_RID,
   DEFAULT_CHROMIA_NODE_URLS,
   DEFAULT_ENDPOINT,
-  createAgent,
   derivePublicKey,
   generateKeyPair,
   getAgentDetail,
@@ -368,6 +367,7 @@ async function getSafetyStats(opts) {
   getToolCalls,
   isValidPrivateKey,
   judgeAction,
+  loadAgent,
   logToolCall,
   toPubkeyHex
 });

package/dist/index.d.cts

@@ -19,7 +19,7 @@ interface AgentAuth {
     pubkey: string;
     privkey: string;
 }
-declare function createAgent(privkey: string): AgentAuth;
+declare function loadAgent(privkey: string): AgentAuth;
 declare function toPubkeyHex(val: unknown): string;
 interface ClientOpts {
     endpoint?: string;
@@ -137,4 +137,4 @@ declare function getAgentDetail(agentPubkey: string, opts?: ClientOpts): Promise
 declare function getAgentPolicy(agentPubkey: string, opts?: ClientOpts): Promise<AgentPolicy>;
 declare function getSafetyStats(opts?: ClientOpts): Promise<Record<string, unknown>>;
 
-export { type AgentAuth, type ChainOpts, type ClientOpts, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, type HeldAction, type HeldActionReview, type JudgeOptions, type JudgeResult, type JudgmentStatus, type TierInfo, type ToolCallFull, type ToolCallRecord, type Verdict, createAgent, derivePublicKey, generateKeyPair, getAgentDetail, getAgentPolicy, getAgentToolCalls, getHeldActionReviews, getJudgmentStatus, getOrgTierInfo, getOrgToolCalls, getPendingHeldActions, getSafetyStats, getToolCallCount, getToolCallFull, getToolCalls, isValidPrivateKey, judgeAction, logToolCall, toPubkeyHex };
+export { type AgentAuth, type ChainOpts, type ClientOpts, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, type HeldAction, type HeldActionReview, type JudgeOptions, type JudgeResult, type JudgmentStatus, type TierInfo, type ToolCallFull, type ToolCallRecord, type Verdict, derivePublicKey, generateKeyPair, getAgentDetail, getAgentPolicy, getAgentToolCalls, getHeldActionReviews, getJudgmentStatus, getOrgTierInfo, getOrgToolCalls, getPendingHeldActions, getSafetyStats, getToolCallCount, getToolCallFull, getToolCalls, isValidPrivateKey, judgeAction, loadAgent, logToolCall, toPubkeyHex };

package/dist/index.d.ts

@@ -19,7 +19,7 @@ interface AgentAuth {
     pubkey: string;
     privkey: string;
 }
-declare function createAgent(privkey: string): AgentAuth;
+declare function loadAgent(privkey: string): AgentAuth;
 declare function toPubkeyHex(val: unknown): string;
 interface ClientOpts {
     endpoint?: string;
@@ -137,4 +137,4 @@ declare function getAgentDetail(agentPubkey: string, opts?: ClientOpts): Promise
 declare function getAgentPolicy(agentPubkey: string, opts?: ClientOpts): Promise<AgentPolicy>;
 declare function getSafetyStats(opts?: ClientOpts): Promise<Record<string, unknown>>;
 
-export { type AgentAuth, type ChainOpts, type ClientOpts, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, type HeldAction, type HeldActionReview, type JudgeOptions, type JudgeResult, type JudgmentStatus, type TierInfo, type ToolCallFull, type ToolCallRecord, type Verdict, createAgent, derivePublicKey, generateKeyPair, getAgentDetail, getAgentPolicy, getAgentToolCalls, getHeldActionReviews, getJudgmentStatus, getOrgTierInfo, getOrgToolCalls, getPendingHeldActions, getSafetyStats, getToolCallCount, getToolCallFull, getToolCalls, isValidPrivateKey, judgeAction, logToolCall, toPubkeyHex };
+export { type AgentAuth, type ChainOpts, type ClientOpts, DEFAULT_BLOCKCHAIN_RID, DEFAULT_CHROMIA_NODE_URLS, DEFAULT_ENDPOINT, type HeldAction, type HeldActionReview, type JudgeOptions, type JudgeResult, type JudgmentStatus, type TierInfo, type ToolCallFull, type ToolCallRecord, type Verdict, derivePublicKey, generateKeyPair, getAgentDetail, getAgentPolicy, getAgentToolCalls, getHeldActionReviews, getJudgmentStatus, getOrgTierInfo, getOrgToolCalls, getPendingHeldActions, getSafetyStats, getToolCallCount, getToolCallFull, getToolCalls, isValidPrivateKey, judgeAction, loadAgent, logToolCall, toPubkeyHex };

package/dist/index.js

@@ -25,7 +25,7 @@ function generateKeyPair() {
     pubKey: ecdh.getPublicKey("hex", "compressed")
   };
 }
-function createAgent(privkey) {
+function loadAgent(privkey) {
   const clean = privkey.replace(/^0x/, "").trim().toLowerCase();
   if (!isValidPrivateKey(clean)) {
     throw new Error(
@@ -293,7 +293,6 @@ export {
   DEFAULT_BLOCKCHAIN_RID,
   DEFAULT_CHROMIA_NODE_URLS,
   DEFAULT_ENDPOINT,
-  createAgent,
   derivePublicKey,
   generateKeyPair,
   getAgentDetail,
@@ -310,6 +309,7 @@ export {
   getToolCalls,
   isValidPrivateKey,
   judgeAction,
+  loadAgent,
   logToolCall,
   toPubkeyHex
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atbash/sdk",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "TypeScript SDK for the Atbash risk-engine / judge API",
   "homepage": "https://atbash.ai",
   "author": "Atbash",