Jonathan Hinkel 3421198537 Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template) Splits the SvelteKit app into three workspaces per docs/MONOREPO_MIGRATION_BRIEF.md: - packages/core (@webavatar/webavatar-core): session management, auth tokens, provider adapters, and the WS relay, with curated entry points (., ./client, ./server, ./vite) and a browser-stub guard on the server-only ones. - packages/humanoid (@webavatar/webavatar-humanoid): avatar-state derivation and animation-channel composition, depending on core only via type-only imports (no runtime reference to core in its built output). - apps/template: the SvelteKit application template, now importing both packages by name, routed through a server-only wrapper and a build-time guard (server-only-guard.ts) for the server/vite entries. Also collapses the duplicated server.js/vite-plugin composition wiring into a single createRealtimeRuntime factory (exported from packages/core/server), adds ESLint boundary-enforcement rules and Gitea Actions workflows (verify.yml, publish.yml), externalizes both packages in the production SSR build for artifact parity with a real client install, and rewrites the project documentation to match. No runtime behavior or wire protocol changes. Registry publication stays blocked on Gitea host/org placeholders not yet resolved — see the brief's status banner for exactly what remains. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>		1 month ago
.claude	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
.gitea/workflows	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
.vscode	initial commit	2 months ago
apps/template	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
docs	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
packages	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
.gitattributes	initial commit	2 months ago
.gitignore	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
.npmrc	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
.prettierignore	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
AGENTS.md	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
README.md	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
eslint.config.js	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
package-lock.json	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
package.json	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago
prettier.config.js	initial commit	2 months ago
tsconfig.base.json	Convert to an npm-workspaces monorepo (packages/core, packages/humanoid, apps/template)	1 month ago

README.md

webavatar

An npm-workspaces monorepo providing reusable core infrastructure for webavatar client projects — session management, auth tokens, and the realtime model connection — as independently-versioned packages, plus a SvelteKit template to branch client projects from.

See docs/ARCHITECTURE.md for the full architecture map, AGENTS.md for project conventions, and docs/ for a deep-dive per subsystem.

Workspaces

Workspace	What it is
`packages/core`	`@webavatar/webavatar-core` — session management, auth tokens, provider adapters, the WS relay. Every client project needs this.
`packages/humanoid`	`@webavatar/webavatar-humanoid` — avatar-state derivation and animation-channel composition for 3D humanoid avatars. Optional — only projects building a humanoid avatar need it.
`apps/template`	The SvelteKit application template client projects branch from. See its own README for the client-project bootstrap procedure.

Both packages are privately distributed (not published to the public npm registry) and ESM-only.

Getting started

npm install
cp apps/template/.env.example apps/template/.env
# fill in OPENAI_API_KEY and REALTIME_TOKEN_SECRET in apps/template/.env
npm run dev

The root npm run dev builds both packages once, then watches them alongside the template app's own dev server — this is what makes package-source hot reload work (see docs/REALTIME_SESSION.md's "Dev-mode reload behavior"). Open /demo/realtime or /demo/humanoid (works offline via REALTIME_PROVIDER=mock, no API key needed).

Scripts

Run from the repo root, these orchestrate all three workspaces:

npm run dev / npm run build / npm run check / npm test — build the packages first, then run the equivalent command across every workspace.
npm run lint / npm run format — prettier + eslint across the whole repo.

Run a single workspace's own scripts with -w, e.g. npm run dev -w apps/template, or npm run test -w packages/core.

Documentation

Subsystem	Doc
Architecture overview and module layering	docs/ARCHITECTURE.md
Realtime session management	docs/REALTIME_SESSION.md
Tool calling (server- and client-executed)	docs/TOOLS.md
Analytics recording	docs/ANALYTICS.md
Configuration (env vars, persona)	docs/CONFIGURATION.md
`@webavatar/webavatar-humanoid` (avatar-state, animation composition)	docs/HUMANOID.md
The monorepo migration itself — rationale, decisions, verification	docs/MONOREPO_MIGRATION_BRIEF.md