Installation
npm install @mindblix/sdk
yarn add @mindblix/sdk
Initialization
import { MindBlix } from '@mindblix/sdk';
const client = new MindBlix({
apiKey: process.env.MINDBLIX_API_KEY,
});
Agents
List Agents
const agents = await client.agents.list();
agents.forEach(agent => {
console.log(`${agent.name} (${agent.status})`);
});
Create Agent
const agent = await client.agents.create({
name: 'My Research Agent',
template: 'research',
config: {
maxIterations: 5,
tools: ['web_search'],
},
});
Execute Agent
const result = await client.agents.execute({
agentId: 'agent_abc123',
input: { query: 'Latest AI trends' },
});
console.log(result.output);
console.log(`Tokens: ${result.metadata.tokensUsed}`);
Streaming
const stream = client.agents.executeStream({
template: 'research',
query: 'Explain quantum computing',
});
for await (const chunk of stream) {
process.stdout.write(chunk.text);
}
Workflows
const workflow = await client.workflows.create({
name: 'Analysis Pipeline',
steps: [
{ id: 'research', agentTemplate: 'research' },
{ id: 'analyze', agentTemplate: 'data', dependsOn: ['research'] },
],
});
const run = await client.workflows.trigger(workflow.id, {
query: 'Market analysis for Q1 2026',
});
console.log(`Run status: ${run.status}`);
Error Handling
import {
MindBlixError,
AuthenticationError,
RateLimitError,
} from '@mindblix/sdk';
try {
const result = await client.agents.execute({ ... });
} catch (error) {
if (error instanceof AuthenticationError) {
console.error('Invalid API key');
} else if (error instanceof RateLimitError) {
console.error(`Rate limited. Retry after ${error.retryAfter}s`);
} else if (error instanceof MindBlixError) {
console.error(`API error: ${error.message}`);
}
}
