glirastes 0.3.0 → 0.3.1

package/dist/server/adapters/nestjs/chat/ai-chat.module.js

@@ -11,7 +11,7 @@ import { DiscoveryModule, DiscoveryService, Reflector } from '@nestjs/core';
 import { AiToolsExplorerService } from '../module/ai-tools-explorer.service.js';
 import { AiToolsService } from '../module/ai-tools.service.js';
 import { createAiToolsProviders } from '../module/ai-tools.module.js';
-import { WebSocketServer } from 'ws';
+import { loadWs } from './ws-loader.js';
 import { AiChatController } from './ai-chat.controller.js';
 import { AiChatService } from './ai-chat.service.js';
 import { AI_CHAT_MODULE_OPTIONS, } from './ai-chat-module-options.interface.js';
@@ -79,7 +79,7 @@ let AiChatModule = class AiChatModule {
             exports: [AiToolsService],
         };
     }
-    static attachWebSockets(app) {
+    static async attachWebSockets(app) {
         if (!AiChatModule_1.initialized) {
             throw new Error('AiChatModule.forRoot() or forRootAsync() must be called before attachWebSockets()');
         }
@@ -93,6 +93,7 @@ let AiChatModule = class AiChatModule {
         if (!deepgramKey) {
             throw new Error('DEEPGRAM_API_KEY environment variable is required when speechToText feature is enabled');
         }
+        const { WebSocketServer } = await loadWs();
         const httpServer = app.getHttpServer();
         const wss = new WebSocketServer({ noServer: true });
         const handleSpeechStream = createSpeechStreamHandler(configService);

package/dist/server/adapters/nestjs/chat/ai-chat.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-chat.module.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/ai-chat.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ai-chat.module.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/ai-chat.module.ts"],"names":[],"mappings":"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"}

package/dist/server/adapters/nestjs/chat/speech-stream.gateway.d.ts

@@ -1,4 +1,4 @@
 import { ConfigService } from '@nestjs/config';
 import type { IncomingMessage } from 'http';
-import WebSocket from 'ws';
+import type WebSocket from 'ws';
 export declare function createSpeechStreamHandler(configService: ConfigService): (clientSocket: WebSocket, req: IncomingMessage) => Promise<void>;

package/dist/server/adapters/nestjs/chat/speech-stream.gateway.js

@@ -1,8 +1,10 @@
 import { Logger } from '@nestjs/common';
-import WebSocket from 'ws';
+import { loadWs } from './ws-loader.js';
 export function createSpeechStreamHandler(configService) {
     const logger = new Logger('SpeechStreamGateway');
     return async (clientSocket, req) => {
+        const { WebSocket: WebSocketCtor } = await loadWs();
+        const WS_OPEN = WebSocketCtor.OPEN;
         const url = new URL(req.url ?? '', `http://${req.headers.host}`);
         const token = url.searchParams.get('token');
         if (!token) {
@@ -26,41 +28,41 @@ export function createSpeechStreamHandler(configService) {
         dgUrl.searchParams.set('interim_results', 'true');
         dgUrl.searchParams.set('encoding', 'linear16');
         dgUrl.searchParams.set('sample_rate', '16000');
-        const dgSocket = new WebSocket(dgUrl.toString(), {
+        const dgSocket = new WebSocketCtor(dgUrl.toString(), {
             headers: { Authorization: `Token ${apiKey}` },
         });
         dgSocket.on('open', () => {
             logger.log(`Deepgram connected (language=${language})`);
         });
         dgSocket.on('message', (data) => {
-            if (clientSocket.readyState === WebSocket.OPEN) {
+            if (clientSocket.readyState === WS_OPEN) {
                 clientSocket.send(data.toString());
             }
         });
         dgSocket.on('error', (err) => {
             logger.error(`Deepgram error: ${err.message}`);
-            if (clientSocket.readyState === WebSocket.OPEN) {
+            if (clientSocket.readyState === WS_OPEN) {
                 clientSocket.send(JSON.stringify({ type: 'error', message: 'Transcription error' }));
             }
         });
         dgSocket.on('close', () => {
-            if (clientSocket.readyState === WebSocket.OPEN) {
+            if (clientSocket.readyState === WS_OPEN) {
                 clientSocket.close();
             }
         });
         clientSocket.on('message', (data) => {
-            if (dgSocket.readyState === WebSocket.OPEN) {
+            if (dgSocket.readyState === WS_OPEN) {
                 dgSocket.send(data);
             }
         });
         clientSocket.on('close', () => {
-            if (dgSocket.readyState === WebSocket.OPEN) {
+            if (dgSocket.readyState === WS_OPEN) {
                 dgSocket.close();
             }
         });
         clientSocket.on('error', (err) => {
             logger.error(`Client socket error: ${err.message}`);
-            if (dgSocket.readyState === WebSocket.OPEN) {
+            if (dgSocket.readyState === WS_OPEN) {
                 dgSocket.close();
             }
         });

package/dist/server/adapters/nestjs/chat/speech-stream.gateway.js.map

@@ -1 +1 @@
-{"version":3,"file":"speech-stream.gateway.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/speech-stream.gateway.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"speech-stream.gateway.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/speech-stream.gateway.ts"],"names":[],"mappings":"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"}

package/dist/server/adapters/nestjs/chat/ws-loader.d.ts

@@ -0,0 +1,5 @@
+export interface WsModule {
+    WebSocketServer: any;
+    WebSocket: any;
+}
+export declare function loadWs(): Promise<WsModule>;

package/dist/server/adapters/nestjs/chat/ws-loader.js

@@ -0,0 +1,37 @@
+// Runtime loader for the optional `ws` peer dependency.
+//
+// `ws` is only needed when the speech-to-text feature is enabled
+// (AiChatModule.attachWebSockets()). A top-level `import { WebSocketServer }
+// from 'ws'` would force every NestJS consumer to install `ws` even when
+// they don't use speech — and crash with `ERR_MODULE_NOT_FOUND` at startup
+// if they don't.
+//
+// We use a plain dynamic `import('ws')` inside a try/catch:
+// - In ESM dist: native dynamic import — Node resolves `ws` only at the
+//   moment `attachWebSockets` is called.
+// - In CJS dist: TypeScript lowers `import('ws')` to a Promise wrapper around
+//   `require('ws')` — same lazy semantics.
+// - Bundlers that bundle the server (esbuild / webpack for serverless deploys)
+//   will still see `ws` as a referenced module. If your deployment bundles,
+//   either install `ws` unconditionally, or mark it as an external in your
+//   bundler config (esbuild `--external:ws`, webpack `externals: { ws: 'commonjs ws' }`).
+//   Standard NestJS deployments don't bundle and are unaffected.
+let cached;
+export async function loadWs() {
+    if (cached)
+        return cached;
+    let mod;
+    try {
+        mod = await import('ws');
+    }
+    catch (err) {
+        throw new Error("[glirastes] The 'ws' package is required for the speech-to-text feature " +
+            '(AiChatModule.attachWebSockets). Install it with: npm install ws', { cause: err });
+    }
+    cached = {
+        WebSocketServer: mod.WebSocketServer ?? mod.default?.WebSocketServer,
+        WebSocket: mod.default ?? mod.WebSocket,
+    };
+    return cached;
+}
+//# sourceMappingURL=ws-loader.js.map

package/dist/server/adapters/nestjs/chat/ws-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-loader.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/ws-loader.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iEAAiE;AACjE,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,iBAAiB;AACjB,EAAE;AACF,4DAA4D;AAC5D,wEAAwE;AACxE,yCAAyC;AACzC,8EAA8E;AAC9E,2CAA2C;AAC3C,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,0FAA0F;AAC1F,iEAAiE;AAOjE,IAAI,MAA4B,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,kEAAkE,EACpE,EAAE,KAAK,EAAE,GAAY,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,MAAM,GAAG;QACP,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,OAAO,EAAE,eAAe;QACpE,SAAS,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS;KACxC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/openapi/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/openapi/index.js",
+  "module": "../dist/openapi/index.js",
+  "types": "../dist/openapi/index.d.ts"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glirastes",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Official Chainmatics SDK for building AI-powered chat, tools, and agent systems. Part of the Glirastes platform.",
   "license": "Apache-2.0",
   "author": {
@@ -53,24 +53,54 @@
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     },
     "./server": {
-      "types": "./dist/server/index.d.ts",
-      "default": "./dist/server/index.js"
+      "import": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/server/index.d.ts",
+        "default": "./dist/cjs/server/index.js"
+      }
     },
     "./server/nextjs": {
-      "types": "./dist/server/adapters/nextjs/index.d.ts",
-      "default": "./dist/server/adapters/nextjs/index.js"
+      "import": {
+        "types": "./dist/server/adapters/nextjs/index.d.ts",
+        "default": "./dist/server/adapters/nextjs/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/server/adapters/nextjs/index.d.ts",
+        "default": "./dist/cjs/server/adapters/nextjs/index.js"
+      }
     },
     "./server/nestjs": {
-      "types": "./dist/server/adapters/nestjs/index.d.ts",
-      "default": "./dist/server/adapters/nestjs/index.js"
+      "import": {
+        "types": "./dist/server/adapters/nestjs/index.d.ts",
+        "default": "./dist/server/adapters/nestjs/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/server/adapters/nestjs/index.d.ts",
+        "default": "./dist/cjs/server/adapters/nestjs/index.js"
+      }
     },
     "./server/testing": {
-      "types": "./dist/server/testing/index.d.ts",
-      "default": "./dist/server/testing/index.js"
+      "import": {
+        "types": "./dist/server/testing/index.d.ts",
+        "default": "./dist/server/testing/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/server/testing/index.d.ts",
+        "default": "./dist/cjs/server/testing/index.js"
+      }
     },
     "./react": {
       "types": "./dist/react/index.d.ts",
@@ -96,6 +126,11 @@
   },
   "files": [
     "dist",
+    "server",
+    "react",
+    "codegen",
+    "openapi",
+    "skills",
     "CHANGELOG.md",
     "CODE_OF_CONDUCT.md",
     "CONTRIBUTING.md",
@@ -105,20 +140,20 @@
     "SECURITY.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && cp src/react/styles.css dist/react/styles.css",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && cp src/react/styles.css dist/react/styles.css && node -e \"require('fs').writeFileSync('dist/cjs/package.json', '{\\\"type\\\":\\\"commonjs\\\"}\\n')\" && node scripts/generate-subpath-shims.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
   },
   "dependencies": {
-    "zod": "^3.24.1",
+    "zod": "^3.25.76",
     "snowball-stemmers": "^0.6.0",
-    "ai": "^6.0.0",
-    "@ai-sdk/react": "^3.0.0",
-    "react-markdown": "^10.1.0"
+    "ai": "^6.0.0"
   },
   "peerDependencies": {
     "react": "^18 || ^19",
     "react-dom": "^19",
+    "@ai-sdk/react": "^3.0.0",
+    "react-markdown": "^10.1.0",
     "wavesurfer.js": "^7",
     "@nestjs/common": "^10 || ^11",
     "@nestjs/core": "^10 || ^11",
@@ -139,6 +174,12 @@
     "react-dom": {
       "optional": true
     },
+    "@ai-sdk/react": {
+      "optional": true
+    },
+    "react-markdown": {
+      "optional": true
+    },
     "wavesurfer.js": {
       "optional": true
     },
@@ -188,6 +229,8 @@
     "@types/snowball-stemmers": "^0.6.0",
     "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",

package/react/langgraph/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/react/transports/langgraph/index.js",
+  "module": "../../dist/react/transports/langgraph/index.js",
+  "types": "../../dist/react/transports/langgraph/index.d.ts"
+}

package/react/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/react/index.js",
+  "module": "../dist/react/index.js",
+  "types": "../dist/react/index.d.ts"
+}

package/react/vercel/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/react/transports/vercel/index.js",
+  "module": "../../dist/react/transports/vercel/index.js",
+  "types": "../../dist/react/transports/vercel/index.d.ts"
+}

package/server/nestjs/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/server/adapters/nestjs/index.js",
+  "module": "../../dist/server/adapters/nestjs/index.js",
+  "types": "../../dist/server/adapters/nestjs/index.d.ts"
+}

package/server/nextjs/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/server/adapters/nextjs/index.js",
+  "module": "../../dist/server/adapters/nextjs/index.js",
+  "types": "../../dist/server/adapters/nextjs/index.d.ts"
+}

package/server/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/server/index.js",
+  "module": "../dist/server/index.js",
+  "types": "../dist/server/index.d.ts"
+}

package/server/testing/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../../dist/cjs/server/testing/index.js",
+  "module": "../../dist/server/testing/index.js",
+  "types": "../../dist/server/testing/index.d.ts"
+}

package/skills/README.md

@@ -0,0 +1,107 @@
+# Glirastes Agent Skills
+
+Pre-built [agent skills](https://docs.claude.com/en/docs/claude-code/skills) that teach a coding agent (Claude Code, Codex, Cursor, …) how to integrate, maintain, and customize the Glirastes SDK in a real codebase. Drop them into your repo's `.claude/skills/` (or your agent's equivalent), and the agent picks the right one automatically based on the task.
+
+Skills are a separate concept from `glirastes generate-skills`:
+
+- **`generate-skills` (CLI command)** — turns *your tools* into skill files so external agents can call your tools.
+- **These skills (this directory)** — instruct an agent on how to *integrate Glirastes itself* into a project.
+
+## Available skills
+
+| Skill | Use when |
+|---|---|
+| [`integrating-glirastes-nextjs`](./integrating-glirastes-nextjs/SKILL.md) | Adding chat to a Next.js App Router app where Next.js is the only backend. |
+| [`integrating-glirastes-nestjs`](./integrating-glirastes-nestjs/SKILL.md) | Adding chat to a NestJS backend (with or without a separate frontend). |
+| [`integrating-glirastes-nextjs-with-nestjs-backend`](./integrating-glirastes-nextjs-with-nestjs-backend/SKILL.md) | Full-stack setup: Next.js frontend in one workspace, separate NestJS backend in another. |
+| [`maintaining-glirastes-tools`](./maintaining-glirastes-tools/SKILL.md) | Authoring `ai-tool.ts` / `ai-ui-tool.ts`, intent modules, codegen pipeline, all CLI commands. |
+| [`building-glirastes-chat-ui`](./building-glirastes-chat-ui/SKILL.md) | Customizing the chat UI — theming, mentions, voice input, approval cards, action bus. |
+
+The three `integrating-*` skills are mutually exclusive: pick the one that matches your stack. The other two are stack-agnostic.
+
+## Installing into your project
+
+These skills ship with the npm package, so they're always in sync with the SDK version you've installed. Use the bundled CLI installer:
+
+```bash
+# Project-local: all skills into ./.claude/skills (default)
+npx glirastes install-skills
+
+# Global: into ~/.claude/skills — picked up by every Claude Code session on this machine
+npx glirastes install-skills --global         # short: -g
+
+# Stack-filtered — only the skills relevant to your setup
+npx glirastes install-skills --stack nextjs               # Next.js standalone
+npx glirastes install-skills --stack nestjs               # NestJS standalone
+npx glirastes install-skills --stack nextjs+nestjs        # Next.js + NestJS monorepo
+npx glirastes install-skills --stack all                  # explicit "all" (default)
+
+# Combine: global + stack filter
+npx glirastes install-skills -g --stack nextjs+nestjs
+
+# Different agent? Pass --target (mutually exclusive with --global)
+npx glirastes install-skills --target .codex/skills
+
+# Symlink mode — skills auto-update when you bump glirastes
+npx glirastes install-skills --symlink
+
+# Preview without writing
+npx glirastes install-skills --dry-run
+
+# Overwrite previously installed skills
+npx glirastes install-skills --force
+```
+
+| Flag | Effect |
+|---|---|
+| *(default)* | Install into `./.claude/skills` relative to the current project. |
+| `-g`, `--global` | Install into `~/.claude/skills` so every project on this machine sees the skills. Mutually exclusive with `--target`. |
+| `--target <dir>` | Override the destination. Accepts relative or absolute paths and `~/`-prefixed paths. |
+| `--stack <name>` | `nextjs` \| `nestjs` \| `nextjs+nestjs` \| `all` (default). Filters which skills are installed. |
+| `--symlink` | Symlink instead of copy — skills track the installed `glirastes` version automatically on `npm install`. |
+| `--force` | Overwrite skills that already exist at the target. |
+| `--dry-run` | Print what would happen without writing anything. |
+
+### Project-local vs global — which to pick?
+
+- **Project-local** (default): each project sees skills tied to its own installed `glirastes` version. Best when teams collaborate via git — the project's `.claude/skills` is checked in (or symlinked, then `.gitignore`d).
+- **Global** (`-g`): one install per developer machine, shared across every project. Best for a solo dev who works on multiple Glirastes projects and wants consistency without re-running the installer per project.
+
+Both modes can coexist. Project-local skills override global skills when the same name is present in both.
+
+### Manual install (no CLI)
+
+If you prefer not to use the installer:
+
+```bash
+mkdir -p .claude/skills
+cp -r node_modules/glirastes/skills/*/ .claude/skills/
+```
+
+Or symlink:
+
+```bash
+mkdir -p .claude/skills
+for skill in node_modules/glirastes/skills/*/; do
+  ln -sf "$(pwd)/$skill" ".claude/skills/$(basename "$skill")"
+done
+```
+
+## Skill authoring
+
+If you fork or extend a skill, follow the [Anthropic skill creator best practices](https://github.com/anthropics/anthropic-cookbook/tree/main/agents/agent-skills):
+
+- Use the verb-ing-noun naming pattern (`integrating-glirastes-nextjs`, not `glirastes-nextjs-helper`)
+- Keep `SKILL.md` under ~500 lines — split deep references into sibling files, one level deep
+- Frontmatter `description` must be third-person and include the trigger condition
+- Include code snippets you can adapt, not just abstract guidance
+
+## Reporting issues / suggesting improvements
+
+These skills evolve with the SDK. If a skill steers an agent toward an outdated API, [open an issue](https://github.com/chainmatics/glirastes/issues) with:
+
+1. The skill name
+2. The agent's incorrect output
+3. The correct API for the current SDK version
+
+Pull requests welcome.