{"_id":"@aurekai/llm-integrations","name":"@aurekai/llm-integrations","dist-tags":{"alpha":"0.8.0-alpha.1","latest":"0.8.0-alpha.1"},"versions":{"0.8.0-alpha.1":{"name":"@aurekai/llm-integrations","version":"0.8.0-alpha.1","description":"Provider-neutral Aurekai LLM binding layer — 48 operators, 9 families, 9 providers, canonical tool schema, evals harness.","type":"module","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/aurekai/aurekai-llm-integrations.git"},"engines":{"node":">=18"},"scripts":{"schemas:generate":"node ./scripts/generate-provider-schemas.mjs","gateway:demo":"node ./gateway/index.mjs","evals:run":"node ./evals/runner.mjs","openai:demo":"node ./providers/openai/run.mjs --dry-run","anthropic:demo":"node ./providers/anthropic/run.mjs --dry-run","gemini:demo":"node ./providers/gemini/run.mjs --dry-run","groq:demo":"node ./providers/groq/run.mjs --dry-run","perplexity:demo":"node ./providers/perplexity/run.mjs --dry-run","mistral:demo":"node ./providers/mistral/run.mjs --dry-run","xai:demo":"node ./providers/xai/run.mjs --dry-run","cohere:demo":"node ./providers/cohere/run.mjs --dry-run","local:demo":"node ./providers/local/run.mjs --dry-run","all:demo":"node ./scripts/run-all-demos.mjs"},"gitHead":"e705c26351cad6535a52def4ceefe5781b134ed8","_id":"@aurekai/llm-integrations@0.8.0-alpha.1","bugs":{"url":"https://github.com/aurekai/aurekai-llm-integrations/issues"},"homepage":"https://github.com/aurekai/aurekai-llm-integrations#readme","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-9VS4B9k/D9OPA9ecJY00CWXHJ7TcY3q6NeA+hlWoCW2qmfksZGL9glA2ViDV+rxb0JpF2ufM31kNbtqoHyMq1A==","shasum":"f2656888c434f00bebb039050daf5be7f534c981","tarball":"https://registry.npmjs.org/@aurekai/llm-integrations/-/llm-integrations-0.8.0-alpha.1.tgz","fileCount":84,"unpackedSize":354430,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAhERORbHVJZasHAkfANXkHZm9FQdJIAQUgTPOeRhLPxAiEAvih48sn+XFHCjvdfvOnlUjh0RxkpOV/qq5n8FPSZOuo="}]},"_npmUser":{"name":"nickgonzales76017","email":"nickgonzales76017@gmail.com"},"directories":{},"maintainers":[{"name":"nickgonzales76017","email":"nickgonzales76017@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/llm-integrations_0.8.0-alpha.1_1777838873893_0.23180901559707756"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-03T20:07:53.791Z","0.8.0-alpha.1":"2026-05-03T20:07:54.043Z","modified":"2026-05-03T20:07:54.291Z"},"maintainers":[{"name":"nickgonzales76017","email":"nickgonzales76017@gmail.com"}],"description":"Provider-neutral Aurekai LLM binding layer — 48 operators, 9 families, 9 providers, canonical tool schema, evals harness.","homepage":"https://github.com/aurekai/aurekai-llm-integrations#readme","repository":{"type":"git","url":"git+https://github.com/aurekai/aurekai-llm-integrations.git"},"bugs":{"url":"https://github.com/aurekai/aurekai-llm-integrations/issues"},"license":"Apache-2.0","readme":"<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/aurekai/aurekai/main/assets/aurekai-logo.svg\" alt=\"Aurekai\" width=\"520\" />\n</p>\n\n# `@aurekai/llm-integrations` · v0.8.0-alpha.1\n\nProvider-neutral LLM binding layer for the [Aurekai](https://github.com/aurekai/aurekai) capability runtime.\nExposes **48 operators across 9 capability families** to all major model providers via a unified canonical tool schema, MCP bridge, evals harness, and gateway router.\n\n## Capability Families\n\n| Family | Tools | Description |\n|---|---|---|\n| `runtime` | 8 | Dispatch, enqueue, gate, doctor, recipe runner |\n| `commerce` | 6 | Auth, invoicing, metering, ledger, feature gates |\n| `intake` | 4 | Transcription, ingest, transcript cleaning, frame extraction |\n| `memory` | 10 | Model pull, FPQ compress, vector search, SAE activate, embed, cache |\n| `proof` | 7 | Bundle, hash, lineage graph, export, canon parse, inspect |\n| `reason` | 3 | Session start, branch, diff |\n| `wire` | 3 | Tel listen, PCAP ingest, wire report |\n| `publish` | 4 | Brief, deliverable, distribute, narrate |\n| `substrate` | 3 | Space open/put, capability registry |\n\n## Provider Coverage\n\n| Provider | Tools | MCP | Schema Format | Evals |\n|---|---|---|---|---|\n| OpenAI | 48 | ✓ | `tools[].function` | ✓ |\n| Anthropic | 48 | ✓ | `tools[].input_schema` | ✓ |\n| Gemini | 48 | via bridge | `function_declarations[]` | ✓ |\n| Mistral | 48 | ✓ | `tools[].function` | ✓ |\n| Groq | 48 | ✓ | `tools[].function` | ✓ |\n| xAI | 48 | via aurekai-mcp | `tools[].function` | ✓ |\n| Perplexity | 48 | via aurekai-mcp | `functions[]` | ✓ |\n| Cohere | 48 | via aurekai-mcp | `parameter_definitions` | ✓ |\n| Local (Ollama/llama.cpp) | 48 | ✓ | `functions[]` | ✓ |\n\n## Quick Start\n\n```bash\nnpm install\nnpm run schemas:generate    # regenerate all 9 provider schemas from canonical\nnpm run evals:run           # 9 providers × 8 metrics dry-run matrix\nnpm run gateway:demo        # capability-aware provider router\nnpm run openai:demo         # OpenAI remote MCP demo\n```\n\n## Schemas\n\nCanonical contract: `schemas/aurekai-tools.canonical.json` — single source of truth.\nProvider schemas are **generated**; do not edit them manually.\n\n```bash\nnode scripts/generate-provider-schemas.mjs\n# → schemas/{openai,anthropic,gemini,mistral,groq,xai,perplexity,cohere,local}-tools.json\n```\n\n## Evals\n\n```bash\nnode evals/runner.mjs\n# → output/evals/evals-report.json  (9 providers × 8 metrics)\n# → output/evals/{provider}.akrun.json + .akproof.json\n```\n\nMetrics: `latency_ms`, `cost_usd`, `cache_hit_rate`, `proof_completeness`, `retrieval_precision`, `feature_drift`, `tool_call_success`, `schema_compliance`.\n\n## Gateway\n\nThe capability router in `gateway/index.mjs` selects the optimal provider for a request based on declared requirements (latency, cost, proof, retrieval, local):\n\n```js\nimport { gatewayRequest } from \"@aurekai/llm-integrations/gateway\";\nconst result = await gatewayRequest({ tool: \"aurekai.memory.vec_search\", query: \"...\" }, { prefer: \"local\" });\n```\n\n## Examples\n\n| Provider | Demo |\n|---|---|\n| OpenAI | [examples/openai-remote-mcp.md](examples/openai-remote-mcp.md) |\n| Anthropic | [examples/anthropic-claude-desktop-mcp.md](examples/anthropic-claude-desktop-mcp.md) |\n| Gemini | [examples/gemini-cache-bridge.md](examples/gemini-cache-bridge.md) |\n| Groq | [examples/groq-low-latency.md](examples/groq-low-latency.md) |\n| Perplexity | [examples/perplexity-citations.md](examples/perplexity-citations.md) |\n| Mistral | [examples/mistral-managed-connector.md](examples/mistral-managed-connector.md) |\n| xAI | [examples/xai-function-adapter.md](examples/xai-function-adapter.md) |\n| Cohere | [examples/cohere-rerank-pack.md](examples/cohere-rerank-pack.md) |\n| Local | [examples/local-llama-stack.md](examples/local-llama-stack.md) |\n\n## Monorepo Layout\n\n```\nproviders/       9 provider adapters (adapter.mjs, run.mjs, manifest.json, README.md)\ngateway/         capability-aware provider router\nschemas/         canonical tool contract + 9 generated provider schemas\nevals/           cross-provider benchmark harness + matrix.json\nexamples/        9 provider demos\ndocs/            architecture, provider matrix, roadmap\nscripts/         schema generator\n```\n\n## MCP\n\nAll 48 tools are available via [`@aurekai/mcp`](https://github.com/aurekai/aurekai-mcp) — add to any MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"aurekai\": { \"command\": \"npx\", \"args\": [\"-y\", \"@aurekai/mcp\"] }\n  }\n}\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-5a4e8ed65cf65450f69578c0b9ae8af1"}