{"_id":"@agent-os-lab/agent-game-runtime-sdk","_rev":"4-0704ac9a46374b5a3557d6ebd4c7bd76","name":"@agent-os-lab/agent-game-runtime-sdk","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.1":{"name":"@agent-os-lab/agent-game-runtime-sdk","version":"0.1.1","_id":"@agent-os-lab/agent-game-runtime-sdk@0.1.1","maintainers":[{"name":"zijunsoft","email":"zijun.soft@gmail.com"}],"dist":{"shasum":"f54f80efa18006700cb816a59d2b7df9310f291c","tarball":"https://registry.npmjs.org/@agent-os-lab/agent-game-runtime-sdk/-/agent-game-runtime-sdk-0.1.1.tgz","fileCount":7,"integrity":"sha512-T8LcblFtA8FcGcdShlfT2Mc5cZBNjKLecFvqJ8P5qyFKkWIxZYuDM36LQTKLEDMHHQm8zYfB/9+F7NkFGYQARg==","signatures":[{"sig":"MEQCIFjSYW0thRa8TsYxq58SIT8ZVoo3Lmn1/myD7G/UFrZbAiBNM9WZbDBlzuiHstcT816aV8MJtM/jcO17ZMmTGRPhnw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58138},"type":"module","exports":{".":"./src/index.ts"},"gitHead":"56e95700644a24db39c92c1ee78ff4b489a42c98","scripts":{"test":"bun test","typecheck":"tsc --noEmit -p tsconfig.json","sdk:publish":"bun scripts/publish-agent-game-runtime-sdk.ts"},"_npmUser":{"name":"zijunsoft","email":"zijun.soft@gmail.com"},"_npmVersion":"10.9.4","description":"Transport, presence-list, and office-configuration APIs for AgentOS integrations. This package is independently installable and does not render offices or avatars; visualization belongs to `@agent-os-lab/agent-game-sdk`.","directories":{},"_nodeVersion":"22.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-game-runtime-sdk_0.1.1_1783782191795_0.09859016498755002","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agent-os-lab/agent-game-runtime-sdk","version":"0.1.2","_id":"@agent-os-lab/agent-game-runtime-sdk@0.1.2","maintainers":[{"name":"zijunsoft","email":"zijun.soft@gmail.com"}],"dist":{"shasum":"aa47a2d29446996bae7e3d0afd14afc3e53ae872","tarball":"https://registry.npmjs.org/@agent-os-lab/agent-game-runtime-sdk/-/agent-game-runtime-sdk-0.1.2.tgz","fileCount":7,"integrity":"sha512-xXHucKVNYftva5m/ubAfXejsENxO5sNpNQAAEwts8qpNr+vb6BTMYoltIQc21TAZgtln5kM4RTM1RjFCLp6Q9w==","signatures":[{"sig":"MEYCIQCnLtpgX64PFSkqvKgTSGzuqbQGVbKJrZ/NovrHriT3qQIhAM2pgio4/4gg53DbAB+EVUBzO6/u0XmWqWz5ZFsMldKu","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":58138},"type":"module","exports":{".":"./src/index.ts"},"gitHead":"56e95700644a24db39c92c1ee78ff4b489a42c98","scripts":{"test":"bun test","typecheck":"tsc --noEmit -p tsconfig.json","sdk:publish":"bun scripts/publish-agent-game-runtime-sdk.ts"},"_npmUser":{"name":"zijunsoft","email":"zijun.soft@gmail.com"},"_npmVersion":"10.9.4","description":"Transport, presence-list, and office-configuration APIs for AgentOS integrations. This package is independently installable and does not render offices or avatars; visualization belongs to `@agent-os-lab/agent-game-sdk`.","directories":{},"_nodeVersion":"22.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-game-runtime-sdk_0.1.2_1783782308656_0.8169363891669215","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agent-os-lab/agent-game-runtime-sdk","version":"0.1.3","_id":"@agent-os-lab/agent-game-runtime-sdk@0.1.3","maintainers":[{"name":"zijunsoft","email":"zijun.soft@gmail.com"}],"dist":{"shasum":"5c0c62661396383987e8a921c174c620df0ef234","tarball":"https://registry.npmjs.org/@agent-os-lab/agent-game-runtime-sdk/-/agent-game-runtime-sdk-0.1.3.tgz","fileCount":6,"integrity":"sha512-tgFFDdoQaPSr/LZjr2fv0HtNee11leGg9RMf/g3djnPNNW+stxo6e4ZJtb1wJ8LaxCgJ//sMihj6DYnakudGVw==","signatures":[{"sig":"MEUCIQCcybWBDg/pc8+stKYxtmi3NmF+jjzcem5tw+hGO7CIsQIgHH2xQ4EyH1jw7n6c8q2wdod7M2gYmSyjW/GSsFyceFE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24039},"type":"module","exports":{".":"./src/index.ts"},"gitHead":"fef89eeb45f7e3b0e5955e54c419265e08e5eec4","scripts":{"test":"bun test","typecheck":"tsc --noEmit -p tsconfig.json","sdk:publish":"bun scripts/publish-agent-game-runtime-sdk.ts"},"_npmUser":{"name":"zijunsoft","email":"zijun.soft@gmail.com"},"_npmVersion":"10.9.4","description":"Transport and Presence APIs for AgentOS game integrations. This independently installable package contains no game-specific configuration, persistence, or rendering behavior.","directories":{},"_nodeVersion":"22.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-game-runtime-sdk_0.1.3_1783784162743_0.08648167312694444","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agent-os-lab/agent-game-runtime-sdk","version":"0.1.4","type":"module","exports":{".":"./src/index.ts"},"scripts":{"test":"bun test","typecheck":"tsc --noEmit -p tsconfig.json","sdk:publish":"bun scripts/publish-agent-game-runtime-sdk.ts"},"publishConfig":{"access":"public"},"_id":"@agent-os-lab/agent-game-runtime-sdk@0.1.4","gitHead":"19b8faaa9d991355f57bd065c9072f258b7818a7","description":"Transport and Presence APIs for AgentOS game integrations. This independently installable package contains no game-specific configuration, persistence, or rendering behavior.","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-tpHFnEdioO5s1GDYGPrKh4YCXUy2oadeZzraa6ogXyp2mxhXza1RV2Vs/r6qMmIAY3ixCu5vTL904evLHWUi7w==","shasum":"30e5703eb3bb910c805854098f052d534f2d67a1","tarball":"https://registry.npmjs.org/@agent-os-lab/agent-game-runtime-sdk/-/agent-game-runtime-sdk-0.1.4.tgz","fileCount":6,"unpackedSize":24039,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC1+d/Yq1F04oa2IYRbhuilJFJKko3FIOQUKGuLiyR4BwIhAME8QMJNM1FP/JNB8ylD4IHjcp7jpHCmSMSB2t0cPXlM"}]},"_npmUser":{"name":"zijunsoft","email":"zijun.soft@gmail.com"},"directories":{},"maintainers":[{"name":"zijunsoft","email":"zijun.soft@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-game-runtime-sdk_0.1.4_1783829623106_0.7248690420804089"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T15:03:11.608Z","modified":"2026-07-12T04:13:43.370Z","0.1.1":"2026-07-11T15:03:11.921Z","0.1.2":"2026-07-11T15:05:08.843Z","0.1.3":"2026-07-11T15:36:02.886Z","0.1.4":"2026-07-12T04:13:43.235Z"},"description":"Transport and Presence APIs for AgentOS game integrations. This independently installable package contains no game-specific configuration, persistence, or rendering behavior.","maintainers":[{"name":"zijunsoft","email":"zijun.soft@gmail.com"}],"readme":"# Agent Game Runtime SDK\n\nTransport and Presence APIs for AgentOS game integrations. This independently installable package contains no game-specific configuration, persistence, or rendering behavior.\n\n```bash\nbun add @agent-os-lab/agent-game-runtime-sdk\n```\n\nRuntime owns only token exchange, WebSocket messages, neutral `AgentPresence` data, and Presence list helpers.\n\nA single Runtime connection provides one Presence stream that can feed multiple games: the application maps each neutral record into each game's input contract. It neither knows which games consume the stream nor owns, loads, saves, or persists Office configuration.\n\n## Browser client\n\nBrowser code calls a same-origin BFF at `/api/agent-game-runtime-token` by default.\n\n```ts\nimport { AgentGameRuntimeBrowserClient, subscribeAgentPresenceList } from \"@agent-os-lab/agent-game-runtime-sdk\";\n\nconst client = new AgentGameRuntimeBrowserClient({\n  baseUrl: \"\",\n  subtenantId: \"workspace-a\",\n  accessToken: async () => getApplicationSessionToken(),\n});\n\nconst presence = await subscribeAgentPresenceList(client, {\n  onAgentsChange(agents) {\n    officeGame.update(agents.map(mapPresenceToOfficeInput));\n    strategyGame.update(agents.map(mapPresenceToStrategyInput));\n  },\n});\n\npresence.refresh();\npresence.close();\n```\n\nThe names above are application pseudocode, not imports from a concrete Game package. `accessToken` authenticates the browser request to the BFF; it is not the short-lived WebSocket token. The BFF determines tenant scope from trusted authentication.\n\n## Trusted server client\n\n```ts\nimport { AgentGameRuntimeServerClient } from \"@agent-os-lab/agent-game-runtime-sdk\";\n\nconst client = new AgentGameRuntimeServerClient({\n  baseUrl: process.env.AGENT_GAME_RUNTIME_BASE_URL!,\n  apiKey: process.env.AGENTOS_API_KEY!,\n  subtenantId: process.env.AGENTOS_SUBTENANT_ID,\n});\n```\n\nKeep `apiKey` on the server. The default service token path is `/api/v1/game-runtime-token`. See [USAGE.md](./USAGE.md) for token, scope, message, and lifecycle details.\n","readmeFilename":"README.md"}