glirastes 0.1.3 → 0.2.0

package/CHANGELOG.md

@@ -2,467 +2,38 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.18.26] - 2026-04-05
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-### Fixed
-- simplify auto-scroll — remove racy isProgrammaticScrollRef (chat-react)
+## [Unreleased]
 
-## [0.18.25] - 2026-04-05
-
-### Fixed
-- fix auto-scroll race condition in MessageList (chat-react)
-
-## [0.18.23] - 2026-04-05
-
-### Added
-- add client-side timestamp to telemetry events (telemetry)
-
-### Fixed
-- skip approval resolve for tools that never required approval (adapter)
-
-## [0.18.20] - 2026-04-05
-
-### Fixed
-- sync reads glirastes config and scans NestJS controllers (cli)
-
-## [0.18.19] - 2026-04-04
-
-### Fixed
-- generate into frontend app instead of ai-shared package (cli)
-
-## [0.18.18] - 2026-04-04
-
-### Fixed
-- use relative imports for monorepo UI tool scanning (codegen)
-
-## [0.18.17] - 2026-04-04
-
-### Fixed
-- add default inputSchema and z import to generated NestJS tools (codegen)
-
-## [0.18.16] - 2026-04-04
-
-### Added
-- extract needsApproval and allowedRoles from @AiTool (codegen)
-
-## [0.18.15] - 2026-04-04
-
-### Fixed
-- scan monorepo dirs for useAiClientAction handlers (codegen)
-
-## [0.18.14] - 2026-04-04
-
-### Added
-- add applyAiExtensions for OpenAPI x-ai metadata (adapter-nestjs)
-
-## [0.18.13] - 2026-04-04
-
-### Fixed
-- include NestJS tool count in coverage totals (codegen)
-
-## [0.18.12] - 2026-04-04
-
-### Fixed
-- share glirastes config (nestjsDirs) across all commands (cli)
-
-## [0.18.11] - 2026-04-04
-
-### Fixed
-- support backtick template literals in @AiTool description parsing (codegen)
-
-## [0.18.10] - 2026-04-04
-
-### Fixed
-- distinguish file-level vs method-level @ai-ignore in NestJS scanner (codegen)
-
-## [0.18.9] - 2026-04-04
-
-### Added
-- detect NestJS controllers without @AiTool decorators (codegen)
-
-## [0.18.8] - 2026-04-04
-
-### Added
-- add NestJS @AiTool decorator scanner and monorepo codegen support (codegen)
-
-## [0.18.7] - 2026-04-04
-
-### Fixed
-- auto-confirm framework in monorepo mode (cli)
-- auto-overwrite managed skills without prompting (cli)
-- deduplicate next steps in init summary (cli)
-- use package-manager-agnostic wording in codegen next steps (cli)
-
-## [0.18.6] - 2026-04-04
-
-### Fixed
-- remove API key prefix validation from glirastes step (cli)
-
-## [0.18.5] - 2026-04-04
-
-### Added
-- rewrite runInit with monorepo shared/per-app flow (cli)
-- extend summary for multi-app monorepo output (cli)
-- add scope field to all init steps (cli)
-- add per-app dependency installation helper (cli)
-- add monorepo detection with workspace + fallback scanning (cli)
-- add monorepo types to init system (cli)
-
-## [0.18.4] - 2026-04-03
-
-### Fixed
-- remove runtime peer dep check (false positives in browser) (chat-react)
-
-## [0.18.3] - 2026-04-03
-
-### Fixed
-- replace Tailwind classes with inline styles in AiTriggerButton (chat-react)
-
-## [0.18.2] - 2026-04-03
-
-### Fixed
-- lazy-load wavesurfer.js to prevent silent import failures (chat-react)
-
-## [0.18.1] - 2026-04-03
-
-### Fixed
-- resolve approvals across request boundaries (lancer,adapter-nextjs)
-
-## [0.18.0] - 2026-04-03
-
-### Added
-- multilingual intent classifier with Snowball stemming (server-core)
-
-## [0.17.2] - 2026-04-02
-
-### Added
-- use local intent classifier instead of lancer.primus.classify (server-pro)
-- add local intent classifier with Jaccard heuristic + LLM support (server-core)
-
-### Fixed
-- improve intent classifier robustness (server-core)
-
-## [0.17.0] - 2026-04-01
-
-### Added
-- **Transport abstraction** — `ChatTransport` interface decouples `AiChatProvider` from the Vercel AI SDK, enabling custom transports (SSE, WebSocket, LangGraph, LangChain, or any streaming backend). Built-in `useVercelAiChatTransport` remains the default. CLI `init` now offers transport selection. (chat-react, cli)
-
-## [0.16.1] - 2026-04-01
-
-### Fixed
-- emit modelId on session.ended events for accurate cost analytics (telemetry)
-- use topological build order to prevent race conditions (build)
-
-## [0.16.0] - 2026-04-01
-
-### Added
-- **Lancer platform client** — thin HTTP client with gate, primus, warden, aegis, config, telemetry namespaces and graceful fallback (lancer)
-- **server-core / server-pro split** — open-core architecture: MIT server-core + proprietary server-pro with Lancer-delegated pipeline (server-core, server-pro)
-- **PII Shield** — createPiiShield factory with session mapping, seeded pseudonyms, fake data, leakage detection, and Aegis Pro detector (pii-shield)
-- **CodeGen pipeline** — MCP server generator, auto-recommendation, skill generator with CSO-optimized frontmatter, meta-skill template (codegen)
-- **CLI enhancements** — `--remote` flag for Glirastes-managed file generation, `--sync` flag, generate-mcp-server, auto-recommend commands, .env auto-load (cli)
-- **Lancer approvals** — approval namespace with traceId, fail-closed fallback, adapter-nextjs integration (lancer, adapter-nextjs)
-- **Telemetry** — traceId propagation across pipeline events, telemetry buffer with auto-flush (lancer, adapter-nextjs)
-- **AnalyzeOptions** — pseudonymize default and sessionId support for Aegis analyze (lancer)
-- agent identification headers for SDK telemetry auto-population (lancer)
-- flat models map as alternative to modelSelector config (server-core)
-- PiiDetector interface and simplified PiiShieldConfig (contracts)
-- traceId field to TelemetrySink emit event type (contracts)
-
-### Fixed
-- checkLeakage added to AegisNamespace, mappingToken nullability (lancer)
-- dot-notation tool ID for approval checks (server-core, adapter-nextjs)
-- respect local needsApproval: false in Lancer wrapper (adapter-nextjs)
-- error-safe telemetry flush (lancer)
-- pii-shield exports compiled dist instead of TypeScript source (pii-shield)
-
-### Changed (Breaking)
-- `server-node` renamed to `server-core` (`glirastes/server`)
-- `ai-router` renamed to `server-pro` (`glirastes/server`)
-- server-pro no longer re-exports server-core — import core features from `glirastes/server` directly
-
-## [0.15.16] - 2026-03-23
-
-### Fixed
-- allow dragging from anywhere on the trigger button (chat-react)
-
-## [0.15.15] - 2026-03-23
-
-### Added
-- make AI trigger button draggable (chat-react)
-- add SDK-wide audit event bus and PCI DSS compliance hardening (core)
-- add agent skill generator for Claude Code and Codex (codegen)
-
-## [0.1.0-beta.18] - 2026-03-30
-
-### Fixed
-- add checkLeakage to AegisNamespace and fix mappingToken nullability (lancer)
-
-## [0.1.0-beta.17] - 2026-03-26
-
-### Fixed
-- use dot-notation tool ID for approval checks (server-core,adapter-nextjs)
-
-## [0.1.0-beta.16] - 2026-03-26
-
-### Fixed
-- respect local needsApproval: false in Lancer wrapper (adapter-nextjs)
-
-## [0.1.0-beta.15] - 2026-03-26
-
-### Added
-- pass traceId to Lancer approval checks (adapter-nextjs)
-
-## [0.1.0-beta.9] - 2026-03-25
-
-### Added
-- implement createPiiShield factory with full PiiShield interface (pii-shield)
-- add in-memory session mapping with seeded pseudonyms (pii-shield)
-- add seeded fake data generator with DE/EN pools (pii-shield)
-- add basic string-match leakage detection (pii-shield)
-- add deep-walk utility for recursive object traversal (pii-shield)
-- scaffold package with contracts peer dep (pii-shield)
-- add PiiDetector interface, simplify PiiShieldConfig (contracts)
-
-### Fixed
-- add getPseudonym, remove unused config fields, handle pseudonym collisions (pii-shield)
-- use beta dist-tag for prerelease versions (ci)
-
-## [0.1.0-beta.8] - 2026-03-25
-
-### Added
-- implement createPiiShield factory with full PiiShield interface (pii-shield)
-- add in-memory session mapping with seeded pseudonyms (pii-shield)
-- add seeded fake data generator with DE/EN pools (pii-shield)
-- add basic string-match leakage detection (pii-shield)
-- add deep-walk utility for recursive object traversal (pii-shield)
-- scaffold package with contracts peer dep (pii-shield)
-- add PiiDetector interface, simplify PiiShieldConfig (contracts)
-
-### Fixed
-- add getPseudonym, remove unused config fields, handle pseudonym collisions (pii-shield)
-- use beta dist-tag for prerelease versions (ci)
-
-## [0.1.0-beta.1] - 2026-03-21
-
-### Added
-- add configurable degradation behavior per Glirastes service (lancer,server-pro)
-
-## [0.1.0-beta.0] - 2026-03-21
+## [0.2.0] - 2026-04-27
 
 ### Added
