@oxy.so/core 4.5.0 → 4.6.0

package/dist/types/api/accounts.d.ts

@@ -19,7 +19,7 @@
  */
 import { type AgentKeyOperation, type AgentKeyOperationProof } from '@oxy.so/contracts';
 import type { User } from '../models/interfaces';
-import type { AccountCategoryId, AccountKind, ChildAccountKind } from '@oxy.so/contracts';
+import type { AccountCategoryId, AccountKind, AvatarCharacter, ChildAccountKind } from '@oxy.so/contracts';
 import type { SessionLoginResponse } from '../models/session';
 import type { OxyContext } from '../client/context';
 /**
@@ -32,7 +32,7 @@ import type { OxyContext } from '../client/context';
  *
  * Single source of truth is `@oxy.so/contracts`.
  */
-export type { AccountCategoryId, AccountKind } from '@oxy.so/contracts';
+export type { AccountCategoryId, AccountKind, AvatarCharacter } from '@oxy.so/contracts';
 export { ACCOUNT_CATEGORY_IDS, ACCOUNT_KINDS, MAX_ACCOUNT_CATEGORIES, SELECTABLE_ACCOUNT_CATEGORY_IDS, isDelegatedActAsEligibleKind, isOperatorSwitchTargetKind, isSelectableAccountCategoryId, kindAcceptsAccountCategories, } from '@oxy.so/contracts';
 /**
  * The calling user's relationship to an account node, as resolved by the API:
@@ -209,6 +209,13 @@ export interface CreateAccountInput {
      * discoverable at all, rather than discoverable until a second call lands.
      */
     isPrivateAccount?: boolean;
+    /**
+     * The 3D avatar character, for `kind: 'bot'` ONLY (any other kind is a 400).
+     * Optional: a bot created without one is given a look seeded from its
+     * handle, so every bot has a character from birth and its owner changes it
+     * afterwards with `accounts.update`.
+     */
+    character?: AvatarCharacter;
 }
 /** Input accepted by `accounts.update`. Tree placement changes go through `/move`. */
 export interface UpdateAccountInput {
@@ -248,6 +255,12 @@ export interface UpdateAccountInput {
      * always allowed.
      */
     accountCategories?: AccountCategoryId[];
+    /**
+     * Replaces the WHOLE character of a `bot` account. Rejected (400) for any
+     * other kind, and not nullable: a bot always has one. Same authorization as
+     * every other field here (`account:update`).
+     */
+    character?: AvatarCharacter;
 }
 /** Input accepted by `accounts.members.invite`. The owner role cannot be invited. */
 export interface InviteAccountMemberInput {

package/dist/types/models/interfaces.d.ts

@@ -1,4 +1,4 @@
-import type { AccountKind, AccountCategoryId, UserNameResponse, UserRelationship, ThemePreference, OxyNotificationEntityType, OxyNotificationType } from '@oxy.so/contracts';
+import type { AccountKind, AccountCategoryId, AvatarCharacter, UserNameResponse, UserRelationship, ThemePreference, OxyNotificationEntityType, OxyNotificationType } from '@oxy.so/contracts';
 export interface OxyConfig {
     baseURL: string;
     cloudURL?: string;
@@ -160,7 +160,15 @@ export interface User {
     isFederated?: boolean;
     /** Allow sharing this user's content on the fediverse. Defaults to true. */
     fediverseSharing?: boolean;
+    /**
+     * Derived from `kind === 'bot'` (the SOLE definition), NOT from `type`.
+     */
     isAgent?: boolean;
+    /**
+     * The 3D avatar character of a `kind: 'bot'` account, drawn by Bloom's
+     * `Avatar`. Present ONLY on a bot; absent for every other kind.
+     */
+    character?: AvatarCharacter;
     isAutomated?: boolean;
     instance?: string;
     federation?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/core",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -179,7 +179,7 @@
     "@oxy.so/telemetry": "^1.2.0",
     "@noble/ciphers": "^1.3.0",
     "@noble/hashes": "^1.8.0",
-    "@oxy.so/contracts": "4.12.0",
+    "@oxy.so/contracts": "4.13.0",
     "@oxy.so/protocol": "^1.2.2",
     "@scure/bip39": "^1.6.0",
     "buffer": "^6.0.3",
@@ -217,7 +217,7 @@
     "@types/invariant": "^2.2.34",
     "@types/node": "^20.19.43",
     "expo-crypto": "~56.0.3",
-    "expo-secure-store": "~56.0.4",
+    "expo-secure-store": "~57.0.4",
     "express": "^4.22.2",
     "express-rate-limit": "^8.6.0",
     "jest": "^30.5.1",

package/src/api/accounts.ts

@@ -27,7 +27,12 @@ import {
   type AgentKeyOperationProof,
 } from '@oxy.so/contracts';
 import type { User } from '../models/interfaces';
-import type { AccountCategoryId, AccountKind, ChildAccountKind } from '@oxy.so/contracts';
+import type {
+  AccountCategoryId,
+  AccountKind,
+  AvatarCharacter,
+  ChildAccountKind,
+} from '@oxy.so/contracts';
 import type { SessionLoginResponse } from '../models/session';
 import type { OxyContext } from '../client/context';
 import { normalizeUserIdentity } from '../utils/userIdentity';
@@ -57,7 +62,7 @@ const enc = encodeURIComponent;
  *
  * Single source of truth is `@oxy.so/contracts`.
  */
-export type { AccountCategoryId, AccountKind } from '@oxy.so/contracts';
+export type { AccountCategoryId, AccountKind, AvatarCharacter } from '@oxy.so/contracts';
 export {
   ACCOUNT_CATEGORY_IDS,
   ACCOUNT_KINDS,
@@ -247,6 +252,13 @@ export interface CreateAccountInput {
    * discoverable at all, rather than discoverable until a second call lands.
    */
   isPrivateAccount?: boolean;
+  /**
+   * The 3D avatar character, for `kind: 'bot'` ONLY (any other kind is a 400).
+   * Optional: a bot created without one is given a look seeded from its
+   * handle, so every bot has a character from birth and its owner changes it
+   * afterwards with `accounts.update`.
+   */
+  character?: AvatarCharacter;
 }
 
 /** Input accepted by `accounts.update`. Tree placement changes go through `/move`. */
@@ -283,6 +295,12 @@ export interface UpdateAccountInput {
    * always allowed.
    */
   accountCategories?: AccountCategoryId[];
+  /**
+   * Replaces the WHOLE character of a `bot` account. Rejected (400) for any
+   * other kind, and not nullable: a bot always has one. Same authorization as
+   * every other field here (`account:update`).
+   */
+  character?: AvatarCharacter;
 }
 
 /** Input accepted by `accounts.members.invite`. The owner role cannot be invited. */

package/src/models/interfaces.ts

@@ -1,6 +1,7 @@
 import type {
   AccountKind,
   AccountCategoryId,
+  AvatarCharacter,
   UserNameResponse,
   UserRelationship,
   ThemePreference,
@@ -180,7 +181,15 @@ export interface User {
   isFederated?: boolean;
   /** Allow sharing this user's content on the fediverse. Defaults to true. */
   fediverseSharing?: boolean;
+  /**
+   * Derived from `kind === 'bot'` (the SOLE definition), NOT from `type`.
+   */
   isAgent?: boolean;
+  /**
+   * The 3D avatar character of a `kind: 'bot'` account, drawn by Bloom's
+   * `Avatar`. Present ONLY on a bot; absent for every other kind.
+   */
+  character?: AvatarCharacter;
   isAutomated?: boolean;
   instance?: string;
   federation?: {