@mingxy/ocosay 1.0.0

package/tests/tts-tools.test.ts

@@ -0,0 +1,270 @@
+import { handleToolCall, ttsTools } from '../src/tools/tts'
+import * as speaker from '../src/core/speaker'
+import * as index from '../src/index'
+import { TTSError, TTSErrorCode } from '../src/core/types'
+
+jest.mock('../src/core/speaker')
+jest.mock('../src/index')
+
+const mockSpeaker = {
+  speak: jest.fn(),
+  stop: jest.fn(),
+  pause: jest.fn(),
+  resume: jest.fn(),
+  listVoices: jest.fn(),
+  getProviders: jest.fn().mockReturnValue(['minimax']),
+  isPlaying: jest.fn().mockReturnValue(true),
+  isPausedState: jest.fn().mockReturnValue(false),
+  destroy: jest.fn()
+}
+
+beforeEach(() => {
+  jest.clearAllMocks()
+  ;(speaker.getDefaultSpeaker as jest.Mock).mockReturnValue(mockSpeaker)
+  ;(speaker.speak as jest.Mock).mockResolvedValue(undefined)
+  ;(speaker.stop as jest.Mock).mockResolvedValue(undefined)
+  ;(speaker.pause as jest.Mock).mockImplementation(() => {})
+  ;(speaker.resume as jest.Mock).mockImplementation(() => {})
+  ;(speaker.listVoices as jest.Mock).mockResolvedValue([
+    { id: 'voice1', name: 'Voice 1', language: 'zh-CN' }
+  ])
+})
+
+describe('ttsTools', () => {
+  describe('tool definitions', () => {
+    it('should have 10 tools defined', () => {
+      expect(ttsTools).toHaveLength(10)
+    })
+
+    it('should include tts_speak tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_speak')
+      expect(tool).toBeDefined()
+      expect(tool!.input!.required).toContain('text')
+    })
+
+    it('should include tts_stop tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_stop')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_pause tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_pause')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_resume tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_resume')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_list_voices tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_list_voices')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_list_providers tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_list_providers')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_status tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_status')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_stream_speak tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_stream_speak')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_stream_stop tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_stream_stop')
+      expect(tool).toBeDefined()
+    })
+
+    it('should include tts_stream_status tool', () => {
+      const tool = ttsTools.find(t => t.name === 'tts_stream_status')
+      expect(tool).toBeDefined()
+    })
+  })
+
+  describe('handleToolCall', () => {
+    describe('tts_speak', () => {
+      it('should call speak with correct arguments', async () => {
+        const result = await handleToolCall('tts_speak', {
+          text: 'Hello world',
+          provider: 'minimax',
+          voice: 'voice1',
+          model: 'stream',
+          speed: 1.0,
+          volume: 80,
+          pitch: 1.0
+        })
+        expect(speaker.speak).toHaveBeenCalledWith('Hello world', expect.objectContaining({
+          provider: 'minimax',
+          voice: 'voice1',
+          model: 'stream',
+          speed: 1.0,
+          volume: 80,
+          pitch: 1.0
+        }))
+        expect(result).toEqual({ success: true, message: 'Speech completed' })
+      })
+
+      it('should return error on TTSError', async () => {
+        ;(speaker.speak as jest.Mock).mockRejectedValue(
+          new TTSError('Test error', TTSErrorCode.AUTH, 'minimax')
+        )
+        const result = await handleToolCall('tts_speak', { text: 'Hello' })
+        expect(result.success).toBe(false)
+        expect(result.error).toBe('Test error')
+        expect(result.code).toBe(TTSErrorCode.AUTH)
+      })
+
+      it('should return error on generic error', async () => {
+        ;(speaker.speak as jest.Mock).mockRejectedValue(new Error('Generic error'))
+        const result = await handleToolCall('tts_speak', { text: 'Hello' })
+        expect(result.success).toBe(false)
+        expect(result.error).toContain('Generic error')
+      })
+    })
+
+    describe('tts_stop', () => {
+      it('should call stop and return success', async () => {
+        const result = await handleToolCall('tts_stop')
+        expect(speaker.stop).toHaveBeenCalled()
+        expect(result).toEqual({ success: true, message: 'Stopped' })
+      })
+    })
+
+    describe('tts_pause', () => {
+      it('should call pause and return success', async () => {
+        const result = await handleToolCall('tts_pause')
+        expect(speaker.pause).toHaveBeenCalled()
+        expect(result).toEqual({ success: true, message: 'Paused' })
+      })
+    })
+
+    describe('tts_resume', () => {
+      it('should call resume and return success', async () => {
+        const result = await handleToolCall('tts_resume')
+        expect(speaker.resume).toHaveBeenCalled()
+        expect(result).toEqual({ success: true, message: 'Resumed' })
+      })
+    })
+
+    describe('tts_list_voices', () => {
+      it('should return voices list', async () => {
+        const result = await handleToolCall('tts_list_voices', { provider: 'minimax' })
+        expect(result.success).toBe(true)
+        expect(result.voices).toEqual([
+          { id: 'voice1', name: 'Voice 1', language: 'zh-CN' }
+        ])
+      })
+    })
+
+    describe('tts_list_providers', () => {
+      it('should return providers list', async () => {
+        const result = await handleToolCall('tts_list_providers')
+        expect(result.success).toBe(true)
+        expect(result.providers).toEqual(['minimax'])
+      })
+    })
+
+    describe('tts_status', () => {
+      it('should return playing status', async () => {
+        const result = await handleToolCall('tts_status')
+        expect(result.success).toBe(true)
+        expect(result.isPlaying).toBe(true)
+        expect(result.isPaused).toBe(false)
+      })
+
+      it('should return paused status', async () => {
+        mockSpeaker.isPausedState.mockReturnValue(true)
+        const result = await handleToolCall('tts_status')
+        expect(result.success).toBe(true)
+        expect(result.isPlaying).toBe(true)
+        expect(result.isPaused).toBe(true)
+      })
+    })
+
+    describe('tts_stream_speak', () => {
+      it('should throw when autoRead not enabled', async () => {
+        ;(index.isAutoReadEnabled as jest.Mock).mockReturnValue(false)
+        const result = await handleToolCall('tts_stream_speak', { text: 'Hello' })
+        expect(result.success).toBe(false)
+        expect(result.error).toContain('autoRead must be enabled')
+      })
+
+      it('should throw when stream not initialized', async () => {
+        ;(index.isAutoReadEnabled as jest.Mock).mockReturnValue(true)
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(false)
+        const result = await handleToolCall('tts_stream_speak', { text: 'Hello' })
+        expect(result.success).toBe(false)
+        expect(result.error).toContain('Stream components not initialized')
+      })
+
+      it('should start stream speak when enabled', async () => {
+        ;(index.isAutoReadEnabled as jest.Mock).mockReturnValue(true)
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(true)
+        ;(index.getStreamReader as jest.Mock).mockReturnValue({ start: jest.fn() })
+        ;(index.getStreamingSynthesizer as jest.Mock).mockReturnValue({ synthesize: jest.fn() })
+        
+        const result = await handleToolCall('tts_stream_speak', { text: 'Hello' })
+        expect(result.success).toBe(true)
+        expect(result.message).toBe('Stream speak started')
+      })
+    })
+
+    describe('tts_stream_stop', () => {
+      it('should throw when stream not enabled', async () => {
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(false)
+        const result = await handleToolCall('tts_stream_stop')
+        expect(result.success).toBe(false)
+        expect(result.error).toContain('Stream mode is not enabled')
+      })
+
+      it('should stop stream player', async () => {
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(true)
+        ;(index.getStreamPlayer as jest.Mock).mockReturnValue({ stop: jest.fn() })
+        
+        const result = await handleToolCall('tts_stream_stop')
+        expect(result.success).toBe(true)
+        expect(result.message).toBe('Stream stopped')
+      })
+    })
+
+    describe('tts_stream_status', () => {
+      it('should return not_initialized when stream not enabled', async () => {
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(false)
+        const result = await handleToolCall('tts_stream_status')
+        expect(result.success).toBe(true)
+        expect(result.isActive).toBe(false)
+        expect(result.state).toBe('not_initialized')
+      })
+
+      it('should return stream status when enabled', async () => {
+        ;(index.isStreamEnabled as jest.Mock).mockReturnValue(true)
+        ;(index.getStreamStatus as jest.Mock).mockReturnValue({
+          isActive: true,
+          bytesWritten: 1024,
+          state: 'buffering'
+        })
+        
+        const result = await handleToolCall('tts_stream_status')
+        expect(result.success).toBe(true)
+        expect(result.isActive).toBe(true)
+        expect(result.bytesWritten).toBe(1024)
+        expect(result.state).toBe('buffering')
+      })
+    })
+
+    describe('unknown tool', () => {
+      it('should throw error for unknown tool', async () => {
+        const result = await handleToolCall('unknown_tool')
+        expect(result.success).toBe(false)
+        expect(result.error).toContain('Unknown tool')
+      })
+    })
+  })
+})