-- harden with Lancer guard, audit fix, and Pro pipeline factory (server-pro)
-- close 5 glirastes parity gaps — router tiers, variant generator, leakage detection, classifier buckets (core)
-- Migration Parity Hardening — lock contracts, async PII rehydration, parity harness (core)
-- move platform client to SDK, add primus/warden/aegis namespaces (lancer)
-- add Lancer delegation to ai-router and pii-shield (core)
-- split server-node into server-core (MIT) and server-pro (proprietary) (core)
-- include allowedRoles in registry sync (cli)
-- add Lancer platform integration to SDK (core)
-- add SDK-wide audit event bus and PCI DSS compliance hardening (core)
-- add agent skill generator for Claude Code and Codex (codegen)
 
-### Fixed
-- rehydrate tool args asynchronously in adapter path (pii-shield)
-- align runtime payload contracts with glirastes api (lancer)
-- remove dead fast-path storage, add rehydrate shape validation (core)
-
-### Changed (Breaking)
-- glirastes/server, (core)
-
-## [0.16.0] — 2026-03-18
-
-### BREAKING CHANGES
-
-#### Removed packages
-- **`glirastes/server`** — Intent classification, guardrails, model selection now handled via Lancer (Glirastes Pro). Local routing logic moved to `server-core`.
-- **`glirastes/server`** — PII protection now handled via Lancer Aegis (Glirastes Pro). Types moved to `contracts`.
-- **`glirastes/server`** — Use `server-core` and `server-pro` directly.
-
-### Added
-- **`contracts`**: Routing, classification, followup, PII, guardrail, and pipeline types (from ai-router/pii-shield)
-- **`server-core`**: `createFollowupTool()`, `createAiRouter()`, `defineModule()`, `createModelSelector()`
-- **`server-pro`**: `createAiPipeline()` — Pro pipeline factory with Lancer integration and graceful degradation
-- **`server-pro`**: `proToolsToAiTools()` now gracefully degrades when Lancer is undefined (falls back to local RBAC)
+- Initial public release of `glirastes`.
+- Type-safe tool definitions via `defineEndpointTool()` and `defineUiTool()`.
+- Role-based access control (RBAC) at the tool layer.
+- Approval flows for sensitive tool calls.
+- Server adapters for Next.js (App Router) and NestJS (decorators).
+- React chat UI components, hooks, and provider.
+- UI Action bus for declarative client-side dispatch from tool results.
+- PII shield with anonymization, pseudonymization, and rehydration.
+- Lancer client for the Glirastes platform with graceful degradation.
+- CLI: `init`, `generate`, `validate`, `coverage`, `scaffold`.
+- Codegen for endpoint registries, UI registries, action IDs, and modules.
+- OpenAPI generator: turn an OpenAPI spec into endpoint tool definitions.
+- Testing utilities for tool setups without LLM calls.
+- `engines.node` field declaring Node.js `>=20` as the supported runtime.
+- CI: `npm audit` job (production deps, level=high) on every PR and push.
+- CI: CodeQL static analysis with `security-and-quality` query suite.
 
 ### Changed
