@usepraxis/sdk 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Praxis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -84,13 +84,25 @@ toBaseUnits("500000000");            // 500000000n
 | Auth | `connect()`, `session()`, `logout()` |
 | Conversation | `ask()`, `send()`, `newThread()`, `signProposal()`, `cancelProposal()` |
 | Reads | `getPolicy()`, `getThreads()`, `getThread()`, `getProposal()`, `getActivity()`, `getAddressBook()`, `isThinking()`, `getVersion()` |
-| Policy (server-key) | `bootstrapPolicy()`, `updatePolicy()`, `configureToken()`, `prepareTokenAccounts()`, `revokeAgent()`, `rotateAgent()`, `addToAllowList()`, `removeFromAllowList()` |
+| Policy (server-key) | `bootstrapPolicy()`, `fundVault()`, `withdrawVault()`, `updatePolicy()`, `configureToken()`, `prepareTokenAccounts()`, `revokeAgent()`, `rotateAgent()`, `addToAllowList()`, `removeFromAllowList()`, `deleteAgent()` |
 | Owner (wallet-signed) | `buildOwnerTransaction()`, `submitOwnerTransaction()` |
 
+`session()` returns the current `SessionInfo` or `null` when signed out.
+
+> **Owner wallet-signed path.** `buildOwnerTransaction()` returns an *unsigned*
+> transaction; you sign it with a transaction-capable wallet (a browser wallet
+> adapter or `@solana/web3.js`) and submit the result with
+> `submitOwnerTransaction()`. The SDK's `keypairSigner` signs the sign-in
+> *message* only, not transactions — so a pure-Node owner-action flow must bring
+> its own transaction signer.
+
 ## Errors
 
 Non-2xx responses throw `PraxisApiError` with `.status`, `.type`, and helpers
