@grunnverk/audio-tools 1.0.0

package/dist/src/recording.d.ts

@@ -0,0 +1,35 @@
+import { RecordingOptions, RecordingResult } from './types';
+/**
+ * Record audio using @theunwalked/unplayable
+ */
+export declare function recordAudio(options?: RecordingOptions): Promise<RecordingResult>;
+/**
+ * Get timestamped filename for archived audio
+ */
+export declare function getTimestampedArchivedAudioFilename(originalExtension?: string): string;
+/**
+ * Get timestamped filename for archived transcript
+ */
+export declare function getTimestampedArchivedTranscriptFilename(): string;
+/**
+ * Archive audio file with transcription to specified directory
+ * This saves BOTH the audio file AND transcription text together
+ * @param originalAudioPath Path to the original audio file
+ * @param transcriptionText The transcribed text content
+ * @param outputDirectory Directory to save archived files (default: 'output')
+ * @returns Paths to both archived audio and transcript files
+ */
+export declare function archiveAudio(originalAudioPath: string, transcriptionText: string, outputDirectory?: string): Promise<{
+    audioPath: string;
+    transcriptPath: string;
+}>;
+/**
+ * Delete audio file
+ */
+export declare function deleteAudio(audioPath: string): Promise<void>;
+/**
+ * Get audio file duration (requires external library or audio analysis)
+ * For now, returns null - can be enhanced later
+ */
+export declare function getAudioDuration(_audioPath: string): Promise<number | null>;
+//# sourceMappingURL=recording.d.ts.map

package/dist/src/recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../../src/recording.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjE;;GAEG;AACH,wBAAsB,WAAW,CAC7B,OAAO,GAAE,gBAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC,CA6C1B;AAoBD;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,iBAAiB,GAAE,MAAe,GAAG,MAAM,CAE9F;AAED;;GAEG;AACH,wBAAgB,wCAAwC,IAAI,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAC9B,iBAAiB,EAAE,MAAM,EACzB,iBAAiB,EAAE,MAAM,EACzB,eAAe,GAAE,MAAiB,GACnC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CxD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIjF"}

package/dist/src/transcription.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Audio transcription utilities
+ * Wraps @grunnverk/ai-service for convenience
+ */
+/**
+ * Transcribe audio file using AI service
+ * This is a convenience wrapper around @grunnverk/ai-service
+ */
+export declare function transcribeAudio(audioPath: string): Promise<string>;
+//# sourceMappingURL=transcription.d.ts.map

package/dist/src/transcription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcription.d.ts","sourceRoot":"","sources":["../../src/transcription.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAaxE"}

package/dist/src/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Types for audio recording
+ */
+export interface AudioDevice {
+    id: string;
+    name: string;
+    isDefault: boolean;
+}
+export interface RecordingOptions {
+    /** Audio device to use (optional, uses default if not specified) */
+    device?: AudioDevice | string;
+    /** Maximum recording duration in seconds (optional) */
+    duration?: number;
+    /** Output file path (optional, generates temp file if not specified) */
+    outputPath?: string;
+    /** Countdown delay before recording starts (optional, default: 3) */
+    countdownDelay?: number;
+    /** Sample rate in Hz (optional, default: 44100) */
+    sampleRate?: number;
+    /** Audio format (optional, default: 'wav') */
+    format?: 'wav' | 'mp3' | 'flac';
+}
+export interface RecordingResult {
+    /** Path to recorded audio file */
+    filePath: string;
+    /** Recording duration in seconds */
+    duration: number;
+    /** File size in bytes */
+    fileSize: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IAE9B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/guide/index.md

@@ -0,0 +1,57 @@
+# @grunnverk/audio-tools - Agentic Guide
+
+## Purpose
+
+Audio recording tools for voice-driven development workflows. Enables voice note capture, device management, and transcription.
+
+## Key Features
+
+- **Audio Recording** - Record voice notes from command line
+- **Device Management** - List and select audio input devices
+- **Countdown Timer** - Visual countdown before recording starts
+- **Transcription** - Convert audio to text via AI service
+- **Cross-platform** - Works on macOS, Linux, and Windows
+
+## Usage
+
+```typescript
+import { recordAudio, listDevices, transcribe } from '@grunnverk/audio-tools';
+
+// List available devices
+const devices = await listDevices();
+
+// Record audio
+const audioFile = await recordAudio({
+  duration: 60,
+  countdown: 3,
+  device: devices[0]
+});
+
+// Transcribe
+const text = await transcribe(audioFile);
+```
+
+## Dependencies
+
+- @grunnverk/ai-service - Transcription via OpenAI
+- @theunwalked/unplayable - Audio recording engine
+
+## Package Structure
+
+```
+src/
+├── recording.ts      # Audio recording
+├── devices.ts        # Device management
+├── countdown.ts      # Countdown timer
+├── transcription.ts  # Audio transcription
+├── types.ts          # Type definitions
+└── index.ts
+```
+
+## Key Exports
+
+- `recordAudio()` - Record audio from microphone
+- `listDevices()` - List available audio devices
+- `transcribe()` - Transcribe audio to text
+- `countdown()` - Display countdown timer
+

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@grunnverk/audio-tools",
+  "version": "1.0.0",
+  "description": "Audio recording tools for voice-driven development workflows",
+  "main": "dist/index.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "guide"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grunnverk/audio-tools.git"
+  },
+  "scripts": {
+    "build": "npm run lint && tsc --noEmit && vite build",
+    "dev": "vite",
+    "watch": "vite build --watch",
+    "test": "vitest run --coverage",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "precommit": "npm run clean && npm run build && npm run lint && npm run test",
+    "prepublishOnly": "npm run clean && npm run lint && npm run build && npm run test"
+  },
+  "keywords": [
+    "audio",
+    "recording",
+    "voice",
+    "transcription",
+    "development",
+    "workflow"
+  ],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@grunnverk/ai-service": "^1.0.1",
+    "@theunwalked/unplayable": "^0.0.28"
+  },
+  "peerDependencies": {
+    "@grunnverk/shared": "^0.1.11",
+    "winston": "^3.17.0"
+  },
+  "peerDependenciesMeta": {
+    "@grunnverk/shared": {
+      "optional": true
+    },
+    "winston": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@grunnverk/shared": "^0.1.11",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.33.0",
+    "@swc/core": "^1.13.3",
+    "@types/node": "^24.10.1",
+    "@types/winston": "^2.4.4",
+    "@typescript-eslint/eslint-plugin": "^8.39.1",
+    "@typescript-eslint/parser": "^8.47.0",
+    "@vitest/coverage-v8": "^4.0.13",
+    "esbuild": "0.27.2",
+    "eslint": "^9.33.0",
+    "eslint-plugin-import": "^2.32.0",
+    "globals": "^16.3.0",
+    "mockdate": "^3.0.5",
+    "typescript": "^5.9.2",
+    "vite": "^7.2.4",
+    "vite-plugin-dts": "^4.3.0",
+    "vite-plugin-node": "^7.0.0",
+    "vitest": "^4.0.13",
+    "winston": "^3.17.0"
+  }
+}