package/tests/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/tests/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["types.test.ts"],"names":[],"mappings":""}

package/tests/types.test.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("../src/core/types");
+describe('TTS Types', () => {
+    describe('TTSError', () => {
+        it('should create error with correct properties', () => {
+            const error = new types_1.TTSError('Test error', types_1.TTSErrorCode.AUTH, 'test-provider');
+            expect(error.message).toBe('Test error');
+            expect(error.code).toBe(types_1.TTSErrorCode.AUTH);
+            expect(error.provider).toBe('test-provider');
+            expect(error.name).toBe('TTSError');
+        });
+        it('should include details when provided', () => {
+            const details = { extra: 'info' };
+            const error = new types_1.TTSError('Error', types_1.TTSErrorCode.NETWORK, 'test', details);
+            expect(error.details).toEqual(details);
+        });
+    });
+    describe('Voice', () => {
+        it('should have correct structure', () => {
+            const voice = {
+                id: 'test-voice',
+                name: 'Test Voice',
+                language: 'zh-CN',
+                gender: 'male'
+            };
+            expect(voice.id).toBe('test-voice');
+            expect(voice.name).toBe('Test Voice');
+            expect(voice.language).toBe('zh-CN');
+            expect(voice.gender).toBe('male');
+        });
+    });
+    describe('SpeakOptions', () => {
+        it('should accept all optional parameters', () => {
+            const options = {
+                voice: 'voice-1',
+                model: 'sync',
+                speed: 1.0,
+                volume: 80,
+                pitch: 1.2
+            };
+            expect(options.voice).toBe('voice-1');
+            expect(options.model).toBe('sync');
+            expect(options.speed).toBe(1.0);
+        });
+    });
+    describe('AudioResult', () => {
+        it('should have correct structure for buffer', () => {
+            const result = {
+                audioData: Buffer.from([1, 2, 3]),
+                format: 'mp3',
+                isStream: false,
+                duration: 5.5
+            };
+            expect(Buffer.isBuffer(result.audioData)).toBe(true);
+            expect(result.format).toBe('mp3');
+            expect(result.isStream).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/tests/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["types.test.ts"],"names":[],"mappings":"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"}

package/tests/types.test.ts

@@ -0,0 +1,63 @@
+import { TTSError, TTSErrorCode, Voice, TTSCapabilities, SpeakOptions, AudioResult } from '../src/core/types'
+
+describe('TTS Types', () => {
+  describe('TTSError', () => {
+    it('should create error with correct properties', () => {
+      const error = new TTSError('Test error', TTSErrorCode.AUTH, 'test-provider')
+      expect(error.message).toBe('Test error')
+      expect(error.code).toBe(TTSErrorCode.AUTH)
+      expect(error.provider).toBe('test-provider')
+      expect(error.name).toBe('TTSError')
+    })
+    
+    it('should include details when provided', () => {
+      const details = { extra: 'info' }
+      const error = new TTSError('Error', TTSErrorCode.NETWORK, 'test', details)
+      expect(error.details).toEqual(details)
+    })
+  })
+  
+  describe('Voice', () => {
+    it('should have correct structure', () => {
+      const voice: Voice = {
+        id: 'test-voice',
+        name: 'Test Voice',
+        language: 'zh-CN',
+        gender: 'male'
+      }
+      expect(voice.id).toBe('test-voice')
+      expect(voice.name).toBe('Test Voice')
+      expect(voice.language).toBe('zh-CN')
+      expect(voice.gender).toBe('male')
+    })
+  })
+  
+  describe('SpeakOptions', () => {
+    it('should accept all optional parameters', () => {
+      const options: SpeakOptions = {
+        voice: 'voice-1',
+        model: 'sync',
+        speed: 1.0,
+        volume: 80,
+        pitch: 1.2
+      }
+      expect(options.voice).toBe('voice-1')
+      expect(options.model).toBe('sync')
+      expect(options.speed).toBe(1.0)
+    })
+  })
+  
+  describe('AudioResult', () => {
+    it('should have correct structure for buffer', () => {
+      const result: AudioResult = {
+        audioData: Buffer.from([1, 2, 3]),
+        format: 'mp3',
+        isStream: false,
+        duration: 5.5
+      }
+      expect(Buffer.isBuffer(result.audioData)).toBe(true)
+      expect(result.format).toBe('mp3')
+      expect(result.isStream).toBe(false)
+    })
+  })
+})

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": ["node", "jest"],
+    "typeRoots": ["./src/types", "./node_modules/@types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}