-`.isAuth` / `.isRateLimited` / `.isInput`.
+`.isAuth` / `.isRateLimited` / `.isInput` / `.isNotFound` / `.isConfig` /
+`.isServer`. A client-side timeout or connection failure throws
+`PraxisApiError` with `.isTimeout` / `.isNetwork` (and `.status === 0`, with the
+original error on `.cause`). SDK-side misconfiguration throws `PraxisConfigError`.
 
 ```ts
 import { PraxisApiError } from "@usepraxis/sdk";

package/dist/index.cjs

@@ -15,8 +15,8 @@ var PraxisApiError = class _PraxisApiError extends Error {
   status;
   /** The backend error class name, e.g. "PraxisAuthError", "PraxisRateLimitError". */
   type;
-  constructor(status, type, message) {
-    super(message);
+  constructor(status, type, message, options) {
+    super(message, options);
     this.name = "PraxisApiError";
     this.status = status;
     this.type = type;
@@ -31,10 +31,30 @@ var PraxisApiError = class _PraxisApiError extends Error {
   get isInput() {
     return this.status === 400;
   }
+  /** Resource not found (404). */
+  get isNotFound() {
+    return this.status === 404;
+  }
+  /** Server reported a configuration problem (503) — usually transient. */
+  get isConfig() {
+    return this.status === 503;
+  }
+  /** The request timed out client-side before any HTTP response. */
+  get isTimeout() {
+    return this.status === 0 && this.type === "TimeoutError";
+  }
+  /** A connection-level failure (DNS, refused, TLS) before any HTTP response. */
+  get isNetwork() {
+    return this.status === 0 && this.type === "NetworkError";
+  }
+  /** Any server-side failure (HTTP >= 500). */
+  get isServer() {
+    return this.status >= 500;
+  }
 };
 var PraxisConfigError = class _PraxisConfigError extends Error {
-  constructor(message) {
-    super(message);
+  constructor(message, options) {
+    super(message, options);
     this.name = "PraxisConfigError";
     Object.setPrototypeOf(this, _PraxisConfigError.prototype);
   }
@@ -47,6 +67,7 @@ var PraxisClient = class {
   signer;
   fetchImpl;
   timeoutMs;
+  agentTimeoutMs;
   /** Manual cookie jar — Node's fetch does not persist Set-Cookie across calls. */
   sessionCookie;
   constructor(options) {
@@ -59,6 +80,7 @@ var PraxisClient = class {
     }
     this.fetchImpl = resolvedFetch;
     this.timeoutMs = options.timeoutMs ?? 2e4;
+    this.agentTimeoutMs = Math.max(options.agentTimeoutMs ?? 6e4, this.timeoutMs);
   }
   // --- auth ----------------------------------------------------------------
   /** The signer's wallet address, if a signer was provided. */
@@ -67,7 +89,8 @@ var PraxisClient = class {
   }
   /**
    * Run the wallet-ownership handshake: request a challenge, sign its message,
-   * verify it, and store the resulting session cookie. Idempotent.
+   * verify it, and store the resulting session cookie. Safe to call again to
+   * refresh the session (each call issues a new challenge + cookie).
    */
   async connect() {
     if (!this.signer) {
@@ -83,24 +106,37 @@ var PraxisClient = class {
       signature: bs582__default.default.encode(signature)
     });
   }
-  /** Current session, or `null` if not signed in. */
+  /**
+   * Current session, or `null` if not signed in. The endpoint answers `200`
+   * with `{ authenticated: false }` when signed out, so this normalizes both
+   * that shape and a `401` to `null`.
+   */
   async session() {
     try {
-      return await this.get("/auth/session");
+      const info = await this.get("/auth/session");
+      return info && info.authenticated ? info : null;
     } catch (error) {
       if (error instanceof PraxisApiError && error.isAuth) return null;
       throw error;
     }
   }
-  /** Clear the session (server-side cookie + local jar). */
+  /**
+   * Clear the session (server-side cookie + local jar). Idempotent: if there is
+   * no active session, the local jar is still cleared and no error is thrown.
+   */
   async logout() {
-    await this.request("DELETE", "/auth/session");
-    this.sessionCookie = void 0;
+    try {
+      await this.request("DELETE", "/auth/session");
+    } catch (error) {
+      if (!(error instanceof PraxisApiError && error.isAuth)) throw error;
+    } finally {
+      this.sessionCookie = void 0;
+    }
   }
   // --- conversation --------------------------------------------------------
   /** Send a line to the agent. Creates a thread when `threadId` is omitted. */
   send(text, threadId = null) {
-    return this.post("/send", { text, threadId });
+    return this.post("/send", { text, threadId }, this.agentTimeoutMs);
   }
   /**
    * Send a line and return the agent's reply in one call. The API resolves
@@ -155,6 +191,18 @@ var PraxisClient = class {
   bootstrapPolicy(fundLamports) {
     return this.post("/bootstrap-policy", fundLamports ? { fundLamports } : {});
   }
+  /** Deposit SOL (lamports, base-unit string) from the owner into the vault. */
+  fundVault(amount) {
+    return this.post("/fund-vault", { amount });
+  }
+  /** Withdraw SOL (lamports, base-unit string) from the vault to the owner. */
+  withdrawVault(amount) {
+    return this.post("/withdraw-vault", { amount });
+  }
+  /** Tear the agent down — drain the vault and close the policy. Irreversible. */
+  deleteAgent() {
+    return this.post("/delete-agent", {});
+  }
   updatePolicy(patch) {
     return this.post("/update-policy", { patch });
   }
@@ -177,11 +225,16 @@ var PraxisClient = class {
     return this.post("/remove-from-allow-list", { kind, address });
   }
   // --- owner wallet-signed transaction path --------------------------------
-  /** Build an unsigned owner transaction for the wallet to sign. */
+  /**
+   * Build an unsigned owner transaction for the wallet to sign. The caller signs
+   * the returned base64 `transaction` with a transaction-capable wallet, then
+   * passes the result to {@link submitOwnerTransaction}. (The SDK's
+   * `keypairSigner` signs sign-in messages only, not transactions.)
+   */
   buildOwnerTransaction(action) {
     return this.post("/owner/build", { action });
   }
-  /** Submit a wallet-signed owner transaction. */
+  /** Submit a wallet-signed owner transaction; resolves with its signature. */
   submitOwnerTransaction(signed) {
     return this.post("/owner/submit", signed);
   }
@@ -189,8 +242,8 @@ var PraxisClient = class {
   get(path, query) {
     return this.request("GET", path, { query });
   }
-  post(path, body) {
-    return this.request("POST", path, { body });
+  post(path, body, timeoutMs) {
+    return this.request("POST", path, { body, timeoutMs });
   }
   async request(method, path, opts = {}) {
     const url = new URL(this.baseUrl + API_PREFIX + path);
@@ -198,8 +251,9 @@ var PraxisClient = class {
     const headers = { accept: "application/json" };
     if (opts.body !== void 0) headers["content-type"] = "application/json";
     if (this.sessionCookie) headers["cookie"] = this.sessionCookie;
+    const timeoutMs = opts.timeoutMs ?? this.timeoutMs;
     const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
     let res;
     try {
       res = await this.fetchImpl(url.toString(), {
@@ -212,9 +266,13 @@ var PraxisClient = class {
       });
     } catch (error) {
       if (error instanceof Error && error.name === "AbortError") {
-        throw new PraxisApiError(0, "TimeoutError", `Praxis request timed out after ${this.timeoutMs}ms`);
+        throw new PraxisApiError(0, "TimeoutError", `Praxis request timed out after ${timeoutMs}ms`, {
+          cause: error
+        });
       }
-      throw error;
+      if (error instanceof PraxisApiError) throw error;
+      const detail = error instanceof Error ? error.message : String(error);
+      throw new PraxisApiError(0, "NetworkError", `Praxis request failed: ${detail}`, { cause: error });
     } finally {
       clearTimeout(timer);
     }
@@ -276,6 +334,9 @@ function normalizeSecret(secret) {
       throw new PraxisConfigError("secret key string must be base58-encoded");
     }
   } else if (Array.isArray(secret)) {
+    if (!secret.every((b) => Number.isInteger(b) && b >= 0 && b <= 255)) {
+      throw new PraxisConfigError("secret key array must contain only byte values (integers 0\u2013255)");
+    }
     bytes = Uint8Array.from(secret);
   } else {
     bytes = secret;
@@ -289,10 +350,19 @@ function normalizeSecret(secret) {
 }
 
 // src/units.ts
+var INTEGER_RE = /^-?\d+$/;
 function toBaseUnits(value) {
-  return typeof value === "bigint" ? value : BigInt(value.trim());
+  if (typeof value === "bigint") return value;
+  const trimmed = value.trim();
+  if (!INTEGER_RE.test(trimmed)) {
+    throw new Error(`toBaseUnits: expected an integer base-unit string, got "${value}"`);
+  }
+  return BigInt(trimmed);
 }
 function fromBaseUnits(value) {
+  if (typeof value === "number" && !Number.isSafeInteger(value)) {
+    throw new Error(`fromBaseUnits: number must be a safe integer, got ${value}`);
+  }
   return BigInt(value).toString();
 }
 function humanToBaseUnits(amount, decimals) {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/signer.ts","../src/units.ts","../src/types.ts"],"names":["bs58","nacl","ActionKind","RejectReason"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Thrown when the Praxis API returns a non-2xx response. The backend's error\n * envelope is `{ error: string, type: string }` with a meaningful HTTP status\n * (400 input, 401 auth, 404 not-found, 429 rate-limit, 503 config, 500 other).\n */\nexport class PraxisApiError extends Error {\n  readonly status: number;\n  /** The backend error class name, e.g. \"PraxisAuthError\", \"PraxisRateLimitError\". */\n  readonly type: string;\n\n  constructor(status: number, type: string, message: string) {\n    super(message);\n    this.name = \"PraxisApiError\";\n    this.status = status;\n    this.type = type;\n    // Restore prototype chain for instanceof across transpile targets.\n    Object.setPrototypeOf(this, PraxisApiError.prototype);\n  }\n\n  get isAuth(): boolean {\n    return this.status === 401;\n  }\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n  get isInput(): boolean {\n    return this.status === 400;\n  }\n}\n\n/** Thrown for SDK-side misconfiguration (no fetch, no signer, bad key, …). */\nexport class PraxisConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"PraxisConfigError\";\n    Object.setPrototypeOf(this, PraxisConfigError.prototype);\n  }\n}\n","import bs58 from \"bs58\";\n\nimport { PraxisApiError, PraxisConfigError } from \"./errors\";\nimport type { PraxisSigner } from \"./signer\";\nimport type {\n  ActionProposal,\n  ActivityEntry,\n  AddressBookEntry,\n  AgentMessage,\n  AllowListKind,\n  BaseUnitString,\n  OwnerAction,\n  PolicyUpdate,\n  PolicyView,\n  SessionInfo,\n  Thread,\n  TokenEnvelopeConfig,\n  UnsignedOwnerTransaction,\n  WalletChallenge,\n} from \"./types\";\n\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface PraxisClientOptions {\n  /** Base origin of the Praxis deployment, e.g. \"http://localhost:3000\". */\n  baseUrl: string;\n  /** Wallet signer for `connect()`. Optional if you only call public reads after an external login. */\n  signer?: PraxisSigner;\n  /** Custom fetch (defaults to global fetch). Required in runtimes without one. */\n  fetch?: FetchLike;\n  /** Per-request timeout in ms (default 20_000). */\n  timeoutMs?: number;\n}\n\n/** Result of {@link PraxisClient.ask} — the agent's reply, distilled. */\nexport interface AskResult {\n  threadId: string;\n  /** The agent's reply message (prose / clarify / proposal / research blocks). */\n  message: AgentMessage;\n  /** Any action proposals the agent produced, hydrated for convenience. */\n  proposals: ActionProposal[];\n}\n\nconst API_PREFIX = \"/api/praxis\";\n\n/**\n * Typed client for a hosted Praxis agent. The agent's LLM, scoped agent key, and\n * Aegis policy enforcement all live server-side; this SDK is an authenticated\n * client of the `/api/praxis/*` surface.\n *\n * ```ts\n * const praxis = new PraxisClient({ baseUrl, signer: keypairSigner(secret) });\n * await praxis.connect();\n * const { proposals } = await praxis.ask(\"send 0.5 SOL to maya\");\n * if (proposals[0]?.check.allowed) await praxis.signProposal(proposals[0].id);\n * ```\n */\nexport class PraxisClient {\n  private readonly baseUrl: string;\n  private readonly signer?: PraxisSigner;\n  private readonly fetchImpl: FetchLike;\n  private readonly timeoutMs: number;\n  /** Manual cookie jar — Node's fetch does not persist Set-Cookie across calls. */\n  private sessionCookie?: string;\n\n  constructor(options: PraxisClientOptions) {\n    if (!options.baseUrl) throw new PraxisConfigError(\"baseUrl is required\");\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.signer = options.signer;\n    const resolvedFetch = options.fetch ?? (globalThis.fetch as FetchLike | undefined);\n    if (!resolvedFetch) {\n      throw new PraxisConfigError(\"No fetch available; pass options.fetch (Node <18 or non-browser runtime).\");\n    }\n    this.fetchImpl = resolvedFetch;\n    this.timeoutMs = options.timeoutMs ?? 20_000;\n  }\n\n  // --- auth ----------------------------------------------------------------\n\n  /** The signer's wallet address, if a signer was provided. */\n  get address(): string | undefined {\n    return this.signer?.address;\n  }\n\n  /**\n   * Run the wallet-ownership handshake: request a challenge, sign its message,\n   * verify it, and store the resulting session cookie. Idempotent.\n   */\n  async connect(): Promise<SessionInfo> {\n    if (!this.signer) {\n      throw new PraxisConfigError(\"connect() requires a signer. Pass one to the constructor.\");\n    }\n    const challenge = await this.post<WalletChallenge>(\"/auth/challenge\", {\n      address: this.signer.address,\n    });\n    const signature = await this.signer.signMessage(new TextEncoder().encode(challenge.message));\n    return this.post<SessionInfo>(\"/auth/verify\", {\n      address: this.signer.address,\n      nonce: challenge.nonce,\n      signature: bs58.encode(signature),\n    });\n  }\n\n  /** Current session, or `null` if not signed in. */\n  async session(): Promise<SessionInfo | null> {\n    try {\n      return await this.get<SessionInfo>(\"/auth/session\");\n    } catch (error) {\n      if (error instanceof PraxisApiError && error.isAuth) return null;\n      throw error;\n    }\n  }\n\n  /** Clear the session (server-side cookie + local jar). */\n  async logout(): Promise<void> {\n    await this.request<unknown>(\"DELETE\", \"/auth/session\");\n    this.sessionCookie = undefined;\n  }\n\n  // --- conversation --------------------------------------------------------\n\n  /** Send a line to the agent. Creates a thread when `threadId` is omitted. */\n  send(text: string, threadId: string | null = null): Promise<{ threadId: string }> {\n    return this.post<{ threadId: string }>(\"/send\", { text, threadId });\n  }\n\n  /**\n   * Send a line and return the agent's reply in one call. The API resolves\n   * `send` only after the agent has finished, so this needs no polling.\n   */\n  async ask(text: string, threadId: string | null = null): Promise<AskResult> {\n    const { threadId: tid } = await this.send(text, threadId);\n    const thread = await this.getThread(tid);\n    const message = lastAgentMessage(thread);\n    if (!message) {\n      throw new PraxisApiError(500, \"Error\", \"Agent produced no reply message.\");\n    }\n    const proposalIds = message.blocks\n      .filter((b): b is Extract<typeof b, { type: \"proposal\" }> => b.type === \"proposal\")\n      .map((b) => b.proposalId);\n    const proposals = await Promise.all(proposalIds.map((id) => this.getProposal(id)));\n    return { threadId: tid, message, proposals };\n  }\n\n  newThread(threadId?: string): Promise<{ threadId: string }> {\n    return this.post<{ threadId: string }>(\"/new-thread\", threadId ? { threadId } : {});\n  }\n\n  signProposal(proposalId: string): Promise<void> {\n    return this.post<void>(\"/sign-proposal\", { proposalId });\n  }\n\n  cancelProposal(proposalId: string): Promise<void> {\n    return this.post<void>(\"/cancel-proposal\", { proposalId });\n  }\n\n  // --- reads ---------------------------------------------------------------\n\n  getThreads(): Promise<Thread[]> {\n    return this.get<Thread[]>(\"/get-threads\");\n  }\n  getThread(id: string): Promise<Thread> {\n    return this.get<Thread>(\"/get-thread\", { id });\n  }\n  getProposal(id: string): Promise<ActionProposal> {\n    return this.get<ActionProposal>(\"/get-proposal\", { id });\n  }\n  getPolicy(): Promise<PolicyView> {\n    return this.get<PolicyView>(\"/get-policy\");\n  }\n  getActivity(): Promise<ActivityEntry[]> {\n    return this.get<ActivityEntry[]>(\"/get-activity\");\n  }\n  getAddressBook(): Promise<AddressBookEntry[]> {\n    return this.get<AddressBookEntry[]>(\"/get-address-book\");\n  }\n  isThinking(threadId: string): Promise<boolean> {\n    return this.get<boolean>(\"/is-thinking\", { threadId });\n  }\n  getVersion(): Promise<number> {\n    return this.get<number>(\"/get-version\");\n  }\n\n  // --- policy / owner mutations (server-key mode) --------------------------\n\n  bootstrapPolicy(fundLamports?: BaseUnitString): Promise<void> {\n    return this.post<void>(\"/bootstrap-policy\", fundLamports ? { fundLamports } : {});\n  }\n  updatePolicy(patch: PolicyUpdate): Promise<void> {\n    return this.post<void>(\"/update-policy\", { patch });\n  }\n  configureToken(config: TokenEnvelopeConfig): Promise<void> {\n    return this.post<void>(\"/configure-token\", { config });\n  }\n  prepareTokenAccounts(recipientAddresses?: string[]): Promise<void> {\n    return this.post<void>(\"/prepare-token-accounts\", recipientAddresses ? { recipientAddresses } : {});\n  }\n  revokeAgent(): Promise<void> {\n    return this.post<void>(\"/revoke-agent\", {});\n  }\n  rotateAgent(): Promise<void> {\n    return this.post<void>(\"/rotate-agent\", {});\n  }\n  addToAllowList(kind: AllowListKind, address: string): Promise<void> {\n    return this.post<void>(\"/add-to-allow-list\", { kind, address });\n  }\n  removeFromAllowList(kind: AllowListKind, address: string): Promise<void> {\n    return this.post<void>(\"/remove-from-allow-list\", { kind, address });\n  }\n\n  // --- owner wallet-signed transaction path --------------------------------\n\n  /** Build an unsigned owner transaction for the wallet to sign. */\n  buildOwnerTransaction(action: OwnerAction): Promise<UnsignedOwnerTransaction> {\n    return this.post<UnsignedOwnerTransaction>(\"/owner/build\", { action });\n  }\n  /** Submit a wallet-signed owner transaction. */\n  submitOwnerTransaction(signed: UnsignedOwnerTransaction): Promise<{ sig: string }> {\n    return this.post<{ sig: string }>(\"/owner/submit\", signed);\n  }\n\n  // --- transport -----------------------------------------------------------\n\n  private get<T>(path: string, query?: Record<string, string>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  private post<T>(path: string, body: unknown): Promise<T> {\n    return this.request<T>(\"POST\", path, { body });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { body?: unknown; query?: Record<string, string> } = {},\n  ): Promise<T> {\n    const url = new URL(this.baseUrl + API_PREFIX + path);\n    for (const [k, v] of Object.entries(opts.query ?? {})) url.searchParams.set(k, v);\n\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    if (opts.body !== undefined) headers[\"content-type\"] = \"application/json\";\n    if (this.sessionCookie) headers[\"cookie\"] = this.sessionCookie;\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeoutMs);\n    let res: Response;\n    try {\n      res = await this.fetchImpl(url.toString(), {\n        method,\n        headers,\n        body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n        // Browser same-origin: let the HttpOnly cookie ride along.\n        credentials: \"include\",\n        signal: controller.signal,\n      } as RequestInit);\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new PraxisApiError(0, \"TimeoutError\", `Praxis request timed out after ${this.timeoutMs}ms`);\n      }\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n\n    this.captureCookie(res);\n\n    const text = await res.text();\n    const parsed = text ? safeJsonParse(text) : undefined;\n\n    if (!res.ok) {\n      const message =\n        (parsed && typeof parsed === \"object\" && \"error\" in parsed && typeof parsed.error === \"string\"\n          ? parsed.error\n          : undefined) ?? `Praxis API error ${res.status}`;\n      const type =\n        parsed && typeof parsed === \"object\" && \"type\" in parsed && typeof parsed.type === \"string\"\n          ? parsed.type\n          : \"Error\";\n      throw new PraxisApiError(res.status, type, message);\n    }\n\n    return parsed as T;\n  }\n\n  private captureCookie(res: Response): void {\n    // Node 18.14+ exposes getSetCookie(); fall back to the combined header.\n    const anyHeaders = res.headers as Headers & { getSetCookie?: () => string[] };\n    const cookies = anyHeaders.getSetCookie?.() ?? splitSetCookie(res.headers.get(\"set-cookie\"));\n    for (const cookie of cookies) {\n      const [pair] = cookie.split(\";\");\n      if (pair && pair.trim().startsWith(\"praxis_session=\")) {\n        this.sessionCookie = pair.trim();\n      }\n    }\n  }\n}\n\nfunction lastAgentMessage(thread: Thread): AgentMessage | undefined {\n  for (let i = thread.messages.length - 1; i >= 0; i--) {\n    const m = thread.messages[i];\n    if (m.role === \"agent\") return m;\n  }\n  return undefined;\n}\n\nfunction safeJsonParse(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction splitSetCookie(header: string | null): string[] {\n  if (!header) return [];\n  // Split on commas that precede a new cookie name=value pair, not commas inside\n  // Expires dates (\"Wed, 01 Jan ...\").\n  return header.split(/,(?=\\s*[^;,\\s]+=)/);\n}\n","import bs58 from \"bs58\";\nimport nacl from \"tweetnacl\";\n\nimport { PraxisConfigError } from \"./errors\";\n\n/**\n * Signs the wallet-ownership challenge. Implement this to bridge any wallet:\n * - Node / backend agents: use {@link keypairSigner} with a secret key.\n * - Browser: wrap a wallet-adapter, e.g.\n *   `{ address: wallet.publicKey.toBase58(), signMessage: (m) => wallet.signMessage(m) }`.\n *\n * `signMessage` must return the raw 64-byte Ed25519 signature; the SDK base58-\n * encodes it for the API.\n */\nexport interface PraxisSigner {\n  /** base58-encoded Solana public key. */\n  readonly address: string;\n  signMessage(message: Uint8Array): Promise<Uint8Array> | Uint8Array;\n}\n\nexport type SecretKeyInput = Uint8Array | number[] | string;\n\n/**\n * Build a {@link PraxisSigner} from a Solana secret key — a 64-byte keypair or a\n * 32-byte seed, as raw bytes, a number array, or a base58 string (Phantom /\n * `solana-keygen` export). Node and browser friendly; no `@solana/web3.js`\n * dependency.\n */\nexport function keypairSigner(secret: SecretKeyInput): PraxisSigner {\n  const bytes = normalizeSecret(secret);\n  const pair =\n    bytes.length === 64\n      ? nacl.sign.keyPair.fromSecretKey(bytes)\n      : nacl.sign.keyPair.fromSeed(bytes);\n  const address = bs58.encode(pair.publicKey);\n  const secretKey = pair.secretKey;\n\n  return {\n    address,\n    signMessage: (message: Uint8Array) => nacl.sign.detached(message, secretKey),\n  };\n}\n\nfunction normalizeSecret(secret: SecretKeyInput): Uint8Array {\n  let bytes: Uint8Array;\n  if (typeof secret === \"string\") {\n    try {\n      bytes = bs58.decode(secret.trim());\n    } catch {\n      throw new PraxisConfigError(\"secret key string must be base58-encoded\");\n    }\n  } else if (Array.isArray(secret)) {\n    bytes = Uint8Array.from(secret);\n  } else {\n    bytes = secret;\n  }\n\n  if (bytes.length !== 64 && bytes.length !== 32) {\n    throw new PraxisConfigError(\n      `secret key must be 64 bytes (keypair) or 32 bytes (seed), got ${bytes.length}`,\n    );\n  }\n  return bytes;\n}\n","/**\n * Money helpers. Praxis money crosses the wire as decimal strings of integer\n * base units (lamports / token base units). These convert to/from `bigint` and\n * human decimal amounts without floats.\n */\n\n/** Parse a base-unit string (or bigint) into a bigint. */\nexport function toBaseUnits(value: string | bigint): bigint {\n  return typeof value === \"bigint\" ? value : BigInt(value.trim());\n}\n\n/** Serialize a bigint (or number of whole base units) into a base-unit string. */\nexport function fromBaseUnits(value: bigint | number): string {\n  return BigInt(value).toString();\n}\n\n/** Convert a human decimal amount (\"0.5\") into base units for `decimals` places. */\nexport function humanToBaseUnits(amount: string, decimals: number): string {\n  const trimmed = amount.trim();\n  if (!/^\\d+(\\.\\d+)?$/.test(trimmed)) {\n    throw new Error(`invalid decimal amount: \"${amount}\"`);\n  }\n  const [whole, fraction = \"\"] = trimmed.split(\".\");\n  if (fraction.length > decimals) {\n    throw new Error(`\"${amount}\" has more than ${decimals} decimal places`);\n  }\n  const padded = fraction.padEnd(decimals, \"0\");\n  return (BigInt(whole) * 10n ** BigInt(decimals) + BigInt(padded || \"0\")).toString();\n}\n\n/** Convert base units into a human decimal string for `decimals` places. */\nexport function baseUnitsToHuman(value: string | bigint, decimals: number): string {\n  const units = toBaseUnits(value);\n  const negative = units < 0n;\n  const abs = negative ? -units : units;\n  const divisor = 10n ** BigInt(decimals);\n  const whole = abs / divisor;\n  const fraction = (abs % divisor).toString().padStart(decimals, \"0\").replace(/0+$/, \"\");\n  const sign = negative ? \"-\" : \"\";\n  return fraction ? `${sign}${whole}.${fraction}` : `${sign}${whole}`;\n}\n","/**\n * Praxis SDK wire types — the JSON contract exposed by `/api/praxis/*`.\n *\n * MONEY RULE: every monetary value crosses the wire as a **decimal string of\n * integer base units** (lamports for SOL, token base units for SPL) — never a\n * float. On the server these are `bigint`; the API serializes them to strings.\n * The SDK keeps them as strings and leaves bigint conversion to the caller\n * (see `toBaseUnits` / `fromBaseUnits` in `units.ts`). This file intentionally\n * mirrors `@praxis/shared` but with `string` money, so the SDK ships a\n * self-contained type contract with no internal workspace dependency.\n */\n\n/** A base58-encoded Solana public key. */\nexport type Address = string;\n\n/** Integer base units as a decimal string (e.g. \"500000000\" = 0.5 SOL). */\nexport type BaseUnitString = string;\n\n/** Mirrors the on-chain `ActionKind` discriminants. */\nexport enum ActionKind {\n  Transfer = 0,\n  TransferSpl = 1,\n}\n\n/** Why Aegis rejected an agent action. Mirrors the on-chain enum order. */\nexport enum RejectReason {\n  Unauthorized = 0,\n  Paused = 1,\n  Expired = 2,\n  OverPerTx = 3,\n  OverDaily = 4,\n  RecipientNotAllowed = 5,\n  Overflow = 6,\n  MintNotAllowed = 7,\n}\n\n// --- Auth ------------------------------------------------------------------\n\n/** Returned by `POST /auth/challenge`; sign `message` to prove wallet ownership. */\nexport interface WalletChallenge {\n  address: Address;\n  /** Opaque signed token echoed back to `/auth/verify`. */\n  nonce: string;\n  /** The exact UTF-8 string the wallet must sign. */\n  message: string;\n  /** ISO-8601 expiry of the challenge. */\n  expiresAt: string;\n}\n\nexport interface SessionInfo {\n  authenticated: boolean;\n  walletAddress: Address;\n}\n\n// --- Tokens / address book -------------------------------------------------\n\nexport interface TokenInfo {\n  symbol: string;\n  mint: Address;\n  decimals: number;\n  verified: boolean;\n}\n\nexport interface AddressBookEntry {\n  label: string;\n  name: string;\n  address: Address;\n  note?: string;\n}\n\n// --- Policy ----------------------------------------------------------------\n\nexport interface PolicyView {\n  address: Address;\n  owner: Address;\n  /** `11111…1111` (default) once the agent key is revoked. */\n  agentAuthority: Address;\n  maxPerTx: BaseUnitString;\n  dailyLimit: BaseUnitString;\n  spentToday: BaseUnitString;\n  dayStartTs: number;\n  allowedPrograms: Address[];\n  /** Empty array means \"any recipient allowed\". */\n  allowedRecipients: Address[];\n  allowedMints: Address[];\n  expiryTs: number;\n  paused: boolean;\n  vaultBalance: BaseUnitString;\n  tokenMint: Address;\n  tokenMaxPerTx: BaseUnitString;\n  tokenDailyLimit: BaseUnitString;\n  tokenSpentToday: BaseUnitString;\n  tokenDayStartTs: number;\n}\n\nexport interface PolicyCheckResult {\n  allowed: boolean;\n  reason?: string;\n  reasonCode?: RejectReason;\n  spentToday: BaseUnitString;\n  dailyLimit: BaseUnitString;\n  remaining: BaseUnitString;\n}\n\nexport interface PolicyUpdate {\n  maxPerTx?: BaseUnitString;\n  dailyLimit?: BaseUnitString;\n  expiryTs?: number;\n  paused?: boolean;\n}\n\nexport interface TokenEnvelopeConfig {\n  tokenMint: Address;\n  tokenMaxPerTx: BaseUnitString;\n  tokenDailyLimit: BaseUnitString;\n}\n\nexport type AllowListKind = \"programs\" | \"recipients\" | \"mints\";\n\n// --- Proposals -------------------------------------------------------------\n\nexport interface TransferDetail {\n  kind: \"transfer\";\n  amount: BaseUnitString;\n  asset: TokenInfo;\n  recipientName: string;\n  recipientAddress: Address;\n  recipientNote?: string;\n}\n\nexport interface SwapDetail {\n  kind: \"swap\";\n  amountIn: BaseUnitString;\n  assetIn: TokenInfo;\n  estAmountOut: BaseUnitString;\n  assetOut: TokenInfo;\n  route: string;\n  priceImpactBps: number;\n}\n\nexport type ProposalDetail = TransferDetail | SwapDetail;\n\nexport type ProposalState = \"pending\" | \"signing\" | \"signed\" | \"blocked\" | \"cancelled\";\n\nexport interface ActionProposal {\n  id: string;\n  detail: ProposalDetail;\n  networkFee: BaseUnitString;\n  simulation: string;\n  check: PolicyCheckResult;\n  state: ProposalState;\n  sig?: string;\n}\n\n// --- Conversation ----------------------------------------------------------\n\nexport interface ClarifyOption {\n  label: string;\n  value: string;\n  hint?: string;\n}\n\nexport interface ResearchMetric {\n  label: string;\n  value: string;\n  trend?: \"up\" | \"down\" | \"flat\";\n}\n\nexport interface ResearchData {\n  token: string;\n  mint: Address;\n  metrics: ResearchMetric[];\n  summary: string;\n}\n\nexport type AgentBlock =\n  | { type: \"prose\"; text: string }\n  | { type: \"clarify\"; text: string; options: ClarifyOption[] }\n  | { type: \"proposal\"; text: string; proposalId: string }\n  | { type: \"research\"; text: string; data: ResearchData };\n\nexport type UserMessage = { id: string; role: \"user\"; ts: number; text: string };\nexport type AgentMessage = { id: string; role: \"agent\"; ts: number; blocks: AgentBlock[] };\nexport type Message = UserMessage | AgentMessage;\n\nexport interface Thread {\n  id: string;\n  title: string;\n  messages: Message[];\n  updatedAt: number;\n}\n\n// --- Activity --------------------------------------------------------------\n\nexport interface ActivityEntry {\n  id: string;\n  kind: \"transfer\" | \"swap\";\n  label: string;\n  asset: string;\n  amount: BaseUnitString;\n  decimals: number;\n  result: \"allowed\" | \"rejected\";\n  reason?: string;\n  reasonCode?: RejectReason;\n  ts: number;\n  sig?: string;\n}\n\n// --- Owner transactions (wallet-signed path) -------------------------------\n\nexport interface UnsignedOwnerTransaction {\n  /** base64-encoded unsigned transaction for the owner wallet to sign. */\n  transaction: string;\n  blockhash: string;\n  lastValidBlockHeight: number;\n}\n\n/** Typed owner action accepted by `POST /owner/build`. */\nexport type OwnerAction =\n  | { kind: \"bootstrapPolicy\"; fundLamports?: BaseUnitString }\n  | { kind: \"fundVault\"; amount: BaseUnitString }\n  | { kind: \"withdrawVault\"; amount: BaseUnitString }\n  | { kind: \"closePolicy\" }\n  | { kind: \"revoke\" }\n  | { kind: \"rotate\" }\n  | { kind: \"updatePolicy\"; patch: PolicyUpdate }\n  | { kind: \"allowList\"; listKind: AllowListKind; address: Address; mode: \"add\" | \"remove\" };\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts","../src/signer.ts","../src/units.ts","../src/types.ts"],"names":["bs58","nacl","ActionKind","RejectReason"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Thrown when the Praxis API returns a non-2xx response. The backend's error\n * envelope is `{ error: string, type: string }` with a meaningful HTTP status\n * (400 input, 401 auth, 404 not-found, 429 rate-limit, 503 config, 500 other).\n */\nexport class PraxisApiError extends Error {\n  readonly status: number;\n  /** The backend error class name, e.g. \"PraxisAuthError\", \"PraxisRateLimitError\". */\n  readonly type: string;\n\n  constructor(status: number, type: string, message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"PraxisApiError\";\n    this.status = status;\n    this.type = type;\n    // Restore prototype chain for instanceof across transpile targets.\n    Object.setPrototypeOf(this, PraxisApiError.prototype);\n  }\n\n  get isAuth(): boolean {\n    return this.status === 401;\n  }\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n  get isInput(): boolean {\n    return this.status === 400;\n  }\n  /** Resource not found (404). */\n  get isNotFound(): boolean {\n    return this.status === 404;\n  }\n  /** Server reported a configuration problem (503) — usually transient. */\n  get isConfig(): boolean {\n    return this.status === 503;\n  }\n  /** The request timed out client-side before any HTTP response. */\n  get isTimeout(): boolean {\n    return this.status === 0 && this.type === \"TimeoutError\";\n  }\n  /** A connection-level failure (DNS, refused, TLS) before any HTTP response. */\n  get isNetwork(): boolean {\n    return this.status === 0 && this.type === \"NetworkError\";\n  }\n  /** Any server-side failure (HTTP >= 500). */\n  get isServer(): boolean {\n    return this.status >= 500;\n  }\n}\n\n/** Thrown for SDK-side misconfiguration (no fetch, no signer, bad key, …). */\nexport class PraxisConfigError extends Error {\n  constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"PraxisConfigError\";\n    Object.setPrototypeOf(this, PraxisConfigError.prototype);\n  }\n}\n","import bs58 from \"bs58\";\n\nimport { PraxisApiError, PraxisConfigError } from \"./errors\";\nimport type { PraxisSigner } from \"./signer\";\nimport type {\n  ActionProposal,\n  ActivityEntry,\n  AddressBookEntry,\n  AgentMessage,\n  AllowListKind,\n  BaseUnitString,\n  OwnerAction,\n  PolicyUpdate,\n  PolicyView,\n  SessionInfo,\n  SignedOwnerTransaction,\n  Thread,\n  TokenEnvelopeConfig,\n  UnsignedOwnerTransaction,\n  WalletChallenge,\n} from \"./types\";\n\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface PraxisClientOptions {\n  /** Base origin of the Praxis deployment, e.g. \"http://localhost:3000\". */\n  baseUrl: string;\n  /** Wallet signer for `connect()`. Optional if you only call public reads after an external login. */\n  signer?: PraxisSigner;\n  /** Custom fetch (defaults to global fetch). Required in runtimes without one. */\n  fetch?: FetchLike;\n  /** Per-request timeout in ms for reads/mutations (default 20_000). */\n  timeoutMs?: number;\n  /**\n   * Per-request timeout in ms for agent conversation turns (`send`/`ask`), which\n   * block on the full LLM round-trip (default 60_000). Effective value is never\n   * below `timeoutMs`.\n   */\n  agentTimeoutMs?: number;\n}\n\n/** Result of {@link PraxisClient.ask} — the agent's reply, distilled. */\nexport interface AskResult {\n  threadId: string;\n  /** The agent's reply message (prose / clarify / proposal / research blocks). */\n  message: AgentMessage;\n  /** Any action proposals the agent produced, hydrated for convenience. */\n  proposals: ActionProposal[];\n}\n\nconst API_PREFIX = \"/api/praxis\";\n\n/**\n * Typed client for a hosted Praxis agent. The agent's LLM, scoped agent key, and\n * Aegis policy enforcement all live server-side; this SDK is an authenticated\n * client of the `/api/praxis/*` surface.\n *\n * ```ts\n * const praxis = new PraxisClient({ baseUrl, signer: keypairSigner(secret) });\n * await praxis.connect();\n * const { proposals } = await praxis.ask(\"send 0.5 SOL to maya\");\n * if (proposals[0]?.check.allowed) await praxis.signProposal(proposals[0].id);\n * ```\n */\nexport class PraxisClient {\n  private readonly baseUrl: string;\n  private readonly signer?: PraxisSigner;\n  private readonly fetchImpl: FetchLike;\n  private readonly timeoutMs: number;\n  private readonly agentTimeoutMs: number;\n  /** Manual cookie jar — Node's fetch does not persist Set-Cookie across calls. */\n  private sessionCookie?: string;\n\n  constructor(options: PraxisClientOptions) {\n    if (!options.baseUrl) throw new PraxisConfigError(\"baseUrl is required\");\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\");\n    this.signer = options.signer;\n    const resolvedFetch = options.fetch ?? (globalThis.fetch as FetchLike | undefined);\n    if (!resolvedFetch) {\n      throw new PraxisConfigError(\"No fetch available; pass options.fetch (Node <18 or non-browser runtime).\");\n    }\n    this.fetchImpl = resolvedFetch;\n    this.timeoutMs = options.timeoutMs ?? 20_000;\n    this.agentTimeoutMs = Math.max(options.agentTimeoutMs ?? 60_000, this.timeoutMs);\n  }\n\n  // --- auth ----------------------------------------------------------------\n\n  /** The signer's wallet address, if a signer was provided. */\n  get address(): string | undefined {\n    return this.signer?.address;\n  }\n\n  /**\n   * Run the wallet-ownership handshake: request a challenge, sign its message,\n   * verify it, and store the resulting session cookie. Safe to call again to\n   * refresh the session (each call issues a new challenge + cookie).\n   */\n  async connect(): Promise<SessionInfo> {\n    if (!this.signer) {\n      throw new PraxisConfigError(\"connect() requires a signer. Pass one to the constructor.\");\n    }\n    const challenge = await this.post<WalletChallenge>(\"/auth/challenge\", {\n      address: this.signer.address,\n    });\n    const signature = await this.signer.signMessage(new TextEncoder().encode(challenge.message));\n    return this.post<SessionInfo>(\"/auth/verify\", {\n      address: this.signer.address,\n      nonce: challenge.nonce,\n      signature: bs58.encode(signature),\n    });\n  }\n\n  /**\n   * Current session, or `null` if not signed in. The endpoint answers `200`\n   * with `{ authenticated: false }` when signed out, so this normalizes both\n   * that shape and a `401` to `null`.\n   */\n  async session(): Promise<SessionInfo | null> {\n    try {\n      const info = await this.get<SessionInfo>(\"/auth/session\");\n      return info && info.authenticated ? info : null;\n    } catch (error) {\n      if (error instanceof PraxisApiError && error.isAuth) return null;\n      throw error;\n    }\n  }\n\n  /**\n   * Clear the session (server-side cookie + local jar). Idempotent: if there is\n   * no active session, the local jar is still cleared and no error is thrown.\n   */\n  async logout(): Promise<void> {\n    try {\n      await this.request<unknown>(\"DELETE\", \"/auth/session\");\n    } catch (error) {\n      // Already signed out (missing / expired session) is a successful logout.\n      if (!(error instanceof PraxisApiError && error.isAuth)) throw error;\n    } finally {\n      this.sessionCookie = undefined;\n    }\n  }\n\n  // --- conversation --------------------------------------------------------\n\n  /** Send a line to the agent. Creates a thread when `threadId` is omitted. */\n  send(text: string, threadId: string | null = null): Promise<{ threadId: string }> {\n    // Conversation turns block on the agent's LLM round-trip — give them the\n    // longer agent budget rather than the shorter read/mutation timeout.\n    return this.post<{ threadId: string }>(\"/send\", { text, threadId }, this.agentTimeoutMs);\n  }\n\n  /**\n   * Send a line and return the agent's reply in one call. The API resolves\n   * `send` only after the agent has finished, so this needs no polling.\n   */\n  async ask(text: string, threadId: string | null = null): Promise<AskResult> {\n    const { threadId: tid } = await this.send(text, threadId);\n    const thread = await this.getThread(tid);\n    const message = lastAgentMessage(thread);\n    if (!message) {\n      throw new PraxisApiError(500, \"Error\", \"Agent produced no reply message.\");\n    }\n    const proposalIds = message.blocks\n      .filter((b): b is Extract<typeof b, { type: \"proposal\" }> => b.type === \"proposal\")\n      .map((b) => b.proposalId);\n    const proposals = await Promise.all(proposalIds.map((id) => this.getProposal(id)));\n    return { threadId: tid, message, proposals };\n  }\n\n  newThread(threadId?: string): Promise<{ threadId: string }> {\n    return this.post<{ threadId: string }>(\"/new-thread\", threadId ? { threadId } : {});\n  }\n\n  signProposal(proposalId: string): Promise<void> {\n    return this.post<void>(\"/sign-proposal\", { proposalId });\n  }\n\n  cancelProposal(proposalId: string): Promise<void> {\n    return this.post<void>(\"/cancel-proposal\", { proposalId });\n  }\n\n  // --- reads ---------------------------------------------------------------\n\n  getThreads(): Promise<Thread[]> {\n    return this.get<Thread[]>(\"/get-threads\");\n  }\n  getThread(id: string): Promise<Thread> {\n    return this.get<Thread>(\"/get-thread\", { id });\n  }\n  getProposal(id: string): Promise<ActionProposal> {\n    return this.get<ActionProposal>(\"/get-proposal\", { id });\n  }\n  getPolicy(): Promise<PolicyView> {\n    return this.get<PolicyView>(\"/get-policy\");\n  }\n  getActivity(): Promise<ActivityEntry[]> {\n    return this.get<ActivityEntry[]>(\"/get-activity\");\n  }\n  getAddressBook(): Promise<AddressBookEntry[]> {\n    return this.get<AddressBookEntry[]>(\"/get-address-book\");\n  }\n  isThinking(threadId: string): Promise<boolean> {\n    return this.get<boolean>(\"/is-thinking\", { threadId });\n  }\n  getVersion(): Promise<number> {\n    return this.get<number>(\"/get-version\");\n  }\n\n  // --- policy / owner mutations (server-key mode) --------------------------\n\n  bootstrapPolicy(fundLamports?: BaseUnitString): Promise<void> {\n    return this.post<void>(\"/bootstrap-policy\", fundLamports ? { fundLamports } : {});\n  }\n  /** Deposit SOL (lamports, base-unit string) from the owner into the vault. */\n  fundVault(amount: BaseUnitString): Promise<void> {\n    return this.post<void>(\"/fund-vault\", { amount });\n  }\n  /** Withdraw SOL (lamports, base-unit string) from the vault to the owner. */\n  withdrawVault(amount: BaseUnitString): Promise<void> {\n    return this.post<void>(\"/withdraw-vault\", { amount });\n  }\n  /** Tear the agent down — drain the vault and close the policy. Irreversible. */\n  deleteAgent(): Promise<void> {\n    return this.post<void>(\"/delete-agent\", {});\n  }\n  updatePolicy(patch: PolicyUpdate): Promise<void> {\n    return this.post<void>(\"/update-policy\", { patch });\n  }\n  configureToken(config: TokenEnvelopeConfig): Promise<void> {\n    return this.post<void>(\"/configure-token\", { config });\n  }\n  prepareTokenAccounts(recipientAddresses?: string[]): Promise<void> {\n    return this.post<void>(\"/prepare-token-accounts\", recipientAddresses ? { recipientAddresses } : {});\n  }\n  revokeAgent(): Promise<void> {\n    return this.post<void>(\"/revoke-agent\", {});\n  }\n  rotateAgent(): Promise<void> {\n    return this.post<void>(\"/rotate-agent\", {});\n  }\n  addToAllowList(kind: AllowListKind, address: string): Promise<void> {\n    return this.post<void>(\"/add-to-allow-list\", { kind, address });\n  }\n  removeFromAllowList(kind: AllowListKind, address: string): Promise<void> {\n    return this.post<void>(\"/remove-from-allow-list\", { kind, address });\n  }\n\n  // --- owner wallet-signed transaction path --------------------------------\n\n  /**\n   * Build an unsigned owner transaction for the wallet to sign. The caller signs\n   * the returned base64 `transaction` with a transaction-capable wallet, then\n   * passes the result to {@link submitOwnerTransaction}. (The SDK's\n   * `keypairSigner` signs sign-in messages only, not transactions.)\n   */\n  buildOwnerTransaction(action: OwnerAction): Promise<UnsignedOwnerTransaction> {\n    return this.post<UnsignedOwnerTransaction>(\"/owner/build\", { action });\n  }\n  /** Submit a wallet-signed owner transaction; resolves with its signature. */\n  submitOwnerTransaction(signed: SignedOwnerTransaction): Promise<{ sig: string }> {\n    return this.post<{ sig: string }>(\"/owner/submit\", signed);\n  }\n\n  // --- transport -----------------------------------------------------------\n\n  private get<T>(path: string, query?: Record<string, string>): Promise<T> {\n    return this.request<T>(\"GET\", path, { query });\n  }\n\n  private post<T>(path: string, body: unknown, timeoutMs?: number): Promise<T> {\n    return this.request<T>(\"POST\", path, { body, timeoutMs });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { body?: unknown; query?: Record<string, string>; timeoutMs?: number } = {},\n  ): Promise<T> {\n    const url = new URL(this.baseUrl + API_PREFIX + path);\n    for (const [k, v] of Object.entries(opts.query ?? {})) url.searchParams.set(k, v);\n\n    const headers: Record<string, string> = { accept: \"application/json\" };\n    if (opts.body !== undefined) headers[\"content-type\"] = \"application/json\";\n    if (this.sessionCookie) headers[\"cookie\"] = this.sessionCookie;\n\n    const timeoutMs = opts.timeoutMs ?? this.timeoutMs;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    let res: Response;\n    try {\n      res = await this.fetchImpl(url.toString(), {\n        method,\n        headers,\n        body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n        // Browser same-origin: let the HttpOnly cookie ride along.\n        credentials: \"include\",\n        signal: controller.signal,\n      } as RequestInit);\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new PraxisApiError(0, \"TimeoutError\", `Praxis request timed out after ${timeoutMs}ms`, {\n          cause: error,\n        });\n      }\n      if (error instanceof PraxisApiError) throw error;\n      // Connection-level failures (DNS, ECONNREFUSED, TLS) surface uniformly as\n      // a PraxisApiError so callers have a single error type to catch.\n      const detail = error instanceof Error ? error.message : String(error);\n      throw new PraxisApiError(0, \"NetworkError\", `Praxis request failed: ${detail}`, { cause: error });\n    } finally {\n      clearTimeout(timer);\n    }\n\n    this.captureCookie(res);\n\n    const text = await res.text();\n    const parsed = text ? safeJsonParse(text) : undefined;\n\n    if (!res.ok) {\n      const message =\n        (parsed && typeof parsed === \"object\" && \"error\" in parsed && typeof parsed.error === \"string\"\n          ? parsed.error\n          : undefined) ?? `Praxis API error ${res.status}`;\n      const type =\n        parsed && typeof parsed === \"object\" && \"type\" in parsed && typeof parsed.type === \"string\"\n          ? parsed.type\n          : \"Error\";\n      throw new PraxisApiError(res.status, type, message);\n    }\n\n    return parsed as T;\n  }\n\n  private captureCookie(res: Response): void {\n    // Node 18.14+ exposes getSetCookie(); fall back to the combined header.\n    const anyHeaders = res.headers as Headers & { getSetCookie?: () => string[] };\n    const cookies = anyHeaders.getSetCookie?.() ?? splitSetCookie(res.headers.get(\"set-cookie\"));\n    for (const cookie of cookies) {\n      const [pair] = cookie.split(\";\");\n      if (pair && pair.trim().startsWith(\"praxis_session=\")) {\n        this.sessionCookie = pair.trim();\n      }\n    }\n  }\n}\n\nfunction lastAgentMessage(thread: Thread): AgentMessage | undefined {\n  for (let i = thread.messages.length - 1; i >= 0; i--) {\n    const m = thread.messages[i];\n    if (m.role === \"agent\") return m;\n  }\n  return undefined;\n}\n\nfunction safeJsonParse(text: string): unknown {\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nfunction splitSetCookie(header: string | null): string[] {\n  if (!header) return [];\n  // Split on commas that precede a new cookie name=value pair, not commas inside\n  // Expires dates (\"Wed, 01 Jan ...\").\n  return header.split(/,(?=\\s*[^;,\\s]+=)/);\n}\n","import bs58 from \"bs58\";\nimport nacl from \"tweetnacl\";\n\nimport { PraxisConfigError } from \"./errors\";\n\n/**\n * Signs the wallet-ownership challenge. Implement this to bridge any wallet:\n * - Node / backend agents: use {@link keypairSigner} with a secret key.\n * - Browser: wrap a wallet-adapter, e.g.\n *   `{ address: wallet.publicKey.toBase58(), signMessage: (m) => wallet.signMessage(m) }`.\n *\n * `signMessage` must return the raw 64-byte Ed25519 signature; the SDK base58-\n * encodes it for the API.\n */\nexport interface PraxisSigner {\n  /** base58-encoded Solana public key. */\n  readonly address: string;\n  signMessage(message: Uint8Array): Promise<Uint8Array> | Uint8Array;\n}\n\nexport type SecretKeyInput = Uint8Array | number[] | string;\n\n/**\n * Build a {@link PraxisSigner} from a Solana secret key — a 64-byte keypair or a\n * 32-byte seed, as raw bytes, a number array, or a base58 string (Phantom /\n * `solana-keygen` export). Node and browser friendly; no `@solana/web3.js`\n * dependency.\n */\nexport function keypairSigner(secret: SecretKeyInput): PraxisSigner {\n  const bytes = normalizeSecret(secret);\n  const pair =\n    bytes.length === 64\n      ? nacl.sign.keyPair.fromSecretKey(bytes)\n      : nacl.sign.keyPair.fromSeed(bytes);\n  const address = bs58.encode(pair.publicKey);\n  const secretKey = pair.secretKey;\n\n  return {\n    address,\n    signMessage: (message: Uint8Array) => nacl.sign.detached(message, secretKey),\n  };\n}\n\nfunction normalizeSecret(secret: SecretKeyInput): Uint8Array {\n  let bytes: Uint8Array;\n  if (typeof secret === \"string\") {\n    try {\n      bytes = bs58.decode(secret.trim());\n    } catch {\n      throw new PraxisConfigError(\"secret key string must be base58-encoded\");\n    }\n  } else if (Array.isArray(secret)) {\n    if (!secret.every((b) => Number.isInteger(b) && b >= 0 && b <= 255)) {\n      throw new PraxisConfigError(\"secret key array must contain only byte values (integers 0–255)\");\n    }\n    bytes = Uint8Array.from(secret);\n  } else {\n    bytes = secret;\n  }\n\n  if (bytes.length !== 64 && bytes.length !== 32) {\n    throw new PraxisConfigError(\n      `secret key must be 64 bytes (keypair) or 32 bytes (seed), got ${bytes.length}`,\n    );\n  }\n  return bytes;\n}\n","/**\n * Money helpers. Praxis money crosses the wire as decimal strings of integer\n * base units (lamports / token base units). These convert to/from `bigint` and\n * human decimal amounts without floats.\n */\n\n/** An optionally-signed decimal integer — the only valid base-unit string. */\nconst INTEGER_RE = /^-?\\d+$/;\n\n/**\n * Parse a base-unit string (or bigint) into a bigint. Rejects floats, hex, and\n * other non-decimal-integer input so the SDK and server agree on what a valid\n * base-unit string is (mirrors the server's `parseUnits`).\n */\nexport function toBaseUnits(value: string | bigint): bigint {\n  if (typeof value === \"bigint\") return value;\n  const trimmed = value.trim();\n  if (!INTEGER_RE.test(trimmed)) {\n    throw new Error(`toBaseUnits: expected an integer base-unit string, got \"${value}\"`);\n  }\n  return BigInt(trimmed);\n}\n\n/**\n * Serialize a bigint (or a whole, safe-integer number of base units) into a\n * base-unit string. A non-integer or unsafe `number` throws rather than\n * silently losing precision.\n */\nexport function fromBaseUnits(value: bigint | number): string {\n  if (typeof value === \"number\" && !Number.isSafeInteger(value)) {\n    throw new Error(`fromBaseUnits: number must be a safe integer, got ${value}`);\n  }\n  return BigInt(value).toString();\n}\n\n/** Convert a human decimal amount (\"0.5\") into base units for `decimals` places. */\nexport function humanToBaseUnits(amount: string, decimals: number): string {\n  const trimmed = amount.trim();\n  if (!/^\\d+(\\.\\d+)?$/.test(trimmed)) {\n    throw new Error(`invalid decimal amount: \"${amount}\"`);\n  }\n  const [whole, fraction = \"\"] = trimmed.split(\".\");\n  if (fraction.length > decimals) {\n    throw new Error(`\"${amount}\" has more than ${decimals} decimal places`);\n  }\n  const padded = fraction.padEnd(decimals, \"0\");\n  return (BigInt(whole) * 10n ** BigInt(decimals) + BigInt(padded || \"0\")).toString();\n}\n\n/** Convert base units into a human decimal string for `decimals` places. */\nexport function baseUnitsToHuman(value: string | bigint, decimals: number): string {\n  const units = toBaseUnits(value);\n  const negative = units < 0n;\n  const abs = negative ? -units : units;\n  const divisor = 10n ** BigInt(decimals);\n  const whole = abs / divisor;\n  const fraction = (abs % divisor).toString().padStart(decimals, \"0\").replace(/0+$/, \"\");\n  const sign = negative ? \"-\" : \"\";\n  return fraction ? `${sign}${whole}.${fraction}` : `${sign}${whole}`;\n}\n","/**\n * Praxis SDK wire types — the JSON contract exposed by `/api/praxis/*`.\n *\n * MONEY RULE: every monetary value crosses the wire as a **decimal string of\n * integer base units** (lamports for SOL, token base units for SPL) — never a\n * float. On the server these are `bigint`; the API serializes them to strings.\n * The SDK keeps them as strings and leaves bigint conversion to the caller\n * (see `toBaseUnits` / `fromBaseUnits` in `units.ts`). This file intentionally\n * mirrors `@praxis/shared` but with `string` money, so the SDK ships a\n * self-contained type contract with no internal workspace dependency.\n */\n\n/** A base58-encoded Solana public key. */\nexport type Address = string;\n\n/** Integer base units as a decimal string (e.g. \"500000000\" = 0.5 SOL). */\nexport type BaseUnitString = string;\n\n/** Mirrors the on-chain `ActionKind` discriminants. */\nexport enum ActionKind {\n  Transfer = 0,\n  TransferSpl = 1,\n}\n\n/** Why Aegis rejected an agent action. Mirrors the on-chain enum order. */\nexport enum RejectReason {\n  Unauthorized = 0,\n  Paused = 1,\n  Expired = 2,\n  OverPerTx = 3,\n  OverDaily = 4,\n  RecipientNotAllowed = 5,\n  Overflow = 6,\n  MintNotAllowed = 7,\n}\n\n// --- Auth ------------------------------------------------------------------\n\n/** Returned by `POST /auth/challenge`; sign `message` to prove wallet ownership. */\nexport interface WalletChallenge {\n  address: Address;\n  /** Opaque signed token echoed back to `/auth/verify`. */\n  nonce: string;\n  /** The exact UTF-8 string the wallet must sign. */\n  message: string;\n  /** ISO-8601 expiry of the challenge. */\n  expiresAt: string;\n}\n\nexport interface SessionInfo {\n  authenticated: boolean;\n  /** The signed-in wallet (owner). Present whenever `authenticated` is true. */\n  walletAddress: Address;\n  /** Unix seconds at which the session expires (from `GET /auth/session`). */\n  expiresAt?: number;\n}\n\n// --- Tokens / address book -------------------------------------------------\n\nexport interface TokenInfo {\n  symbol: string;\n  mint: Address;\n  decimals: number;\n  verified: boolean;\n}\n\nexport interface AddressBookEntry {\n  label: string;\n  name: string;\n  address: Address;\n  note?: string;\n}\n\n// --- Policy ----------------------------------------------------------------\n\nexport interface PolicyView {\n  address: Address;\n  owner: Address;\n  /** `11111…1111` (default) once the agent key is revoked. */\n  agentAuthority: Address;\n  maxPerTx: BaseUnitString;\n  dailyLimit: BaseUnitString;\n  spentToday: BaseUnitString;\n  dayStartTs: number;\n  allowedPrograms: Address[];\n  /** Empty array means \"any recipient allowed\". */\n  allowedRecipients: Address[];\n  allowedMints: Address[];\n  expiryTs: number;\n  paused: boolean;\n  vaultBalance: BaseUnitString;\n  tokenMint: Address;\n  tokenMaxPerTx: BaseUnitString;\n  tokenDailyLimit: BaseUnitString;\n  tokenSpentToday: BaseUnitString;\n  tokenDayStartTs: number;\n}\n\nexport interface PolicyCheckResult {\n  allowed: boolean;\n  reason?: string;\n  reasonCode?: RejectReason;\n  spentToday: BaseUnitString;\n  dailyLimit: BaseUnitString;\n  remaining: BaseUnitString;\n}\n\nexport interface PolicyUpdate {\n  maxPerTx?: BaseUnitString;\n  dailyLimit?: BaseUnitString;\n  expiryTs?: number;\n  paused?: boolean;\n}\n\nexport interface TokenEnvelopeConfig {\n  tokenMint: Address;\n  tokenMaxPerTx: BaseUnitString;\n  tokenDailyLimit: BaseUnitString;\n}\n\nexport type AllowListKind = \"programs\" | \"recipients\" | \"mints\";\n\n// --- Proposals -------------------------------------------------------------\n\nexport interface TransferDetail {\n  kind: \"transfer\";\n  amount: BaseUnitString;\n  asset: TokenInfo;\n  recipientName: string;\n  recipientAddress: Address;\n  recipientNote?: string;\n}\n\nexport interface SwapDetail {\n  kind: \"swap\";\n  amountIn: BaseUnitString;\n  assetIn: TokenInfo;\n  estAmountOut: BaseUnitString;\n  assetOut: TokenInfo;\n  route: string;\n  priceImpactBps: number;\n}\n\nexport type ProposalDetail = TransferDetail | SwapDetail;\n\nexport type ProposalState = \"pending\" | \"signing\" | \"signed\" | \"blocked\" | \"cancelled\";\n\nexport interface ActionProposal {\n  id: string;\n  detail: ProposalDetail;\n  networkFee: BaseUnitString;\n  simulation: string;\n  check: PolicyCheckResult;\n  state: ProposalState;\n  sig?: string;\n}\n\n// --- Conversation ----------------------------------------------------------\n\nexport interface ClarifyOption {\n  label: string;\n  value: string;\n  hint?: string;\n}\n\nexport interface ResearchMetric {\n  label: string;\n  value: string;\n  trend?: \"up\" | \"down\" | \"flat\";\n}\n\nexport interface ResearchData {\n  token: string;\n  mint: Address;\n  metrics: ResearchMetric[];\n  summary: string;\n}\n\nexport interface PolicyChangeRow {\n  label: string;\n  from: string;\n  to: string;\n}\n\nexport type AgentBlock =\n  | { type: \"prose\"; text: string }\n  | { type: \"clarify\"; text: string; options: ClarifyOption[] }\n  | { type: \"proposal\"; text: string; proposalId: string }\n  | { type: \"research\"; text: string; data: ResearchData }\n  | { type: \"notice\"; tone: \"success\" | \"info\"; text: string }\n  | {\n      type: \"policy_change\";\n      text: string;\n      patch: PolicyUpdate;\n      changes: PolicyChangeRow[];\n      applied: boolean;\n    };\n\nexport type UserMessage = { id: string; role: \"user\"; ts: number; text: string };\nexport type AgentMessage = { id: string; role: \"agent\"; ts: number; blocks: AgentBlock[] };\nexport type Message = UserMessage | AgentMessage;\n\nexport interface Thread {\n  id: string;\n  title: string;\n  messages: Message[];\n  updatedAt: number;\n}\n\n// --- Activity --------------------------------------------------------------\n\nexport interface ActivityEntry {\n  id: string;\n  kind: \"transfer\" | \"swap\";\n  label: string;\n  asset: string;\n  amount: BaseUnitString;\n  decimals: number;\n  result: \"allowed\" | \"rejected\";\n  reason?: string;\n  reasonCode?: RejectReason;\n  ts: number;\n  sig?: string;\n}\n\n// --- Owner transactions (wallet-signed path) -------------------------------\n\nexport interface UnsignedOwnerTransaction {\n  /** base64-encoded unsigned transaction for the owner wallet to sign. */\n  transaction: string;\n  blockhash: string;\n  lastValidBlockHeight: number;\n}\n\n/**\n * An {@link UnsignedOwnerTransaction} after the owner wallet has signed it — the\n * base64 `transaction` now carries the owner's signature. This is what you pass\n * to {@link PraxisClient.submitOwnerTransaction}. Signing a Solana transaction\n * requires a transaction-capable wallet (browser wallet adapter / `@solana/web3.js`);\n * the SDK's `keypairSigner` only signs the sign-in *message*, not transactions.\n */\nexport type SignedOwnerTransaction = UnsignedOwnerTransaction;\n\n/** Typed owner action accepted by `POST /owner/build`. */\nexport type OwnerAction =\n  | { kind: \"bootstrapPolicy\"; fundLamports?: BaseUnitString }\n  | { kind: \"fundVault\"; amount: BaseUnitString }\n  | { kind: \"withdrawVault\"; amount: BaseUnitString }\n  | { kind: \"closePolicy\" }\n  | { kind: \"revoke\" }\n  | { kind: \"rotate\" }\n  | { kind: \"updatePolicy\"; patch: PolicyUpdate }\n  | { kind: \"allowList\"; listKind: AllowListKind; address: Address; mode: \"add\" | \"remove\" };\n"]}