{"_id":"@aqera/sdk","name":"@aqera/sdk","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aqera/sdk","version":"0.1.0","description":"Official JavaScript/TypeScript SDK for Aqera - Enterprise AI Platform","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"sideEffects":false,"engines":{"node":">=18"},"scripts":{"build":"tsc && tsc -p tsconfig.module.json","typecheck":"tsc --noEmit","lint":"eslint .","test":"vitest run","docs":"typedoc --options typedoc.json","docs:watch":"typedoc --options typedoc.json --watch","prepack":"npm run build"},"keywords":["aqera","ai","sdk","api","typescript","enterprise"],"author":{"name":"Aqera Team","email":"team@aqera.io"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/aqera/sdk.git","directory":"sdk/javascript"},"bugs":{"url":"https://github.com/aqera/sdk/issues"},"homepage":"https://aqera.io","devDependencies":{"@typescript-eslint/eslint-plugin":"^8.53.0","@typescript-eslint/parser":"^8.53.0","@vitest/coverage-v8":"^3.2.4","eslint":"^9.39.2","typedoc":"^0.27.5","typescript":"^5.3.0","vitest":"^3.2.4"},"_id":"@aqera/sdk@0.1.0","gitHead":"47ea9d32a267cecc869638b898f66f3e9816bc29","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-889ZQJiE/LY0uotSCAAhCPCToxi7Lp6T3r1oeaiIrdqJeOuIPBhLTpw5DIG+O+Q4WJDczCVoif9V/2rIuDZNRg==","shasum":"86fb4e12a7a3234dd437cf8ceccb0ee903a91608","tarball":"https://registry.npmjs.org/@aqera/sdk/-/sdk-0.1.0.tgz","fileCount":44,"unpackedSize":469728,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFF8EK8Qm+Y67p2EoVe7qTzCBIoV1U3WSouILZ3uAb9BAiBBkfn7o3zEvHx5cxOITxXRoM0JiRwBehTsNzNmJQSvaw=="}]},"_npmUser":{"name":"gashiru","email":"gashiru@live.co.uk"},"directories":{},"maintainers":[{"name":"gashiru","email":"gashiru@live.co.uk"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.1.0_1770395005426_0.1639651724600777"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-06T16:23:25.306Z","0.1.0":"2026-02-06T16:23:25.575Z","modified":"2026-02-06T16:23:25.824Z"},"maintainers":[{"name":"gashiru","email":"gashiru@live.co.uk"}],"description":"Official JavaScript/TypeScript SDK for Aqera - Enterprise AI Platform","homepage":"https://aqera.io","keywords":["aqera","ai","sdk","api","typescript","enterprise"],"repository":{"type":"git","url":"git+https://github.com/aqera/sdk.git","directory":"sdk/javascript"},"author":{"name":"Aqera Team","email":"team@aqera.io"},"bugs":{"url":"https://github.com/aqera/sdk/issues"},"license":"MIT","readme":"# Aqera JavaScript/TypeScript SDK\n\nIdiomatic JavaScript/TypeScript client for the Aqera AI-Native OS platform.\n\n## Installation\n\n```bash\nnpm install @arqera/sdk\n# or\nyarn add @arqera/sdk\n# or\npnpm add @arqera/sdk\n```\n\n## Quick Start\n\n```typescript\nimport { AqeraClient } from '@arqera/sdk';\n\n// Initialize the client\nconst client = new AqeraClient({\n  apiKey: process.env.ARQERA_API_KEY,\n});\n\n// List tasks\nconst tasks = await client.work.listTasks({ status: 'todo' });\nconsole.log(tasks);\n\n// Create a task\nconst newTask = await client.work.createTask({\n  title: 'Implement new feature',\n  description: 'Add user authentication',\n  projectId: 1,\n});\n\n// Chat with Ara\nconst response = await client.ara.chat([\n  { role: 'user', content: 'Show me my pending tasks' }\n]);\nconsole.log(response);\n```\n\n## Modules\n\n### Work Module\n\nManage projects, tasks, workflows, and time tracking:\n\n```typescript\n// Tasks\nconst tasks = await client.work.listTasks({ projectId: 1, status: 'todo' });\nconst task = await client.work.getTask(123);\nawait client.work.createTask({ title: 'New task', projectId: 1 });\nawait client.work.updateTask(123, { status: 'in_progress' });\nawait client.work.deleteTask(123);\n\n// Projects\nconst projects = await client.work.listProjects({ status: 'active' });\nconst project = await client.work.getProject(1);\nawait client.work.createProject({ name: 'New project' });\n\n// Workflows\nconst workflows = await client.work.listWorkflows({ module: 'work' });\nconst result = await client.work.executeWorkflow(1, { param: 'value' });\n\n// Time tracking\nconst entries = await client.work.listTimeEntries({ taskId: 123 });\nconst timer = await client.work.startTimer(123);\nawait client.work.stopTimer(timer.id);\n```\n\n### Agents Module\n\nManage and interact with agents:\n\n```typescript\n// List agents\nconst agents = await client.agents.listAgents({ agentType: 'chat' });\n\n// Get agent details\nconst agent = await client.agents.get(1);\n\n// Create an agent\nconst agent = await client.agents.create({\n  name: 'My Assistant',\n  type: 'chat',\n  capabilities: ['chat', 'task.execute']\n});\n\n// Chat with an agent\nconst response = await client.agents.chat(1, [\n  { role: 'user', content: 'Help me with this task' }\n]);\n\n// Execute an action\nconst result = await client.agents.execute(1, 'create_task', {\n  title: 'Task from agent'\n});\n```\n\n### Ara Module\n\nAI chat and assistance:\n\n```typescript\n// Simple chat\nconst response = await client.ara.chat([\n  { role: 'user', content: 'What can you help me with?' }\n]);\n\n// Chat with session\nconst response = await client.ara.chat(\n  [\n    { role: 'user', content: 'Show me tasks' },\n    { role: 'assistant', content: 'Here are your tasks...' },\n    { role: 'user', content: 'Filter by high priority' }\n  ],\n  'session_123' // sessionId\n);\n\n// Get AI suggestions\nconst suggestions = await client.ara.suggest({\n  module: 'work',\n  action: 'list_tasks'\n});\n\n// Get feature explanation\nconst explanation = await client.ara.explain('task_workflows', 'standard');\n\n// Navigation guidance\nconst guide = await client.ara.guide('settings');\n```\n\n### Execute Endpoint\n\nExecute Aqera workflows:\n\n```typescript\nconst result = await client.execute({\n  intent: 'support.triage',\n  context: {\n    tenantId: 'tenant_123',\n    userId: 'user_456'\n  },\n  inputs: {\n    ticketId: 'TICKET-001',\n    priority: 'high'\n  }\n});\n```\n\n## Error Handling\n\n```typescript\nimport { AqeraClient, AqeraError } from '@arqera/sdk';\n\ntry {\n  const tasks = await client.work.listTasks();\n} catch (error) {\n  if (error instanceof AqeraError) {\n    console.error(`Error: ${error.message}`);\n    if (error.statusCode) {\n      console.error(`Status: ${error.statusCode}`);\n    }\n  }\n}\n```\n\n## Configuration\n\n```typescript\n// Custom base URL and timeout\nconst client = new AqeraClient({\n  apiKey: process.env.ARQERA_API_KEY,\n  baseUrl: 'https://api.arqera.com',  // Default\n  timeout: 30000,  // milliseconds\n});\n```\n\n## TypeScript Support\n\nThe SDK includes full TypeScript type definitions:\n\n```typescript\nimport { AqeraClient, TaskStatus, ProjectStatus } from '@arqera/sdk';\n\n// Type-safe status values\nconst tasks = await client.work.listTasks({\n  status: 'todo' as TaskStatus,\n  limit: 10\n});\n```\n\n## API Reference\n\nSee the full API documentation at: https://docs.arqera.com/sdk/javascript\n","readmeFilename":"README.md","_rev":"1-28601c91d90e961aa6402b6cb3304fa6"}