{"_id":"@aimodes/connector-core","name":"@aimodes/connector-core","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aimodes/connector-core","version":"0.1.0","description":"Shared foundation for AI Modes connectors — device-token API client, transcript formatting, the eight-mode typology, parsers, and score renderers.","type":"module","license":"MIT","author":{"name":"AI Modes","url":"https://aimodes.ai"},"homepage":"https://aimodes.ai","repository":{"type":"git","url":"git+https://github.com/mk-bold/aimodes-site.git","directory":"connectors/packages/core"},"keywords":["aimodes","ai-engagement","mcp","transcript","scoring"],"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"node --test --experimental-strip-types test/*.test.ts","prepublishOnly":"npm run build && npm run test"},"engines":{"node":">=18"},"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"_id":"@aimodes/connector-core@0.1.0","bugs":{"url":"https://github.com/mk-bold/aimodes-site/issues"},"_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-gb0EAD1jAt69DcF1ilNYvv22dNuiQJAyVtkfk233N63EWyoZ2xFiwsQqG+kZqPWjBPcT+Cdp7nWs+kgV5uzL6w==","shasum":"4cc7edc8feab58ebefb89030ed9ed31ff15c4f8d","tarball":"https://registry.npmjs.org/@aimodes/connector-core/-/connector-core-0.1.0.tgz","fileCount":88,"unpackedSize":338659,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCvQdrfq+ocL6hdJmmkPXThCywF9o8H7pfXNVsLq/5ZzQIhAPrFVkrXvZ20ftdcCIWwAruYnfyvSar3OMf9PveKYDd/"}]},"_npmUser":{"name":"calelamb","email":"calejlamb@gmail.com"},"directories":{},"maintainers":[{"name":"calelamb","email":"calejlamb@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/connector-core_0.1.0_1782942275324_0.3804526835653488"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T21:44:35.110Z","0.1.0":"2026-07-01T21:44:35.468Z","modified":"2026-07-01T21:44:35.751Z"},"maintainers":[{"name":"calelamb","email":"calejlamb@gmail.com"}],"description":"Shared foundation for AI Modes connectors — device-token API client, transcript formatting, the eight-mode typology, parsers, and score renderers.","homepage":"https://aimodes.ai","keywords":["aimodes","ai-engagement","mcp","transcript","scoring"],"repository":{"type":"git","url":"git+https://github.com/mk-bold/aimodes-site.git","directory":"connectors/packages/core"},"author":{"name":"AI Modes","url":"https://aimodes.ai"},"bugs":{"url":"https://github.com/mk-bold/aimodes-site/issues"},"license":"MIT","readme":"# @aimodes/connector-core\n\nShared, zero-dependency foundation for every [AI Modes](https://aimodes.ai)\nconnector: the device-token API client, canonical transcript formatting, the\neight-mode engagement typology, conversation parsers, and score renderers.\n\nAI Modes scores AI conversations 0–100 against a research-backed, eight-mode\nengagement framework developed at BYU. This package is the single source of\ntruth used by the [`@aimodes/mcp-server`](https://www.npmjs.com/package/@aimodes/mcp-server)\nhub and, through it, the Claude Desktop, Gemini, VSCode, Cursor, and ChatGPT\nclients — so every surface behaves like the AI Modes Chrome extension.\n\n## Install\n\n```bash\nnpm install @aimodes/connector-core\n```\n\nNode 18+. ESM only. Zero runtime dependencies.\n\n## What's inside\n\n- **`AimodesClient`** — device-token API client for `POST /api/v1/extension/submit`\n  and `GET /api/v1/extension/status` on aimodes.ai. Tokens are minted at\n  `https://aimodes.ai/apps/ai-engagement/extension/auth`.\n- **`formatTranscript`** — the canonical `User:` / `Assistant:` transcript\n  formatter, byte-for-byte identical to the server's so dedup hashes line up.\n- **The eight modes** — the full typology with names, descriptions, and colors.\n- **Parsers** — turn loose pasted conversation text into role-tagged turns.\n- **Renderers** — score breakdowns as markdown, ANSI (terminal), or HTML.\n- **Feature modules** — calibration mirror, verify-before-merge, challenger,\n  problem-setter preflight, weekly letter, friction replay, drift trail, mode\n  mirror, and confusion confirm.\n\n## Quick start\n\n```ts\nimport { AimodesClient, parseConversation } from \"@aimodes/connector-core\";\n\nconst client = new AimodesClient({ token: process.env.AIMODES_DEVICE_TOKEN! });\n\nconst messages = parseConversation(rawPastedText);\nconst result = await client.submit({\n  provider: \"claude\", // \"claude\" | \"chatgpt\" | \"gemini\"\n  title: \"My conversation\",\n  sourceUrl: null,\n  messages,\n});\n```\n\n## License\n\nMIT © AI Modes\n","readmeFilename":"README.md","_rev":"1-324584a14662cb905a2c587194d5bf0a"}