Knowledge API

const client = new NdxClient({
  apiKey: process.env.NEURADEX_API_KEY,
  projectId: 'your-project-id',
});

// Access Knowledge API
client.knowledge.search('query');
client.knowledge.get('id');
client.knowledge.create({ ... });

interface SearchResult {
  id: string;
  title: string;
  tags: string[];
  score: number;           // Relevance score (0-1)
  summary: string | null;  // LLM-generated summary
  contentTokens: number | null;
  createdAt: string | null;
  indexedAt: string | null;
}

// Basic search
const results = await client.knowledge.search('authentication mechanism');

for (const result of results) {
  console.log(`${result.title} (score: ${result.score.toFixed(2)})`);
}

// Specify result count
const topResults = await client.knowledge.search('returns', { limit: 5 });

interface KnowledgeViewResponse {
  id: string;
  title: string;
  content: string;
  tags: string[];
  summary: string | null;
  contentTokens: number | null;
  createdAt: string;
  updatedAt: string;
  connectedKnowledge: ConnectedKnowledge[];
}

interface ConnectedKnowledge {
  id: string;
  title: string;
  relationType: string;
  weight: number;
  isActive: boolean;
  validFrom: string;
  validUntil: string | null;
}

const detail = await client.knowledge.get('knowledge-id');

console.log(detail.title);
console.log(detail.content);

// Check related knowledge
for (const connected of detail.connectedKnowledge) {
  console.log(`Related: ${connected.title} (${connected.relationType})`);
}

interface Knowledge {
  id: string;
  title: string;
  content: string;
  tags: string[];
  createdAt: string;
  updatedAt: string;
}

const allKnowledge = await client.knowledge.list();

console.log(`Knowledge count: ${allKnowledge.length}`);

const knowledge = await client.knowledge.create({
  title: 'Introduction to React Hooks',
  content: `
    React Hooks allow function components to use state and lifecycle features.

    ## useState
    Manages component state.

    ## useEffect
    Handles side effects (API calls, DOM operations, etc.).
  `,
  tags: ['React', 'Frontend', 'JavaScript'],
});

console.log(`Created: ${knowledge.id}`);

const items = await client.knowledge.bulkCreate([
  {
    title: 'TypeScript Basics',
    content: 'TypeScript is a statically typed superset of JavaScript.',
    tags: ['TypeScript', 'Programming'],
  },
  {
    title: 'Node.js Basics',
    content: 'Node.js is a server-side JavaScript runtime environment.',
    tags: ['Node.js', 'Backend'],
  },
]);

console.log(`Created ${items.length} items`);

// Update title only
const updated = await client.knowledge.update('knowledge-id', {
  title: 'New Title',
});

// Update content only
const updated = await client.knowledge.update('knowledge-id', {
  content: 'Updated content',
});

// Update both
const updated = await client.knowledge.update('knowledge-id', {
  title: 'New Title',
  content: 'Updated content',
});

await client.knowledge.delete('knowledge-id');
console.log('Deleted');

Array<{ title: string; content: string }>

const exported = await client.knowledge.export();

// Save as JSON
import fs from 'fs';
fs.writeFileSync('knowledge-backup.json', JSON.stringify(exported, null, 2));

const history = await client.knowledge.getHistory('knowledge-id');

for (const episode of history) {
  console.log(`${episode.episodeType}: ${episode.content}`);
  console.log(`  Reason: ${episode.changeReason}`);
  console.log(`  Actor: ${episode.actorName}`);
  console.log(`  Date: ${episode.occurredAt}`);
}

// Active edges only
const activeEdges = await client.knowledge.getEdges('knowledge-id');

// Include history
const allEdges = await client.knowledge.getEdges('knowledge-id', {
  includeHistory: true,
});

for (const edge of allEdges) {
  console.log(`${edge.title} (${edge.relationType})`);
  console.log(`  Active: ${edge.isActive}`);
  console.log(`  Valid: ${edge.validFrom} - ${edge.validUntil ?? 'present'}`);
}