{"_id":"@adarsh23/guildcraft-sdk","_rev":"4-7f0fdaee83e59e266e7570e97547c6b2","name":"@adarsh23/guildcraft-sdk","dist-tags":{"latest":"2.0.0"},"versions":{"1.0.0":{"name":"@adarsh23/guildcraft-sdk","version":"1.0.0","keywords":["guildcraft","game","sdk","npc","ai"],"license":"MIT","_id":"@adarsh23/guildcraft-sdk@1.0.0","maintainers":[{"name":"adarsh23","email":"dharadarsh0@gmail.com"}],"homepage":"https://github.com/adarsh23/kite-ai#readme","bugs":{"url":"https://github.com/adarsh23/kite-ai/issues"},"dist":{"shasum":"1d5cddf88e470d05d66956e393e12a0fe4354718","tarball":"https://registry.npmjs.org/@adarsh23/guildcraft-sdk/-/guildcraft-sdk-1.0.0.tgz","fileCount":5,"integrity":"sha512-fc37LzkN/Bhx7m1rng1ahVjrJLljjPnYfBwUfJKy8DQCKqnt0kNoSU1u1awCqmDyjHzDb47qWzr1zhlROwPryw==","signatures":[{"sig":"MEUCIASO6DwikKJF2t8x4T8IFmtzTDnmPWfjSkkoiamhKGMgAiEAlaTOHlE4JEalWRAhP5chKm/Li+YWa6KALzB7aEZhEfo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4031},"main":"index.js","types":"index.d.ts","engines":{"node":">=18"},"gitHead":"77241bf6cf1e19a8c3b3f0530176abd323a01b44","_npmUser":{"name":"adarsh23","email":"dharadarsh0@gmail.com"},"repository":{"url":"git+https://github.com/adarsh23/kite-ai.git","type":"git"},"_npmVersion":"11.4.2","description":"GuildCraft JavaScript SDK for NPC chat and trade interactions","directories":{},"_nodeVersion":"24.4.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guildcraft-sdk_1.0.0_1775653295359_0.8849911979685814","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@adarsh23/guildcraft-sdk","version":"1.0.1","keywords":["guildcraft","game","sdk","npc","ai"],"author":{"name":"adarsh23"},"license":"MIT","_id":"@adarsh23/guildcraft-sdk@1.0.1","maintainers":[{"name":"adarsh23","email":"dharadarsh0@gmail.com"}],"homepage":"https://github.com/adarsh23/kite-ai#readme","bugs":{"url":"https://github.com/adarsh23/kite-ai/issues"},"dist":{"shasum":"de20a8bf7b8588deaad6408c8c713eb28457bee2","tarball":"https://registry.npmjs.org/@adarsh23/guildcraft-sdk/-/guildcraft-sdk-1.0.1.tgz","fileCount":4,"integrity":"sha512-IunA+O30aYug+t9xdhGoKGZ0IPe0SNfdAAwobLoKijk7TPVapxZvb9LbM5fXlAu92MfNUfXIla1EArYtGaF0Jg==","signatures":[{"sig":"MEYCIQD2QJMD6qrqNUjudIoS0rcdGAbC/0vDSernnOoO8bFm2gIhAO97XDPXetyb9rZEB6ElJYYH7B4RYD4NWzbuAppSANnW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":6505},"main":"index.js","types":"index.d.ts","engines":{"node":">=14.0.0"},"gitHead":"77241bf6cf1e19a8c3b3f0530176abd323a01b44","scripts":{"build":"echo 'No build step required'","prepare":"npm run build"},"_npmUser":{"name":"adarsh23","email":"dharadarsh0@gmail.com"},"repository":{"url":"git+https://github.com/adarsh23/kite-ai.git#readme","type":"git"},"_npmVersion":"11.4.2","description":"GuildCraft JavaScript SDK for NPC chat and trade interactions","directories":{},"_nodeVersion":"24.4.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guildcraft-sdk_1.0.1_1775655402120_0.3831142763402413","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@adarsh23/guildcraft-sdk","version":"1.0.2","keywords":["guildcraft","game","sdk","npc","ai"],"author":{"name":"adarsh23"},"license":"MIT","_id":"@adarsh23/guildcraft-sdk@1.0.2","maintainers":[{"name":"adarsh23","email":"dharadarsh0@gmail.com"}],"homepage":"https://github.com/adarsh23/kite-ai#readme","bugs":{"url":"https://github.com/adarsh23/kite-ai/issues"},"dist":{"shasum":"31ede55b4413a4831ff9497e776c227e42b7d98f","tarball":"https://registry.npmjs.org/@adarsh23/guildcraft-sdk/-/guildcraft-sdk-1.0.2.tgz","fileCount":5,"integrity":"sha512-x955D8VVaNPDbSSGLX9Lsa52q89wksfplAgmVtMXSZfei3SFnofox8iHG/m8bmQzKKCRhpea0ddRKQHYzIq2KQ==","signatures":[{"sig":"MEQCIBg65bDpCl0/AKSP0GYC+bdLWtQ39hLMoRe10cSX4IyfAiAQM2G5kRqONcCVlmeJOd9J4s5PcVON0VEnOe+7DXqgtg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8266},"main":"index.js","types":"index.d.ts","engines":{"node":">=14.0.0"},"gitHead":"77241bf6cf1e19a8c3b3f0530176abd323a01b44","scripts":{"build":"echo 'No build step required'","prepare":"npm run build"},"_npmUser":{"name":"adarsh23","email":"dharadarsh0@gmail.com"},"repository":{"url":"git+https://github.com/adarsh23/kite-ai.git#readme","type":"git"},"_npmVersion":"11.4.2","description":"GuildCraft JavaScript SDK for NPC chat and trade interactions","directories":{},"_nodeVersion":"24.4.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/guildcraft-sdk_1.0.2_1775655467476_0.1762845327652518","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@adarsh23/guildcraft-sdk","version":"2.0.0","description":"GuildCraft JavaScript SDK for autonomous NPC chat, streaming, and Web3 trade interactions","main":"index.js","module":"index.mjs","types":"index.d.ts","license":"MIT","keywords":["guildcraft","game","sdk","npc","ai"],"repository":{"type":"git","url":"git+https://github.com/adarsh23/kite-ai.git"},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./index.js"}},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"_id":"@adarsh23/guildcraft-sdk@2.0.0","gitHead":"9661c8e383029a8543f594b3c3a37b0eb39c7a50","bugs":{"url":"https://github.com/adarsh23/kite-ai/issues"},"homepage":"https://github.com/adarsh23/kite-ai#readme","_nodeVersion":"24.4.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-YovVSErEOusLn7kvdCT/pjtPi6oom0QrTHzVC69/D3ZIb5Qrv8z0bkdNF04oor6btjocjpTIrfgBR6NEYzIDmA==","shasum":"b2bd207357655ba680f67c7436483947095c65ed","tarball":"https://registry.npmjs.org/@adarsh23/guildcraft-sdk/-/guildcraft-sdk-2.0.0.tgz","fileCount":6,"unpackedSize":34010,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF+hZ98j1CtOxwm3wTMt5siAN6f0LYC9VUDUyqqtIXchAiEA4PZOxG1no73sqT4xCUq4jWprMOkYgZ3YKJ/UqyjkBKI="}]},"_npmUser":{"name":"adarsh23","email":"dharadarsh0@gmail.com"},"directories":{},"maintainers":[{"name":"adarsh23","email":"dharadarsh0@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/guildcraft-sdk_2.0.0_1776607723852_0.9354004700014815"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T13:01:35.256Z","modified":"2026-04-19T14:08:44.121Z","1.0.0":"2026-04-08T13:01:35.511Z","1.0.1":"2026-04-08T13:36:42.260Z","1.0.2":"2026-04-08T13:37:47.621Z","2.0.0":"2026-04-19T14:08:44.004Z"},"bugs":{"url":"https://github.com/adarsh23/kite-ai/issues"},"license":"MIT","homepage":"https://github.com/adarsh23/kite-ai#readme","keywords":["guildcraft","game","sdk","npc","ai"],"repository":{"type":"git","url":"git+https://github.com/adarsh23/kite-ai.git"},"description":"GuildCraft JavaScript SDK for autonomous NPC chat, streaming, and Web3 trade interactions","maintainers":[{"name":"adarsh23","email":"dharadarsh0@gmail.com"}],"readme":"# GuildCraft SDK\n\nGuildCraft is a lightweight JavaScript SDK for integrating autonomous, LLM-powered NPCs into games with Web3-native transaction flows.\n\nThis package exposes a single client class that handles:\n\n- NPC chat and decision loops\n- Streaming responses for real-time UX\n- Character and game/project management\n- Kite-backed transaction execution for NPC trade actions\n\n## Installation\n\n```bash\nnpm install @adarsh23/guildcraft-sdk\n```\n\n## Quickstart\n\n### CommonJS\n\n```js\nconst { GuildCraftClient } = require('@adarsh23/guildcraft-sdk')\n\nconst client = new GuildCraftClient(\n  process.env.GUILDCRAFT_API_KEY,\n  process.env.GUILDCRAFT_API_BASE_URL || 'http://localhost:3000/api'\n)\n\nasync function run() {\n  const reply = await client.chat('char_merchant_bob', 'Do you have healing potions?')\n  console.log(reply.response)\n\n  if (reply.tradeIntent) {\n    const tx = await client.executeTransaction('char_merchant_bob', reply.tradeIntent)\n    console.log('Trade settled:', tx.mode, tx.txHash)\n  }\n}\n\nrun().catch(console.error)\n```\n\n### ESM\n\n```js\nimport { GuildCraftClient } from '@adarsh23/guildcraft-sdk'\n\nconst client = new GuildCraftClient(\n  process.env.GUILDCRAFT_API_KEY,\n  process.env.GUILDCRAFT_API_BASE_URL || 'http://localhost:3000/api'\n)\n```\n\n## Streaming Chat\n\n```js\nfor await (const event of client.chatStream('char_merchant_bob', 'What is the market mood today?')) {\n  if (event.type === 'text_delta') process.stdout.write(event.delta)\n  if (event.type === 'done') console.log('\\nAction:', event.final?.action)\n}\n```\n\n## Core API\n\n### new GuildCraftClient(apiKey, baseUrl?)\n\n- apiKey: Required. Must start with gc_live_.\n- baseUrl: Optional. Defaults to http://localhost:3000/api.\n\n### Character APIs\n\n- getCharacters()\n- getCharacter(characterId)\n- deployCharacter({ name, config, gameIds? })\n- updateCharacter({ characterId, name?, config })\n\n### Game APIs\n\n- createGame(name)\n- getGames()\n- getGameCharacters(gameId)\n- assignCharactersToGame(gameId, characterIds)\n\n### Chat and Actions\n\n- chat(characterId, message, opts?)\n- chatStream(characterId, message, opts?)\n- executeTransaction(characterId, tradeIntent)\n- npcInteract(initiatorId, targetName, message, tradeIntent?)\n\n## Error Handling\n\nAll SDK errors throw GuildCraftError with:\n\n- name\n- status\n- body\n\nExample:\n\n```js\ntry {\n  await client.getCharacter('missing-id')\n} catch (err) {\n  console.error(err.name, err.status, err.body)\n}\n```\n\n## Requirements\n\n- Node.js 18+\n- A valid GuildCraft API key\n\n## License\n\nMIT\n","readmeFilename":"README.md"}