-- **`adapter-nextjs`**: `glirastes/server` and `glirastes/server` removed from peer dependencies. Pipeline comes from `server-pro`.
-- **`testing`**: Replaced ai-router dependency with contracts + server-core
-- **Skill templates**: Pro features clearly marked, Free vs Pro examples added
-
-### Migration
-```typescript
-// OLD
-import { createAiPipeline, defineModule } from 'glirastes/server';
-import { createPiiShield } from 'glirastes/server';
-
-// NEW
-import { createAiPipeline } from 'glirastes/server';
-import { defineModule } from 'glirastes/server';
-import type { PiiShield } from 'glirastes';
-```
-
-
-## [0.15.14] - 2026-03-11
-
-### Added
-- strip extra fields from tool results and reduce token waste (server-node,adapter-nextjs)
-
-### Fixed
-- add triggers, tags, and improved descriptions to skill templates (cli)
-
-## [0.15.12] - 2026-03-10
-
-### Fixed
-- use SVG for stop icon in recording bar and trigger button (chat-react)
-
-## [0.15.11] - 2026-03-10
-
-### Fixed
-- simplify recording bar stop button and unify X icon style (chat-react)
-
-## [0.15.10] - 2026-03-10
-
-### Fixed
-- polish recording UI with inline styles and stop button color (chat-react)
-
-## [0.15.9] - 2026-03-10
-
-### Added
-- improve recording bar with SVG icons and loading dots (chat-react)
-- export AiTriggerButton from package index (chat-react)
-- add AiTriggerButton component (chat-react)
-- add AiTriggerButtonProps type (chat-react)
-
-### Fixed
-- use named ReactElement import instead of React namespace (chat-react)
-
-## [0.15.7] - 2026-03-10
-
-### Added
-- render markdown in default message bubble (chat-react)
-
-## [0.15.4] - 2026-03-09
-
-### Added
-- add upgrade command to update glirastes package (cli)
-
-### Fixed
-- handle null options in AiChatService and fix factory type (adapter-nestjs)
-
-## [0.15.3] - 2026-03-09
-
-### Added
-- add upgrade command to update glirastes package (cli)
-
-## [0.15.1] - 2026-03-09
-
-### Added
-- auto-extract @Param() path parameters into tool inputSchema (adapter-nestjs)
-
-### Fixed
-- pass getToken and baseUrl to VoiceInputAddon in MentionInput (chat-react)
-- anchor opposite edge during panel drag-resize (chat-react)
-
-## [0.15.0] - 2026-03-09
-
-### Added
-- add token-based auth to voice input WebSocket connections (chat-react)
-- add chat module with controller, service, and speech stream gateway (adapter-nestjs)
-- add rolesResolver for fallback allowedRoles resolution (adapter-nestjs)
-- add constraint validation and detailed error messages (sdk)
-- auto-derive tool input schema from @ApiProperty metadata (adapter-nestjs)
-- auto-extract @Param() path parameters into tool inputSchema (adapter-nestjs)
-
-### Fixed
-- use hasAiRelevantMeta in runtime explorer service (adapter-nestjs)
-
-## [0.14.3] - 2026-03-09
-
-### Fixed
-- hide suggestion bar when typing indicator is shown (chat)
-- preserve pending approval tool calls in deduplication (adapter-nextjs)
-
-## [0.14.2] - 2026-03-09
-
-### Added
-- add loop detection and improve pipeline timeline UI (chat)
-
-## [0.14.1] - 2026-03-06
-
-### Fixed
-- auto-detect and add missing framework skills on update-skills (cli)
-
-## [0.14.0] - 2026-03-06
-
-### Added
-- add drag-resize panel hook and enhance ChatWindow and RichMentionInput (chat-react)
-- add conventional commit parser (cli)
-
-## [0.13.0] - 2026-03-06
-
-### Added
-- add edge resize, viewport clamping, and header render prop to ChatWindow (chat-react)
-
-## [0.12.0] - 2026-03-06
-
-### Added
-- add baseUrl support for voice input and headers prop for AiChatProvider (chat-react)
-
-## [0.11.0] - 2026-03-06
-
-### Added
-- add framework-specific skill templates and parent/child hierarchy (cli)
-- add ChatWindow, RichMentionInput, VoiceInputAddon, and template layer (chat-react)
-
-## [0.10.0] - 2026-03-05
-
-### Added
-- support optional tool roles and anonymize rehydration (core)
-- add upgrade gap checks and changelog automation (cli)
-- add compiled AudioWorklet processor (chat-react)
-- add AudioWorklet processor for STT (chat-react)
-- add gap detector utility (cli)
-- add changelog diff utility (cli)
-- add changelog parser utility (cli)
-
-### Fixed
-- resolve ReDoS vulnerability and improve gap detection (cli)
-- correct changelog diff boundary behavior (cli)
-- separate .vscode and .worktrees in gitignore (core)
-- improve changelog parser robustness (cli)
-
-### Changed (Breaking)
-- removed speechTokenEndpoint option and speech-token templates. (stt)
-
-## [0.9.0] - 2026-03-05
-
-### Added
-- Baseline release entry for changelog tracking (core)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 
+- `react-markdown` and `wavesurfer.js` are now optional `peerDependencies`
+  rather than runtime `dependencies`. Server-only consumers no longer pull
+  these libraries on install. `react-markdown` is loaded via `React.lazy`
+  with a plain-text fallback when the peer dep is not installed.
 
