@hasna/recordings 0.1.36 → 0.2.0

package/dist/store.d.ts

@@ -0,0 +1,40 @@
+import type { Recording, CreateRecordingInput, RecordingFilter, Agent, Project } from "./types/index.js";
+import { type FeedbackInput } from "./db/feedback.js";
+export declare const APP = "recordings";
+export type { FeedbackInput } from "./db/feedback.js";
+export interface RecordingStats {
+    total: number;
+    raw: number;
+    enhanced: number;
+    total_duration_ms: number;
+    by_model: Record<string, number>;
+}
+export interface Store {
+    readonly mode: "local" | "cloud-http";
+    readonly baseUrl: string | null;
+    createRecording(input: CreateRecordingInput): Promise<Recording>;
+    getRecording(id: string): Promise<Recording | null>;
+    listRecordings(filter?: RecordingFilter): Promise<Recording[]>;
+    searchRecordings(query: string, filter?: RecordingFilter): Promise<Recording[]>;
+    deleteRecording(id: string): Promise<boolean>;
+    getRecordingStats(): Promise<RecordingStats>;
+    registerAgent(name: string, description?: string, role?: string): Promise<Agent>;
+    getAgent(idOrName: string): Promise<Agent | null>;
+    listAgents(): Promise<Agent[]>;
+    heartbeatAgent(idOrName: string): Promise<Agent | null>;
+    setAgentFocus(idOrName: string, projectId: string | null): Promise<Agent | null>;
+    registerProject(name: string, path: string, description?: string): Promise<Project>;
+    getProject(idOrPath: string): Promise<Project | null>;
+    listProjects(): Promise<Project[]>;
+    saveFeedback(input: FeedbackInput): Promise<void>;
+}
+/**
+ * Resolve the active Store from the environment. Cached per-process after first
+ * resolution against `process.env`; pass an explicit `env` (e.g. in tests) to
+ * bypass the cache. Throws if the cloud transport is requested but misconfigured
+ * (URL/key mismatch) so callers never silently read the wrong dataset.
+ */
+export declare function getStore(env?: NodeJS.ProcessEnv | Record<string, string | undefined>): Store;
+/** Test helper: clear the cached Store. */
+export declare function __resetStore(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,KAAK,EACL,OAAO,EACR,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGzF,eAAO,MAAM,GAAG,eAAe,CAAC;AAEhC,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAGhC,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAG7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAClD,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACxD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAGjF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACtD,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAGnC,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAuKD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,KAAK,CAMzG;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.36";
+export declare const VERSION = "0.2.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/recordings",
-  "version": "0.1.36",
+  "version": "0.2.0",
   "type": "module",
   "description": "Speech-to-text recording tool with MCP and CLI — records, transcribes, and optionally enhances text using AI",
   "repository": {
@@ -11,7 +11,8 @@
   "types": "dist/index.d.ts",
   "bin": {
     "recordings": "dist/cli/index.js",
-    "recordings-mcp": "dist/mcp/index.js"
+    "recordings-mcp": "dist/mcp/index.js",
+    "recordings-serve": "dist/server/index.js"
   },
   "exports": {
     ".": {
@@ -21,14 +22,21 @@
     "./storage": {
       "import": "./dist/storage.js",
       "types": "./dist/storage.d.ts"
+    },
+    "./sdk": {
+      "import": "./dist/sdk/index.js",
+      "types": "./dist/sdk/index.d.ts"
     }
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "bun run clean && bun run build:cli && bun run build:mcp && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
+    "build": "bun run clean && bun run build:cli && bun run build:mcp && bun run build:serve && bun run build:lib && tsc --emitDeclarationOnly --outDir dist",
     "build:cli": "bun build src/cli/index.ts --target=bun --outfile=dist/cli/index.js --external=commander --external=chalk --external=openai",
     "build:mcp": "bun build src/mcp/index.ts --target=bun --outfile=dist/mcp/index.js --external=@modelcontextprotocol/sdk --external=openai",
-    "build:lib": "bun build src/index.ts src/storage.ts --target=bun --outdir=dist --external=openai",
+    "build:serve": "bun build src/server/index.ts --target=bun --outfile=dist/server/index.js --external=@modelcontextprotocol/sdk --external=@hasna/contracts --external=openai --external=pg",
+    "build:lib": "bun build src/index.ts src/storage.ts src/sdk/index.ts --target=bun --outdir=dist --external=openai",
+    "generate:sdk": "bun run scripts/generate-sdk.ts",
+    "migrate": "bun run scripts/migrate.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "test:coverage": "bun test --coverage",
@@ -52,6 +60,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@hasna/contracts": "^0.4.2",
     "@hasna/events": "^0.1.11",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.4.1",

package/scripts/generate-sdk.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env bun
+/**
+ * Generate the typed `/v1` SDK client from the serve OpenAPI document.
+ *
+ * Source of truth: src/server/openapi.ts (also served at GET /openapi.json).
+ * Output: src/sdk/v1.generated.ts — a dependency-free typed fetch client.
+ *
+ * Usage: bun run scripts/generate-sdk.ts
+ */
+import { writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { generateSdkFromOpenApi } from "@hasna/contracts/sdk";
+import { buildV1OpenApiDocument } from "../src/server/openapi.js";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const spec = buildV1OpenApiDocument();
+const { code, operations, warnings } = generateSdkFromOpenApi(spec as never, {
+  className: "RecordingsV1Client",
+  apiKeyHeader: "x-api-key",
+});
+
+const header =
+  "// AUTO-GENERATED by scripts/generate-sdk.ts from src/server/openapi.ts — DO NOT EDIT BY HAND.\n" +
+  "// Regenerate: bun run scripts/generate-sdk.ts\n\n";
+const outPath = join(root, "src/sdk/v1.generated.ts");
+writeFileSync(outPath, header + code);
+
+console.log(`Wrote ${outPath}`);
+console.log(`Operations: ${operations.map((o) => o.functionName).join(", ")}`);
+if (warnings.length) console.log(`Warnings:\n  ${warnings.join("\n  ")}`);

package/scripts/migrate.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env bun
+/**
+ * Migration runner for the recordings cloud (A1 pure-remote) database.
+ *
+ * Applies the relational recordings schema and the contracts API-key store,
+ * idempotently (CREATE ... IF NOT EXISTS). NEVER drops or rewrites existing
+ * tables — safe to run against a populated DB. Shares the exact code path used
+ * by the serve process (`ensureCloudSchema`).
+ *
+ * The canonical DDL is committed under migrations/*.sql for transparency.
+ *
+ * Env: HASNA_RECORDINGS_DATABASE_URL (or RECORDINGS_DATABASE_URL / DATABASE_URL).
+ * Usage: bun run scripts/migrate.ts
+ */
+import { ensureCloudSchema, pingCloud, resolveCloudDatabaseUrl, closeCloud } from "../src/server/cloud.js";
+
+async function main() {
+  const url = resolveCloudDatabaseUrl();
+  if (!url) {
+    console.error(
+      "migrate: no database URL (HASNA_RECORDINGS_DATABASE_URL / RECORDINGS_DATABASE_URL / DATABASE_URL)",
+    );
+    process.exit(2);
+  }
+  console.log("migrate: connecting…");
+  await pingCloud();
+  console.log("migrate: applying schema (recordings tables + api_keys)…");
+  await ensureCloudSchema();
+  console.log("migrate: done");
+  await closeCloud();
+  process.exit(0);
+}
+
+main().catch((e) => {
+  console.error("migrate: failed:", (e as Error).message);
+  process.exit(1);
+});

package/dist/cli/storage.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "commander";
-export declare function registerStorageCommands(program: Command): void;
-//# sourceMappingURL=storage.d.ts.map

package/dist/cli/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/cli/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkI9D"}

package/dist/db/pg-migrate.d.ts

@@ -1,8 +0,0 @@
-export interface PgMigrationResult {
-    applied: number[];
-    alreadyApplied: number[];
-    errors: string[];
-    totalMigrations: number;
-}
-export declare function applyPgMigrations(connectionString: string): Promise<PgMigrationResult>;
-//# sourceMappingURL=pg-migrate.d.ts.map

package/dist/db/pg-migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pg-migrate.d.ts","sourceRoot":"","sources":["../../src/db/pg-migrate.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyC5F"}

package/dist/db/storage-config.d.ts

@@ -1,28 +0,0 @@
-export type StorageMode = "local" | "hybrid" | "remote";
-export interface StorageConfig {
-    mode: StorageMode;
-    postgres: {
-        host: string;
-        port: number;
-        username: string;
-        password_env: string;
-        ssl: boolean;
-    };
-}
-export interface StorageEnv {
-    name: string;
-}
-export declare const RECORDINGS_STORAGE_ENV = "HASNA_RECORDINGS_DATABASE_URL";
-export declare const RECORDINGS_STORAGE_FALLBACK_ENV = "RECORDINGS_DATABASE_URL";
-export declare const RECORDINGS_STORAGE_MODE_ENV = "HASNA_RECORDINGS_STORAGE_MODE";
-export declare const RECORDINGS_STORAGE_MODE_FALLBACK_ENV = "RECORDINGS_STORAGE_MODE";
-export declare const RECORDINGS_STORAGE_CONFIG_ENV = "HASNA_RECORDINGS_STORAGE_CONFIG";
-export declare const STORAGE_DATABASE_ENV: readonly ["HASNA_RECORDINGS_DATABASE_URL", "RECORDINGS_DATABASE_URL"];
-export declare const STORAGE_MODE_ENV: readonly ["HASNA_RECORDINGS_STORAGE_MODE", "RECORDINGS_STORAGE_MODE"];
-export declare function getStorageDatabaseEnvName(): (typeof STORAGE_DATABASE_ENV)[number] | null;
-export declare function getStorageDatabaseEnv(): StorageEnv | null;
-export declare function getStorageDatabaseUrl(): string | undefined;
-export declare function getStorageConfig(): StorageConfig;
-export declare function getStorageConnectionString(dbName?: string): string;
-export declare const getConnectionString: typeof getStorageConnectionString;
-//# sourceMappingURL=storage-config.d.ts.map

package/dist/db/storage-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-config.d.ts","sourceRoot":"","sources":["../../src/db/storage-config.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,OAAO,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AACtE,eAAO,MAAM,+BAA+B,4BAA4B,CAAC;AACzE,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAC3E,eAAO,MAAM,oCAAoC,4BAA4B,CAAC;AAC9E,eAAO,MAAM,6BAA6B,oCAAoC,CAAC;AAC/E,eAAO,MAAM,oBAAoB,uEAAqE,CAAC;AACvG,eAAO,MAAM,gBAAgB,uEAA+E,CAAC;AAa7G,wBAAgB,yBAAyB,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,CAKxF;AAED,wBAAgB,qBAAqB,IAAI,UAAU,GAAG,IAAI,CAGzD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAG1D;AAQD,wBAAgB,gBAAgB,IAAI,aAAa,CAoChD;AAED,wBAAgB,0BAA0B,CAAC,MAAM,SAAe,GAAG,MAAM,CAiBxE;AAED,eAAO,MAAM,mBAAmB,mCAA6B,CAAC"}

package/dist/db/storage-sync.d.ts

@@ -1,36 +0,0 @@
-import { type Database } from "bun:sqlite";
-import { STORAGE_DATABASE_ENV, type StorageMode } from "./storage-config.js";
-import { PgAdapterAsync } from "./remote-storage.js";
-export interface SyncResult {
-    table: string;
-    direction: "push" | "pull";
-    rows_read: number;
-    rows_written: number;
-    errors: string[];
-}
-export interface StorageStatus {
-    configured: boolean;
-    mode: StorageMode;
-    enabled: boolean;
-    env: typeof STORAGE_DATABASE_ENV;
-    activeEnv: string | null;
-    service: "recordings";
-    db_path: string;
-    tables: Array<{
-        table: string;
-        rows: number;
-    }>;
-}
-export declare const STORAGE_TABLES: readonly ["projects", "agents", "recordings", "recording_tags", "feedback"];
-export declare const RECORDINGS_STORAGE_TABLES: readonly ["projects", "agents", "recordings", "recording_tags", "feedback"];
-export declare function getStoragePg(): Promise<PgAdapterAsync>;
-export declare function runStorageMigrations(remote: PgAdapterAsync): Promise<void>;
-export declare function getStorageStatus(db?: Database): StorageStatus;
-export declare function pushStorageChanges(tables?: string[]): Promise<SyncResult[]>;
-export declare function pullStorageChanges(tables?: string[]): Promise<SyncResult[]>;
-export declare function syncStorageChanges(tables?: string[]): Promise<{
-    push: SyncResult[];
-    pull: SyncResult[];
-}>;
-export declare function parseStorageTables(raw?: string): string[];
-//# sourceMappingURL=storage-sync.d.ts.map

package/dist/db/storage-sync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-sync.d.ts","sourceRoot":"","sources":["../../src/db/storage-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EACL,oBAAoB,EAIpB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,OAAO,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,cAAc,6EAMjB,CAAC;AAEX,eAAO,MAAM,yBAAyB,6EAAiB,CAAC;AA6ExD,wBAAsB,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CAE5D;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAED,wBAAgB,gBAAgB,CAAC,EAAE,GAAE,QAAwB,GAAG,aAAa,CAqB5E;AAED,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,MAAM,EAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBtG;AAED,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,MAAM,EAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAuBtG;AAED,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,MAAM,EAAwB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,IAAI,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAKpI;AAED,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzD"}

package/dist/mcp/storage-tools.d.ts

@@ -1,3 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function registerRecordingsStorageTools(server: McpServer): void;
-//# sourceMappingURL=storage-tools.d.ts.map

package/dist/mcp/storage-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/storage-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmFtE"}