@hasna/recordings 0.0.3 → 0.1.2

package/dist/lib/config.d.ts

@@ -0,0 +1,6 @@
+import type { RecordingsConfig } from "../types/index.js";
+export declare const DEFAULT_CONFIG: RecordingsConfig;
+export declare function loadConfig(configPath?: string): RecordingsConfig;
+export declare function getDataDir(): string;
+export declare function ensureDataDir(config: RecordingsConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,eAAO,MAAM,cAAc,EAAE,gBA0B5B,CAAC;AAEF,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAmEhE;AAgBD,wBAAgB,UAAU,IAAI,MAAM,CAanC;AA0BD,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAU5D"}

package/dist/lib/enhancer.d.ts

@@ -0,0 +1,25 @@
+import type { RecordingsConfig, EnhancementResult } from "../types/index.js";
+export declare function resetEnhancementClient(): void;
+/**
+ * Detect if the transcribed text needs AI enhancement.
+ *
+ * Detection logic:
+ * 1. Explicit triggers: "say it better", "rewrite this", etc.
+ * 2. Instruction patterns: "write an email saying...", "give instructions to..."
+ * 3. Meta-commentary: text that talks ABOUT what to say rather than being the content itself
+ */
+export declare function needsEnhancement(text: string, config: RecordingsConfig): {
+    needs: boolean;
+    reason: string;
+    instruction: string;
+};
+export declare function enhanceText(rawText: string, instruction: string, config: RecordingsConfig): Promise<EnhancementResult>;
+/**
+ * Full pipeline: detect if enhancement is needed, enhance if so.
+ */
+export declare function processText(rawText: string, config: RecordingsConfig): Promise<{
+    text: string;
+    mode: "raw" | "enhanced";
+    enhancement_model: string | null;
+}>;
+//# sourceMappingURL=enhancer.d.ts.map

package/dist/lib/enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancer.d.ts","sourceRoot":"","sources":["../../src/lib/enhancer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAiB3B,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,GACvB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAmCzD;AAoBD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAyC5B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,UAAU,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC,CAkBD"}

package/dist/lib/recorder.d.ts

@@ -0,0 +1,30 @@
+import type { RecordingsConfig } from "../types/index.js";
+/**
+ * Check if sox/rec is available for recording
+ */
+export declare function checkRecordingDeps(): Promise<{
+    available: boolean;
+    tool: string;
+    message: string;
+}>;
+/**
+ * Start recording audio from microphone
+ */
+export declare function startRecording(config: RecordingsConfig): string;
+/**
+ * Stop the current recording
+ */
+export declare function stopRecording(): string | null;
+/**
+ * Check if currently recording
+ */
+export declare function isRecording(): boolean;
+/**
+ * Get current recording file path
+ */
+export declare function getCurrentFile(): string | null;
+/**
+ * Record for a specific duration (non-interactive)
+ */
+export declare function recordDuration(seconds: number, config: RecordingsConfig): Promise<string>;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/lib/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/lib/recorder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM1D;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAqDD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA6B/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAa7C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAwBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/lib/transcriber.d.ts

@@ -0,0 +1,5 @@
+import type { RecordingsConfig, TranscriptionResult } from "../types/index.js";
+export declare function resetClient(): void;
+export declare function transcribeAudio(audioPath: string, config: RecordingsConfig): Promise<TranscriptionResult>;
+export declare function transcribeBuffer(buffer: Buffer, filename: string, config: RecordingsConfig): Promise<TranscriptionResult>;
+//# sourceMappingURL=transcriber.d.ts.map

package/dist/lib/transcriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.d.ts","sourceRoot":"","sources":["../../src/lib/transcriber.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAgB/E,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,mBAAmB,CAAC,CA4B9B"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -1,13 +1,17 @@
 #!/usr/bin/env bun
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __require = import.meta.require;
@@ -4878,5 +4882,31 @@ server.tool("list_projects", "List registered projects.", {}, async () => {
     return errorResult(e);
   }
 });
