{"_id":"@affanshaikhsurab/agent-sdk","_rev":"2-c22c8f552974cb91c743334e12b98d7d","name":"@affanshaikhsurab/agent-sdk","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@affanshaikhsurab/agent-sdk","version":"1.0.0","keywords":["agent","sdk","llm","ai","orchestration","tools"],"_id":"@affanshaikhsurab/agent-sdk@1.0.0","maintainers":[{"name":"affanshaikhsurab","email":"affansocial01@gmail.com"}],"bin":{"agent":"dist/cli.js"},"dist":{"shasum":"2fb1c8bb90d3c087a06459f476651a7b4d7cbbae","tarball":"https://registry.npmjs.org/@affanshaikhsurab/agent-sdk/-/agent-sdk-1.0.0.tgz","fileCount":5,"integrity":"sha512-NfYaXRuBUjpo73gWEu3zKvkFD/Brrrh2TQEfnCbfAirGClbQm77z0jSMXcynooGJetPgJLgZXdg8vsf93+K1VQ==","signatures":[{"sig":"MEUCIQCYTwNmEmwOEnUeM1vHmcbrAuUubg3fSjghvyj0dhGgjwIgbY1Jh2aTBHdRyf8h2e08eUJcnKe1xr9/QEyM8Cn+Ra0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14315},"main":"./dist/index.cjs","type":"module","module":"./dist/index.js","engines":{"node":">=18.18"},"exports":{".":{"import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"306fbd1ad638d979f01b10424b5953476f69d326","scripts":{"dev":"bun run examples/basic-agent.ts","test":"bun test","build":"npm run clean && tsup","clean":"rimraf dist","docs:api":"bun run scripts/generate-api-reference.ts","typecheck":"tsc --noEmit -p tsconfig.json","lab:web-ui":"bun run examples/lovable-web-studio.ts","pack:check":"npm run build && npm pack --dry-run","lab:lovable":"bun run examples/lovable-lab.ts","examples:smoke":"bun run examples/basic-agent.ts && bun run examples/multi-agent.ts && bun run examples/custom-tool.ts && bun run examples/memory-agent.ts && bun run examples/task-dag.ts && bun run examples/coordinator.ts","prepublishOnly":"npm run test && npm run pack:assert-no-maps","bench:resilience":"bun run bench/retry-breaker.bench.ts","pack:assert-no-maps":"npm run build && node -e \"const cp=require('node:child_process');const out=cp.execSync('npm pack --dry-run --json --ignore-scripts',{encoding:'utf8'});const arr=JSON.parse(out);const files=(arr[0]?.files||[]).map(f=>f.path);const maps=files.filter(f=>/\\.map$/i.test(f));if(maps.length){console.error('Source map files detected in tarball:\\n'+maps.join('\\n'));process.exit(1);}console.log('No source map files detected in tarball.');\"","bench:tasks-dag-stress":"bun run bench/tasks-dag-stress.bench.ts"},"_npmUser":{"name":"affanshaikhsurab","email":"affansocial01@gmail.com"},"_npmVersion":"11.6.2","description":"Composable multi-agent SDK with CLI, memory/context systems, teams, and deterministic VCR testing.","directories":{},"sideEffects":false,"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","openai":"^4.70.0","commander":"^14.0.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^20.17.30"},"_npmOperationalInternal":{"tmp":"tmp/agent-sdk_1.0.0_1775144695004_0.2822701161866923","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@affanshaikhsurab/agent-sdk","version":"1.0.1","description":"Composable multi-agent SDK with CLI, memory/context systems, teams, and deterministic VCR testing.","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","sideEffects":false,"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"bin":{"agent":"dist/cli.js"},"publishConfig":{"access":"public"},"engines":{"node":">=18.18"},"keywords":["agent","sdk","llm","ai","orchestration","tools"],"scripts":{"dev":"bun run examples/basic-agent.ts","lab:lovable":"bun run examples/lovable-lab.ts","lab:web-ui":"bun run examples/lovable-web-studio.ts","clean":"rimraf dist","build":"npm run clean && tsup","typecheck":"tsc --noEmit -p tsconfig.json","typecheck:generated-trace-summary":"tsc --noEmit generated/runs/extract-live-trace-summary.ts --module NodeNext --moduleResolution NodeNext --target ES2022 --types node","test":"bun test","docs:api":"bun run scripts/generate-api-reference.ts","examples:smoke":"bun run examples/basic-agent.ts && bun run examples/multi-agent.ts && bun run examples/custom-tool.ts && bun run examples/memory-agent.ts && bun run examples/task-dag.ts && bun run examples/coordinator.ts","bench:resilience":"bun run bench/retry-breaker.bench.ts","bench:tasks-dag-stress":"bun run bench/tasks-dag-stress.bench.ts","bench:code-understanding-large-repo":"bun run bench/code-understanding-large-repo.bench.ts","diag:kimi":"bun run scripts/nvidia-kimi-simple-diagnostic.ts","diag:model-matrix":"bun run scripts/nvidia-model-matrix.ts","pack:check":"npm run build && npm pack --dry-run","pack:assert-no-maps":"npm run build && node -e \"const cp=require('node:child_process');const out=cp.execSync('npm pack --dry-run --json --ignore-scripts',{encoding:'utf8'});const arr=JSON.parse(out);const files=(arr[0]?.files||[]).map(f=>f.path);const maps=files.filter(f=>/\\.map$/i.test(f));if(maps.length){console.error('Source map files detected in tarball:\\n'+maps.join('\\n'));process.exit(1);}console.log('No source map files detected in tarball.');\"","prepublishOnly":"npm run test && npm run pack:assert-no-maps"},"dependencies":{"commander":"^14.0.3","openai":"^4.70.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^20.17.30","rimraf":"^6.0.1","tsup":"^8.5.0","typescript":"^5.8.3"},"gitHead":"eb499f7ae74f1c6534134ca53d8eef3ec5dd5023","types":"./dist/index.d.ts","_id":"@affanshaikhsurab/agent-sdk@1.0.1","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-I0Li+dXE23UEKtAhf+ecgUAU2U70gVqOV5gVcwf+Q4AFKxGa9jBWGFoMzrRO0fUPlvsL7b5nmKJW1gPdqlcuzg==","shasum":"c62534321342a6590dfd667438134ef168ea7fd9","tarball":"https://registry.npmjs.org/@affanshaikhsurab/agent-sdk/-/agent-sdk-1.0.1.tgz","fileCount":8,"unpackedSize":1829201,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIF8Ykphiow1poy/OlIz+8sYh6ieNIULDj8xPk+w5D439AiApRyzT4Km14/Pkalb1A6IfDHhLfbOEVu2VkL1qbuZzag=="}]},"_npmUser":{"name":"affanshaikhsurab","email":"affansocial01@gmail.com"},"directories":{},"maintainers":[{"name":"affanshaikhsurab","email":"affansocial01@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-sdk_1.0.1_1776250790843_0.3503224734878043"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T15:44:54.924Z","modified":"2026-04-15T10:59:51.098Z","1.0.0":"2026-04-02T15:44:55.156Z","1.0.1":"2026-04-15T10:59:51.009Z"},"keywords":["agent","sdk","llm","ai","orchestration","tools"],"description":"Composable multi-agent SDK with CLI, memory/context systems, teams, and deterministic VCR testing.","maintainers":[{"name":"affanshaikhsurab","email":"affansocial01@gmail.com"}],"readme":"# Agent SDK\r\n\r\nA composable TypeScript/Bun SDK for building LLM agents with tools, memory/context, teams, and task orchestration.\r\n\r\n## Runtime Support\r\n\r\n- Node.js 18.18+\r\n- Package outputs: ESM + CommonJS + TypeScript declarations\r\n\r\n## Install\r\n\r\n```bash\r\nnpm install agent-sdk\r\n```\r\n\r\nFor local development in this repository:\r\n\r\n```bash\r\nbun install\r\n```\r\n\r\n## Build\r\n\r\n```bash\r\nnpm run build\r\n```\r\n\r\n## Native Code Understanding\r\n\r\nCode understanding now runs as a native in-process capability when enabled.\r\n\r\n- `jcodemunch` and `native-dart` providers both resolve to `NativeCodeUnderstandingAdapter`.\r\n- `native-dart` applies a Dart language preference for ranking, while keeping the same core capability surface.\r\n- Stdio transport settings do not switch runtime behavior to MCP for these providers.\r\n\r\nOperational limits are enforced to keep indexing bounded and predictable:\r\n\r\n- `maxFiles` (default `2500`)\r\n- `maxFileSizeBytes` (default `524288`)\r\n- `maxTotalBytes` (default `67108864`)\r\n- source roots are constrained to authorized directories\r\n\r\nThese limits can be tuned through code-understanding configuration.\r\n\r\n## Import\r\n\r\n```ts\r\nimport { createOrchestrator } from 'agent-sdk'\r\n```\r\n\r\nCommonJS:\r\n\r\n```js\r\nconst { createOrchestrator } = require('agent-sdk')\r\n```\r\n\r\n## CLI\r\n\r\n```bash\r\nagent run \"Summarize this repository\"\r\nagent run --file prompts.txt --output json\r\nagent config init\r\n```\r\n\r\n## Examples\r\n\r\n```bash\r\nbun run examples:smoke\r\nbun run lab:lovable\r\nbun run lab:web-ui\r\n```\r\n\r\n`lab:lovable` defaults to NVIDIA's OpenAI-compatible endpoint (`https://integrate.api.nvidia.com/v1`) and model `z-ai/glm4.7`.\r\nIt now includes a concrete AI app-builder scenario that writes outputs inside a per-run sandbox under `examples-output/lovable-lab/`, with app files in `apps/todo-app-<run-id>/` and run artifacts in `artifacts/`.\r\n\r\nSet credentials before running:\r\n\r\n```bash\r\nset NVIDIA_API_KEY=your_key_here\r\n```\r\n\r\n`lab:web-ui` starts a local Lovable-style demo UI at `http://localhost:8788`:\r\n\r\n- Left pane: prompt/chat input for app-building requests.\r\n- Right pane: live execution trace (tool calls/results, assistant deltas) plus preview iframe.\r\n- Generated app files are sandboxed per session under `examples-output/lovable-web-studio/apps/`.\r\n\r\n## Docs\r\n\r\n```bash\r\nbun run docs:api\r\n```\r\n\r\n## Benchmarks\r\n\r\n```bash\r\nnpm run bench:resilience\r\nnpm run bench:tasks-dag-stress\r\nnpm run bench:code-understanding-large-repo\r\n```\r\n\r\n## Project Overview\r\n\r\nRead the full architecture and usage guide here:\r\n\r\n- [docs/project-overview.md](docs/project-overview.md)\r\n- [docs/frontend-integration-guide.md](docs/frontend-integration-guide.md)\r\n","readmeFilename":"README.md"}