ailo.life

Add verifiable AI outputs to your agent. Every call gets a tamper-proof verify code; recipients can verify at ailo.life/verify.

Install

npm install ailo.life

Setup

// .env
AILO_VERIFY_API_KEY=sk_xxx

// agent.ts
import { Verify } from 'ailo.life';

const verify = Verify.init();

Usage

Single-turn

export async function handleQuery(query: string) {
  const { result, verifyCode } = await verify.trace('support', async (trace) => {
    const response = await openai.chat.completions.create({ ... });
    trace.llmCall({ model: 'gpt-4o', promptTokens: 150, completionTokens: 80 });
    trace.toolCall('send_email', { to: '[email protected]' });
    return response.choices[0].message.content;
  });

  return result + '\n\n' + verify.embed(verifyCode);
}

Multi-turn (conversationId)

export async function handleTurn(conversationId: string, message: string) {
  const { result, verifyCode } = await verify.trace('support', { conversationId }, async (trace) => {
    // ... LLM + tool calls
    return response;
  });
  return result + '\n\n' + verify.embed(verifyCode);
}

With customerId (optional)

const { result, verifyCode, sessionHash } = await verify.trace('support', {
  conversationId: 'conv_abc',
  customerId: 'cust_123',
}, async (trace) => { ... });

Verification

• Each call: Has its own verifyCode (e.g. 100X2K9MPN). Verify at ailo.life/verify?code=...
• Privacy: Verify page shows only the verified event (not the full chain). Chain integrity is attested server-side. sessionHash for programmatic checks.

Testing & Publishing

Testing locally

1. Dry-run mode — Use Verify.init({ dryRun: true }) to skip API calls in tests:

   const verify = Verify.init({ dryRun: true });
   const { result, verifyCode } = await verify.trace('test', async (trace) => {
     trace.llmCall({ model: 'gpt-4o', promptTokens: 10, completionTokens: 5 });
     return 'ok';
   });
   // verifyCode will be mock value like "100DRY0000"

2. Link locally — From the monorepo root: cd packages/verify && npm link. In your test app: npm link ailo.life.

3. Run build — cd packages/verify && npm run build (runs tsc).

Publishing to npm

1. Login: npm login (create account at npmjs.com if needed).
2. Version: Bump in package.json or run npm version patch|minor|major.
3. Publish: cd packages/verify && npm publish. For scoped packages, first publish: npm publish --access public.
4. Verify: npm view ailo.life to confirm the package is live.