EmblemAI developer tools

@emblemvault/hustle-react

hustle-incognito

Security & Trust Model

• Financial operations (W009): Wallet provisioning, transaction signing adapters, and trading tool references. All value-moving actions require explicit user confirmation.
• Third-party data (W011): References to Migrate.fun project metadata and social/market data tools. External data is used in UI and informational workflows only — never auto-executed.
• Runtime backend (W012): The EmblemAI SDK connects to

  api.emblemvault.ai

  (first-party, operated by EmblemVault) for prompt orchestration and tool routing. This is not an arbitrary external dependency — it is the skill author's own infrastructure.

What You Can Build

• Create users who can log in to your app and also have wallet-enabled profiles
• Let users sign in with wallets, email/password, or social login
• Support wallet login with MetaMask, Phantom, WalletConnect, and other supported providers
• Keep sessions refreshed automatically with JWT-based auth
• Expose consistent wallet metadata and permissions to your UI and plugin layers
• Use one integration instead of stitching together separate auth and wallet systems

• Drop-in chat components that inherit the authenticated session
• Streaming chat responses for support, education, or account insights
• Custom tool plugins to extend EmblemAI with your own APIs
• Built-in guardrails and approval prompts before tools can request sensitive actions

• EmblemAuthProvider + ConnectButton for instant wallet-aware login flows
• HustleProvider + HustleChat for embedding the assistant UI
• See the dedicated ../emblem-ai-react/SKILL.md skill for migrate.fun hooks, advanced React routing, and component design guidance

• Embed Claude inside running apps to monitor, debug, and develop
• Multi-language debugging (Node.js, Python, Go, .NET, Rust)
• MCP server mode for Claude Code / Claude Desktop integration
• Library mode with

  makeReflexive()

  for programmatic AI chat
• Sandbox mode with snapshot/restore

Quick Start

Installation

# Core authentication
npm install @emblemvault/auth-sdk

# React integration (includes auth)
npm install @emblemvault/emblem-auth-react

# EmblemAI chat for React
npm install @emblemvault/hustle-react

# EmblemAI chat SDK (Node.js / vanilla JS)
npm install hustle-incognito

# AI app introspection and debugging
npm install reflexive

Option A: React App (Recommended)

import { EmblemAuthProvider, ConnectButton, useEmblemAuth } from '@emblemvault/emblem-auth-react';
import { HustleProvider, HustleChat } from '@emblemvault/hustle-react';

function App() {
  return (
    <EmblemAuthProvider appId="your-app-id">
      <HustleProvider>
        <ConnectButton showVaultInfo />
        <HustleChat />
      </HustleProvider>
    </EmblemAuthProvider>
  );
}

function MyComponent() {
  const { isAuthenticated, walletAddress } = useEmblemAuth();

  if (!isAuthenticated) {
    return <ConnectButton />;
  }

  return <div>Connected: {walletAddress}</div>;
}

Option B: Vanilla JavaScript / Node.js

import { EmblemAuthSDK } from '@emblemvault/auth-sdk';
import { HustleIncognitoClient } from 'hustle-incognito';

// Initialize auth
const auth = new EmblemAuthSDK({ appId: 'your-app-id' });

// Open auth modal (browser)
auth.openAuthModal();

// Listen for session
auth.on('session', () => {
  console.log('Authenticated session ready');
});

// Initialize AI with auth
const emblemAI = new HustleIncognitoClient({ sdk: auth });

// Chat with AI
const response = await emblemAI.chat([
  { role: 'user', content: 'What tokens are trending on Base?' }
]);

Need CLI or wallet-first automations?

Core Capabilities

Wallet Authentication

• OAuth (Google, Twitter/X)
• Email/password with OTP

AI Chat Experience & Plugins

• Streaming chat for onboarding, support, education, or account insights
• Built-in moderation and approval prompts whenever a plugin requests access to sensitive data
• Cross-surface context handoff between web, mobile, and agent frameworks
• Low-code React components plus a TypeScript SDK for custom UI shells

• references/emblem-ai-react.md — chat UI patterns for React
• references/emblem-ai-incognito.md — SDK usage outside of React
• references/plugins.md — how to register custom tools safely

React Components

// Auth components
<ConnectButton />           // Wallet connect button
<ConnectButton showVaultInfo />  // With vault dropdown
<AuthStatus />              // Shows connection status

// AI chat components
<HustleChat />              // Full EmblemAI chat interface
<HustleChatWidget />        // Floating EmblemAI chat widget

Agent Wallet & Automations

React Token Migration & Advanced Hooks

AI App Introspection (Reflexive)

# Monitor any app (read-only by default)
npx reflexive ./server.js

# Local development mode with debugging (still no write/shell unless explicitly enabled)
npx reflexive --debug --watch ./server.js

# As MCP server for Claude Code (read-only baseline)
npx reflexive --mcp --debug ./server.js

// Library mode -- embed in your app
import { makeReflexive } from 'reflexive';

const r = makeReflexive({ webUI: true, title: 'My App' });
r.setState('users.active', 42);
const analysis = await r.chat('Any anomalies in recent activity?');

makeReflexive()

--write

--shell

Session Management

auth.on('session', () => { /* new session available */ });
auth.on('sessionExpired', () => { /* handle expiry */ });
auth.on('sessionRefreshed', () => { /* refreshed */ });
auth.on('sessionWillRefresh', () => { /* refresh soon */ });
auth.on('authError', () => { /* auth failure */ });
auth.on('cancelled', () => { /* user closed auth */ });

await auth.refreshSession();
auth.logout();

Custom AI Plugins

import { usePlugins } from '@emblemvault/hustle-react';

const { registerPlugin } = usePlugins();

await registerPlugin({
  name: 'my-plugin',
  version: '1.0.0',
  tools: [{
    name: 'get_nft_floor',
    description: 'Get NFT collection floor price',
    parameters: {
      type: 'object',
      properties: {
        collection: { type: 'string', description: 'Collection name or address' }
      },
      required: ['collection']
    }
  }],
  executors: {
    get_nft_floor: async ({ collection }) => {
      const data = await fetchFloorPrice(collection);
      return { floor: data.floorPrice, currency: 'ETH' };
    }
  }
});

More Examples and References

• references/agentwallet.md - CLI usage, auth modes, prompts, and operational troubleshooting
• references/auth-sdk.md - auth flows, sessions, Node persistence patterns, and TypeScript types
• references/auth-react.md - provider setup, hooks, browser integrations, and UX patterns
• references/emblem-ai-react.md - chat UI patterns, streaming, and React composition
• references/emblem-ai-incognito.md - Node/browser SDK examples and environment configuration
• ../emblem-ai-react/SKILL.md - React-only view that now owns migrate.fun guidance
• ../emblem-ai-agent-wallet/SKILL.md - wallet-first CLI skill with prepare/approve workflows
• ../emblem-ai-prompt-examples/SKILL.md - standalone EmblemAI prompt catalog covering wallet, Ordinals, and workflow-specific examples
• references/react-components.md - prebuilt component catalog and UI integration examples
• references/react-skill-proposal.md - proposed future React standalone-skill boundary and example gaps
• references/plugins.md - custom plugin design, tool schemas, and executor examples
• references/reflexive.md - AI introspection, debugging, and MCP/server workflows
• README.md - quick package map for choosing the right Emblem package

<ConnectButton />

<HustleChat />

references/