{"_id":"@archal/twin-core","_rev":"4-80ae0c7348625d66dbba1f43f49634eb","name":"@archal/twin-core","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@archal/twin-core","version":"0.1.0","keywords":["ai","agent","testing","mcp","digital-twin","archal"],"license":"MIT","_id":"@archal/twin-core@0.1.0","maintainers":[{"name":"aidantiruvan","email":"aidan@archal.ai"}],"homepage":"https://github.com/Archal-Labs/archal","bugs":{"url":"https://github.com/Archal-Labs/archal/issues"},"dist":{"shasum":"206c7f069fd93d8886076620d04611ee227ff93d","tarball":"https://registry.npmjs.org/@archal/twin-core/-/twin-core-0.1.0.tgz","fileCount":5,"integrity":"sha512-pW0zbvkJmYURl+a4w93Ebjp1myllVLAWTTiFRDcRGD0efgHBVQGoTcz0FJeTqE13ckN1yvOzvB/rddCkQxJKwQ==","signatures":[{"sig":"MEYCIQC4P31TipUSEAIk2ProunYl5kslkQqC2gROTLx+KNV12wIhAP78ZLPSl78WPdaTKdsBnpPvYwOQWP4Sz5bFya3vJiMr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19612},"main":"dist/index.js","type":"module","_from":"file:archal-twin-core-0.1.0.tgz","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"}},"scripts":{"test":"vitest run --passWithNoTests","build":"tsup src/index.ts --format esm --dts","typecheck":"tsc --noEmit"},"_npmUser":{"name":"aidantiruvan","email":"aidan@archal.ai"},"_resolved":"C:\\Users\\Aidan\\AppData\\Local\\Temp\\4c39541cefeb2d22e0d8bb58ee24a165\\archal-twin-core-0.1.0.tgz","_integrity":"sha512-pW0zbvkJmYURl+a4w93Ebjp1myllVLAWTTiFRDcRGD0efgHBVQGoTcz0FJeTqE13ckN1yvOzvB/rddCkQxJKwQ==","deprecated":"Bundled into the \"archal\" package. Use \"npm i archal\" instead.","repository":{"url":"git+https://github.com/Archal-Labs/archal.git","type":"git","directory":"twins/core"},"_npmVersion":"10.8.2","description":"Shared digital twin infrastructure","directories":{},"_nodeVersion":"20.18.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.4.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.0","vitest":"^2.1.0","typescript":"^5.7.0","@types/node":"^25.2.3"},"_npmOperationalInternal":{"tmp":"tmp/twin-core_0.1.0_1770858890730_0.8434785725854796","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-02-12T01:14:50.638Z","modified":"2026-05-20T03:58:18.747Z","0.1.0":"2026-02-12T01:14:50.881Z"},"bugs":{"url":"https://github.com/Archal-Labs/archal/issues"},"license":"MIT","homepage":"https://github.com/Archal-Labs/archal","keywords":["ai","agent","testing","mcp","digital-twin","archal"],"repository":{"url":"git+https://github.com/Archal-Labs/archal.git","type":"git","directory":"twins/core"},"description":"Shared digital twin infrastructure","maintainers":[{"name":"aidantiruvan","email":"aidan@archal.ai"},{"name":"noahsong-sdg","email":"noah@archal.ai"}],"readme":"# @archal/twin-core\n\nShared digital twin infrastructure for Archal.\n\nThis package provides the foundational types, utilities, and base classes used by all Archal digital twin implementations. It is not typically installed directly by end users — it exists as a dependency of twin packages like `@archal/twin-github` and `@archal/twin-slack`.\n\n## What It Provides\n\n- **Types** — `ScenarioReport`, `RunResult`, `TraceEntry`, `ToolCall`, `SeedData`, and other shared interfaces\n- **StateEngine** — Core state management used by twin packages to track and mutate simulated environment state\n- **MCP Server Base Class** — Common foundation for exposing twin tools over MCP stdio transport\n- **Seed Loading Utilities** — Helpers for discovering, validating, and loading seed data files\n\n## Who Uses This\n\nIf you are **building a new digital twin** for Archal (e.g., simulating Jira, Linear, or another service), this package gives you the base infrastructure so you can focus on defining tools and seed data.\n\nIf you are **running scenarios against an agent**, you do not need to install this package directly. It is pulled in automatically by the twin packages.\n\n## Install\n\n```bash\nnpm install @archal/twin-core\n```\n\n## Example\n\n```typescript\nimport { StateEngine, McpTwinServer } from \"@archal/twin-core\";\nimport type { SeedData, TraceEntry } from \"@archal/twin-core\";\n```\n\n## Documentation\n\nFor full documentation, architecture details, and guides on authoring new twins, see the [Archal monorepo on GitHub](https://github.com/Archal-Labs/archal).\n\n## License\n\nMIT\n","readmeFilename":"README.md"}