curl -X GET "http://kaman.ai/api/agent/kb" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "knowledgeBases": [
    {
      "id": 1,
      "name": "Product Documentation",
      "description": "Internal product docs and FAQs",
      "created_by": "user_abc",
      "created_at": "2025-06-20T10:00:00.000Z",
      "updated_at": "2025-06-20T10:00:00.000Z",
      "permission_level": 60
    },
    {
      "id": 2,
      "name": "Engineering Handbook",
      "description": "Engineering best practices and runbooks",
      "created_by": "user_xyz",
      "created_at": "2025-07-01T08:30:00.000Z",
      "updated_at": "2025-07-15T14:00:00.000Z",
      "permission_level": 40
    }
  ]
}

curl -X POST "http://kaman.ai/api/agent/kb" \
  -H "Authorization: Bearer kam_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Documentation",
    "description": "Internal product docs and FAQs"
  }'

{
  "id": 1,
  "name": "Product Documentation",
  "description": "Internal product docs and FAQs",
  "type": "kb",
  "status": "published"
}

curl -X GET "http://kaman.ai/api/agent/kb/1" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "knowledgeBase": {
    "id": 1,
    "name": "Product Documentation",
    "description": "Internal product docs and FAQs",
    "created_by": "user_abc",
    "created_at": "2025-06-20T10:00:00.000Z",
    "updated_at": "2025-06-20T10:00:00.000Z"
  }
}

{
  "error": "Knowledge base not found"
}

curl -X PUT "http://kaman.ai/api/agent/kb/1" \
  -H "Authorization: Bearer kam_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Documentation v2",
    "description": "Updated product docs with new features"
  }'

curl -X DELETE "http://kaman.ai/api/agent/kb/1" \
  -H "Authorization: Bearer kam_your_api_key"

curl -X POST "http://kaman.ai/api/agent/kb/1/uploadfile" \
  -H "Authorization: Bearer kam_your_api_key" \
  -F "file=@/path/to/document.pdf"

curl -X POST "http://kaman.ai/api/agent/kb/1/uploadfile" \
  -H "Authorization: Bearer kam_your_api_key" \
  -F "files=@/path/to/doc1.pdf" \
  -F "files=@/path/to/doc2.txt"

{
  "message": "Files uploaded successfully",
  "fileId": "a1b2c3d4e5f6...",
  "fileHash": "a1b2c3d4e5f6...",
  "fileName": "document.pdf",
  "fileSize": 245760,
  "mimeType": "application/pdf",
  "files": [
    {
      "fileId": "a1b2c3d4e5f6...",
      "fileName": "document.pdf",
      "fileSize": 245760,
      "mimeType": "application/pdf"
    }
  ]
}

{
  "message": "Files uploaded successfully",
  "files": [
    {
      "fileId": "a1b2c3d4e5f6...",
      "fileName": "doc1.pdf",
      "fileSize": 245760,
      "mimeType": "application/pdf"
    },
    {
      "fileId": "f6e5d4c3b2a1...",
      "fileName": "doc2.txt",
      "fileSize": 1024,
      "mimeType": "text/plain"
    }
  ]
}

{
  "error": "No files uploaded"
}

curl -X GET "http://kaman.ai/api/agent/kb/1/files" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "files": [
    {
      "id": 1,
      "knowledge_base_id": 1,
      "file_name": "document.pdf",
      "file_path": "/data/user123/a1b2c3d4.pdf",
      "fileHash": "a1b2c3d4e5f6...",
      "text": "Extracted text content from the document...",
      "created_at": "2025-06-20T10:05:00.000Z",
      "updated_at": "2025-06-20T10:05:00.000Z"
    }
  ]
}

curl -X GET "http://kaman.ai/api/agent/kb/download/a1b2c3d4e5f6" \
  -H "Authorization: Bearer kam_your_api_key" \
  -o downloaded_file.pdf

{
  "error": "File not found"
}

curl -X GET "http://kaman.ai/api/agent/kb/file/a1b2c3d4e5f6" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "file": {
    "id": 1,
    "knowledge_base_id": 1,
    "file_name": "document.pdf",
    "file_path": "/data/user123/a1b2c3d4.pdf",
    "fileHash": "a1b2c3d4e5f6...",
    "text": "Extracted text content...",
    "created_at": "2025-06-20T10:05:00.000Z",
    "updated_at": "2025-06-20T10:05:00.000Z"
  }
}

{
  "error": "File not found"
}

curl -X POST "http://kaman.ai/api/agent/kb/1/search" \
  -H "Authorization: Bearer kam_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I reset my password?"
  }'

{
  "results": [
    {
      "chunk": "To reset your password, navigate to Settings > Security and click 'Reset Password'. You will receive a confirmation email...",
      "fileId": "a1b2c3d4e5f6...",
      "metadata": null,
      "similarity": 0.87,
      "chunkId": "1719849600000-550e8400-e29b-41d4-a716-446655440000"
    },
    {
      "chunk": "Password requirements: minimum 8 characters, at least one uppercase letter, one number, and one special character...",
      "fileId": "a1b2c3d4e5f6...",
      "metadata": null,
      "similarity": 0.72,
      "chunkId": "1719849600000-6ba7b810-9dad-11d1-80b4-00c04fd430c8"
    }
  ]
}