+var _agentReg = new Map;
+server.tool("register_agent", "Register this agent session. Returns agent_id for use in heartbeat/set_focus.", { name: exports_external.string(), session_id: exports_external.string().optional() }, async (a) => {
+  const existing = [..._agentReg.values()].find((x) => x.name === a.name);
+  if (existing) {
+    existing.last_seen_at = new Date().toISOString();
+    return { content: [{ type: "text", text: JSON.stringify(existing) }] };
+  }
+  const id = Math.random().toString(36).slice(2, 10);
+  const ag = { id, name: a.name, last_seen_at: new Date().toISOString() };
+  _agentReg.set(id, ag);
+  return { content: [{ type: "text", text: JSON.stringify(ag) }] };
+});
+server.tool("heartbeat", "Update last_seen_at to signal agent is active.", { agent_id: exports_external.string() }, async (a) => {
+  const ag = _agentReg.get(a.agent_id);
+  if (!ag)
+    return { content: [{ type: "text", text: `Agent not found: ${a.agent_id}` }], isError: true };
+  ag.last_seen_at = new Date().toISOString();
+  return { content: [{ type: "text", text: `\u2665 ${ag.name} \u2014 active` }] };
+});
+server.tool("set_focus", "Set active project context for this agent session.", { agent_id: exports_external.string(), project_id: exports_external.string().optional() }, async (a) => {
+  const ag = _agentReg.get(a.agent_id);
+  if (!ag)
+    return { content: [{ type: "text", text: `Agent not found: ${a.agent_id}` }], isError: true };
+  ag.project_id = a.project_id;
+  return { content: [{ type: "text", text: a.project_id ? `Focus: ${a.project_id}` : "Focus cleared" }] };
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/dist/types/index.d.ts

@@ -0,0 +1,103 @@
+export interface Recording {
+    id: string;
+    audio_path: string | null;
+    raw_text: string;
+    processed_text: string | null;
+    processing_mode: ProcessingMode;
+    model_used: string;
+    enhancement_model: string | null;
+    duration_ms: number;
+    language: string | null;
+    tags: string[];
+    agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export type ProcessingMode = "raw" | "enhanced";
+export interface CreateRecordingInput {
+    audio_path?: string;
+    raw_text: string;
+    processed_text?: string;
+    processing_mode?: ProcessingMode;
+    model_used?: string;
+    enhancement_model?: string;
+    duration_ms?: number;
+    language?: string;
+    tags?: string[];
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RecordingFilter {
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    processing_mode?: ProcessingMode;
+    tags?: string[];
+    search?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface Agent {
+    id: string;
+    name: string;
+    description: string | null;
+    role: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    last_seen_at: string;
+}
+export interface Project {
+    id: string;
+    name: string;
+    path: string;
+    description: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface RecordingsConfig {
+    openai_api_key: string;
+    enhancement_api_key: string;
+    transcription_model: string;
+    enhancement_model: string;
+    language: string;
+    audio_format: "wav" | "mp3" | "m4a" | "webm";
+    sample_rate: number;
+    record_command: string;
+    hotkey: string;
+    auto_enhance: boolean;
+    enhance_triggers: string[];
+    db_path: string;
+    audio_dir: string;
+    max_recording_seconds: number;
+}
+export interface TranscriptionResult {
+    text: string;
+    duration_ms: number;
+    model: string;
+    language: string | null;
+}
+export interface EnhancementResult {
+    original: string;
+    enhanced: string;
+    model: string;
+    reasoning: string | null;
+}
+export declare class RecordingNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare class RecordingError extends Error {
+    constructor(message: string);
+}
+export declare class TranscriptionError extends Error {
+    constructor(message: string);
+}
+export declare class EnhancementError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,cAAc,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,UAAU,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAID,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.0.3",
+  "version": "0.1.2",
   "type": "module",
   "description": "Speech-to-text recording tool with MCP and CLI — records, transcribes, and optionally enhances text using AI",
   "main": "dist/index.js",

package/src/cli/index.ts

@@ -34,7 +34,7 @@ program
   .description(
     "Speech-to-text recording tool — record, transcribe, and enhance with AI"
   )
-  .version("0.0.1")
+  .version("0.0.3")
   .option("--json", "Output as JSON")
   .option("--agent <name>", "Agent name or ID")
   .option("--project <name>", "Project name or ID")

package/src/mcp/index.ts

@@ -401,5 +401,46 @@ server.tool(
 
 // ── Start Server ────────────────────────────────────────────────────────────
 
+
+const _agentReg = new Map<string, { id: string; name: string; last_seen_at: string }>();
+
+server.tool(
+  "register_agent",
+  "Register this agent session. Returns agent_id for use in heartbeat/set_focus.",
+  { name: z.string(), session_id: z.string().optional() },
+  async (a: { name: string; session_id?: string }) => {
+    const existing = [..._agentReg.values()].find(x => x.name === a.name);
+    if (existing) { existing.last_seen_at = new Date().toISOString(); return { content: [{ type: "text" as const, text: JSON.stringify(existing) }] }; }
+    const id = Math.random().toString(36).slice(2, 10);
+    const ag = { id, name: a.name, last_seen_at: new Date().toISOString() };
+    _agentReg.set(id, ag);
+    return { content: [{ type: "text" as const, text: JSON.stringify(ag) }] };
+  }
+);
+
+server.tool(
+  "heartbeat",
+  "Update last_seen_at to signal agent is active.",
+  { agent_id: z.string() },
+  async (a: { agent_id: string }) => {
+    const ag = _agentReg.get(a.agent_id);
+    if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
+    ag.last_seen_at = new Date().toISOString();
+    return { content: [{ type: "text" as const, text: `♥ ${ag.name} — active` }] };
+  }
+);
+
+server.tool(
+  "set_focus",
+  "Set active project context for this agent session.",
+  { agent_id: z.string(), project_id: z.string().optional() },
+  async (a: { agent_id: string; project_id?: string }) => {
+    const ag = _agentReg.get(a.agent_id);
+    if (!ag) return { content: [{ type: "text" as const, text: `Agent not found: ${a.agent_id}` }], isError: true };
+    (ag as any).project_id = a.project_id;
+    return { content: [{ type: "text" as const, text: a.project_id ? `Focus: ${a.project_id}` : "Focus cleared" }] };
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"26ed30ef-ff55-4957-91cc-40a82f829ca0","pid":85889,"acquiredAt":1773261929948}