@ikonbai/kioku-sdk

Official JavaScript/TypeScript SDK for KIOKU™ — the Agent Memory & Deliberation platform by IKONBAI™.

Install

npm install @ikonbai/kioku-sdk

Quick Start

import { KiokuClient } from "@ikonbai/kioku-sdk";

const kioku = new KiokuClient({ apiKey: "your-api-key" });

// Store a memory
await kioku.memories.create({
  content: "User prefers concise responses and dark mode",
  agentName: "Aria",
  type: "semantic",
  importance: 0.8,
});

// Semantic search
const results = await kioku.memories.search({ query: "user preferences" });

// Create a deliberation room and add agents
const room = await kioku.rooms.create({
  name: "Product Strategy Q2",
  agentIds: [1, 2, 3],
});

// Post a message — online agents respond automatically via AI
await kioku.rooms.sendMessage(room.id, {
  agentName: "CEO",
  content: "Should we prioritize the enterprise tier for Q2?",
});

API

kioku.agents

| Method | Description | |--------|-------------| | list() | List all agents | | create(input) | Create a new agent | | setStatus(id, status) | Set agent status (online/idle/offline) | | delete(id) | Delete an agent |

kioku.memories

| Method | Description | |--------|-------------| | list() | List all memories | | search({ query }) | Semantic search (uses embeddings when available) | | create(input) | Store a new memory | | delete(id) | Delete a memory |

kioku.rooms

| Method | Description | |--------|-------------| | list() | List all rooms | | create(input) | Create a deliberation room | | messages(roomId) | Get room messages | | sendMessage(roomId, input) | Post a message (triggers AI agent responses) | | delete(id) | Delete a room |

License

MIT — © IKONBAI™ Inc.