+[Unreleased]: https://github.com/chainmatics/glirastes/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/chainmatics/glirastes/releases/tag/v0.2.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Chainmatics
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,11 @@
+glirastes
+Copyright 2025-2026 Chainmatics GmbH
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this software except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+This product includes software developed at Chainmatics GmbH
+(https://chainmatics.de).

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://github.com/chainmatics/glirastes">
-    <img alt="Glirastes SDK" src="https://raw.githubusercontent.com/chainmatics/glirastes/main/.github/banner.svg" width="100%">
+    <img alt="Glirastes SDK" src=".github/hero.gif" width="100%">
   </a>
 </p>
 
@@ -20,7 +20,8 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/glirastes"><img src="https://img.shields.io/npm/v/glirastes?style=flat-square&labelColor=0a0a0a&color=6366f1" alt="npm version"/></a>
   <a href="#"><img src="https://img.shields.io/badge/TypeScript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white&labelColor=0a0a0a" alt="TypeScript"/></a>
-  <a href="#"><img src="https://img.shields.io/badge/AI_SDK-compatible-8b5cf6?style=flat-square&labelColor=0a0a0a" alt="AI SDK"/></a>
+  <a href="https://sdk.vercel.ai/"><img src="https://img.shields.io/badge/Vercel_AI_SDK-compatible-8b5cf6?style=flat-square&labelColor=0a0a0a" alt="Vercel AI SDK"/></a>
+  <a href="https://langchain-ai.github.io/langgraph/"><img src="https://img.shields.io/badge/LangGraph-compatible-1c3c3c?style=flat-square&labelColor=0a0a0a" alt="LangGraph"/></a>
 </p>
 
 <br/>
@@ -31,7 +32,7 @@
 
 ## What is this?
 
-**glirastes** is a TypeScript SDK for building AI-powered chat and tool systems. You describe what the AI can do with a handful of declarative tool definitions, and the SDK turns them into [AI SDK](https://sdk.vercel.ai/)-compatible tools that call your APIs, stream responses to the client, and trigger UI updates — all type-safe, all in one place.
+**glirastes** is a TypeScript SDK for building AI-powered chat and tool systems. You describe what the AI can do with a handful of declarative tool definitions, and the SDK turns them into [Vercel AI SDK](https://sdk.vercel.ai/)-compatible tools that call your APIs, stream responses to the client, and trigger UI updates — all type-safe, all in one place. If your backend already runs [LangGraph](https://langchain-ai.github.io/langgraph/) instead, the same chat UI works against it via the LangGraph transport — no migration required.
 
 It ships as a single npm package with subpath exports:
 
@@ -90,6 +91,20 @@ Building an AI feature means wiring together **tool definitions**, **API calls**
 npm install glirastes
 ```
 
+> **Requirements:** Node.js `>=20`, React `^19` (for the chat UI — `react-dom` is pinned to `^19`).
+>
+> **Peer dependencies for the React chat UI** (only install what you use):
+> ```bash
+> # Required for VercelAiChat / LangGraphAiChat:
+> npm install react react-dom ai @ai-sdk/react
+>
+> # Optional — enables Markdown rendering in messages (falls back to plain text):
+> npm install react-markdown
+>
+> # Optional — enables waveform visualization for voice input:
+> npm install wavesurfer.js
+> ```
+
 ### 2. Define a tool next to your API route
 
 Co-locate the tool definition with the `route.ts` it exposes. The SDK uses the declared `method` + `path` to call your own API when the LLM picks this tool — you never write a `fetch` yourself.
@@ -618,6 +633,8 @@ import { VoiceInputButton } from 'glirastes/react';
 
 The voice button streams audio to your backend, which proxies it to a speech-to-text provider (Deepgram, etc.). The API key never leaves the server.
 
+> Install `wavesurfer.js` (`npm install wavesurfer.js`) to get the live waveform visualization during recording. Without it the button still works — it just falls back to a static recording indicator.
+
 <br/>
 
 ## CLI
@@ -644,6 +661,12 @@ The SDK includes a `glirastes` CLI for scaffolding, code generation, and validat
 
 <br/>
 
+## License
+
+Licensed under the [Apache License, Version 2.0](./LICENSE). You may use, modify, and distribute this SDK freely in commercial and non-commercial projects.
+
+<br/>
+
 ---
 
 <p align="center">

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './types.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+// glirastes — main entry point
+//
+// Re-exports all shared types, interfaces, and helpers that live in `types.ts`
+// so consumers can do `import { ModuleMeta, defineUiTool } from 'glirastes'`.
+// Subpath exports (`glirastes/server`, `glirastes/react`, etc.) remain the
+// primary API surface for runtime functionality.
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,iDAAiD;AACjD,cAAc,YAAY,CAAC"}

package/dist/react/bridges/rest-session-bridge.d.ts

@@ -54,7 +54,7 @@ export interface RestSessionBridgeOptions {
     }) => unknown;
     /**
      * How to delete a session. Default: `{ method: 'DELETE' }`. Override
-     * when your backend uses soft deletes — e.g. chaingrow archives via
+     * when your backend uses soft deletes — e.g. archive via
      * `{ method: 'PATCH', body: { status: 'archived' } }`.
      */
     removeRequest?: (id: string) => {

package/dist/react/components/message-bubble.js

@@ -1,8 +1,21 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import ReactMarkdown from 'react-markdown';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Suspense, lazy } from 'react';
 import { MentionChip as DefaultMentionChip } from './mention-chip.js';
 import { useChatContext } from '../provider/chat-context.js';
 import { parseMentionSegments, stripContextBlocks } from '../utils/mention-markup.js';
+const ReactMarkdown = lazy(async () => {
+    try {
+        const mod = await import('react-markdown');
+        return { default: mod.default };
+    }
+    catch {
+        if (typeof console !== 'undefined') {
+            console.warn('[MessageBubble] react-markdown is not installed — falling back to plain text. Install it with: npm install react-markdown');
+        }
+        const Fallback = (({ children }) => (_jsx(_Fragment, { children: typeof children === 'string' ? children : '' })));
+        return { default: Fallback };
+    }
+});
 function isRecord(value) {
     return typeof value === 'object' && value !== null;
 }
@@ -112,7 +125,7 @@ export function MessageBubble({ message, className }) {
             })] }));
 }
 function DefaultMarkdown({ content, className }) {
-    return (_jsx("div", { className: className, "data-component": "markdown", children: _jsx(ReactMarkdown, { children: content }) }));
+    return (_jsx("div", { className: className, "data-component": "markdown", children: _jsx(Suspense, { fallback: _jsx(_Fragment, { children: content }), children: _jsx(ReactMarkdown, { children: content }) }) }));
 }
 function DefaultToolResult({ toolName, result, className, }) {
     if (isRecord(result) && typeof result.message === 'string' && result.message.trim().length > 0) {

package/dist/react/components/message-bubble.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-bubble.js","sourceRoot":"","sources":["../../../src/react/components/message-bubble.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"message-bubble.js","sourceRoot":"","sources":["../../../src/react/components/message-bubble.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "glirastes",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Official Chainmatics SDK for building AI-powered chat, tools, and agent systems. Part of the Glirastes platform.",
-  "license": "UNLICENSED",
+  "license": "Apache-2.0",
   "author": {
     "name": "Chainmatics",
     "email": "info@chainmatics.net",
@@ -10,7 +10,7 @@
   },
   "homepage": "https://chainmatics.de",
   "bugs": {
-    "url": "https://chainmatics.de",
+    "url": "https://github.com/chainmatics/glirastes/issues",
     "email": "info@chainmatics.net"
   },
   "keywords": [
@@ -22,17 +22,24 @@
     "agent",
     "llm",
     "tools",
+    "tool-calling",
+    "vercel-ai-sdk",
+    "streaming",
+    "rbac",
     "nextjs",
     "nestjs",
     "react"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/chainmatics/glirastes.git"
+    "url": "git+https://github.com/chainmatics/glirastes.git"
   },
   "type": "module",
   "main": "dist/index.js",
@@ -89,7 +96,10 @@
   },
   "files": [
     "dist",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json && cp src/react/styles.css dist/react/styles.css",
@@ -99,14 +109,14 @@
   "dependencies": {
     "zod": "^3.24.1",
     "snowball-stemmers": "^0.6.0",
-    "wavesurfer.js": "^7.12.1",
-    "react-markdown": "^10.1.0",
     "ai": "^6.0.0",
     "@ai-sdk/react": "^3.0.0"
   },
   "peerDependencies": {
     "react": "^18 || ^19",
     "react-dom": "^19",
+    "react-markdown": ">=9 <11",
+    "wavesurfer.js": "^7",
     "@nestjs/common": "^11",
     "@nestjs/core": "^11",
     "@nestjs/config": "^4",
@@ -126,6 +136,12 @@
     "react-dom": {
       "optional": true
     },
+    "react-markdown": {
+      "optional": true
+    },
+    "wavesurfer.js": {
+      "optional": true
+    },
     "@nestjs/common": {
       "optional": true
     },
@@ -163,24 +179,24 @@
   "devDependencies": {
     "typescript": "^5.7.3",
     "vitest": "^4.0.18",
-    "@types/node": "^22.10.5",
+    "@types/node": "^25.6.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@types/express": "^5.0.0",
     "@types/ws": "^8.5.0",
     "@types/snowball-stemmers": "^0.6.0",
-    "ai": "^6.0.105",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@ai-sdk/react": "^3.0.0",
+    "react-markdown": "^10.1.0",
+    "wavesurfer.js": "^7.12.1",
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/config": "^4.0.0",
-    "@nestjs/swagger": "^8.0.0",
+    "@nestjs/swagger": "^11.4.1",
     "next": "^15.0.0",
     "express": "^5.0.0",
     "ws": "^8.0.0",
-    "class-validator": "^0.14.0",
+    "class-validator": "^0.15.1",
     "class-transformer": "^0.5.0",
     "reflect-metadata": "^0.2.0"
   }