curl -X GET "http://kaman.ai/api/agent/kb/chunk/1719849600000-550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "chunk": {
    "chunkId": "1719849600000-550e8400-e29b-41d4-a716-446655440000",
    "userId": "client_123",
    "chunk": "To reset your password, navigate to Settings > Security...",
    "fileId": "a1b2c3d4e5f6...",
    "metadata": null,
    "createdAt": "2025-06-20T10:05:00.000Z"
  }
}

{
  "error": "Chunk not found"
}

curl -X GET "http://kaman.ai/api/agent/kb/chunks/a1b2c3d4e5f6?limit=10&offset=0" \
  -H "Authorization: Bearer kam_your_api_key"

{
  "chunks": [
    {
      "chunkId": "1719849600000-550e8400-e29b-41d4-a716-446655440000",
      "userId": "client_123",
      "chunk": "Chapter 1: Introduction to the product...",
      "fileId": "a1b2c3d4e5f6...",
      "metadata": null,
      "createdAt": "2025-06-20T10:05:00.000Z"
    },
    {
      "chunkId": "1719849600001-6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "userId": "client_123",
      "chunk": "Chapter 2: Getting started with setup...",
      "fileId": "a1b2c3d4e5f6...",
      "metadata": null,
      "createdAt": "2025-06-20T10:05:00.000Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 5,
    "totalCount": 24,
    "limit": 10,
    "offset": 0
  }
}

const API_KEY = process.env.KAMAN_API_KEY;
const BASE_URL = 'http://kaman.ai';

// Create a knowledge base
async function createKB(name: string, description: string) {
  const response = await fetch(`${BASE_URL}/api/agent/kb`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ name, description })
  });
  return response.json();
}

// Upload a file
async function uploadFile(kbId: number, file: File) {
  const formData = new FormData();
  formData.append('file', file);

  const response = await fetch(`${BASE_URL}/api/agent/kb/${kbId}/uploadfile`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    },
    body: formData
  });
  return response.json();
}

// Search the knowledge base
async function searchKB(kbId: number, query: string) {
  const response = await fetch(`${BASE_URL}/api/agent/kb/${kbId}/search`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ query })
  });
  return response.json();
}

// Example usage
const kb = await createKB('Product Docs', 'All product documentation');
const uploaded = await uploadFile(kb.id, myFile);
const results = await searchKB(kb.id, 'How do I configure SSO?');
console.log(results.results.map(r => r.chunk));

import requests
import os
from typing import Optional, Dict, Any, List

class KamanKnowledgeBase:
    def __init__(self, base_url: str):
        self.base_url = f'{base_url}/api/agent/kb'
        self.headers = {
            'Authorization': f'Bearer {os.getenv("KAMAN_API_KEY")}',
            'Content-Type': 'application/json'
        }

    def list(self) -> List[Dict]:
        """List all accessible knowledge bases."""
        response = requests.get(self.base_url, headers=self.headers)
        return response.json()['knowledgeBases']

    def create(self, name: str, description: str = '') -> Dict:
        """Create a new knowledge base."""
        response = requests.post(
            self.base_url,
            json={'name': name, 'description': description},
            headers=self.headers
        )
        return response.json()

    def upload_file(self, kb_id: int, file_path: str) -> Dict:
        """Upload a file to a knowledge base."""
        headers = {'Authorization': self.headers['Authorization']}
        with open(file_path, 'rb') as f:
            response = requests.post(
                f'{self.base_url}/{kb_id}/uploadfile',
                files={'file': f},
                headers=headers
            )
        return response.json()

    def search(self, kb_id: int, query: str) -> List[Dict]:
        """Search a knowledge base using RAG."""
        response = requests.post(
            f'{self.base_url}/{kb_id}/search',
            json={'query': query},
            headers=self.headers
        )
        return response.json()['results']

# Example usage
client = KamanKnowledgeBase('http://kaman.ai')

# Create and populate a knowledge base
kb = client.create('Engineering Docs', 'Internal engineering documentation')
client.upload_file(kb['id'], '/path/to/handbook.pdf')

# Search
results = client.search(kb['id'], 'deployment process')
for result in results:
    print(f"[{result['similarity']:.2f}] {result['chunk'][:100]}...")

#!/bin/bash
API_KEY="${KAMAN_API_KEY}"
BASE_URL="http://kaman.ai/api/agent/kb"

# List knowledge bases
curl -s "$BASE_URL" \
  -H "Authorization: Bearer $API_KEY"

# Create a knowledge base
curl -s -X POST "$BASE_URL" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My KB", "description": "Test knowledge base"}'

# Upload a file
curl -s -X POST "$BASE_URL/1/uploadfile" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@/path/to/document.pdf"

# Search
curl -s -X POST "$BASE_URL/1/search" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "How do I configure SSO?"}'

# Get files in a knowledge base
curl -s "$BASE_URL/1/files" \
  -H "Authorization: Bearer $API_KEY"

# Download a file
curl -s "$BASE_URL/download/a1b2c3d4e5f6" \
  -H "Authorization: Bearer $API_KEY" \
  -o downloaded_file.pdf

{
  "error": "Error description message"
}