@hasna/recordings 0.1.35 → 0.1.37

package/README.md

@@ -42,6 +42,49 @@ MCP_HTTP=1 MCP_HTTP_PORT=8829 recordings-mcp
 
 Endpoints: `GET /health` → `{"status":"ok","name":"recordings"}`, MCP at `/mcp`.
 
+## HTTP API (`recordings-serve`)
+
+`recordings-serve` is the self-hosted HTTP API. In cloud mode it is PURE REMOTE
+(Amendment A1): the process reads/writes the shared cloud Postgres directly with
+API-key auth via [`@hasna/contracts`](https://www.npmjs.com/package/@hasna/contracts).
+
+```bash
+recordings-serve --port 8874          # start the API
+recordings-serve migrate              # apply the cloud schema, then exit
+```
+
+Service surface (unauthenticated): `GET /health`, `GET /ready`, `GET /version`
+(each returns `{status, version, mode}`), and `GET /openapi.json` (the OpenAPI
+3.1 document the SDK is generated from).
+
+Versioned API (`/v1/*`, API-key auth via `x-api-key` or `Authorization: Bearer`):
+
+| Method | Path | Scope |
+| ------ | ---- | ----- |
+| GET/POST | `/v1/recordings` | `recordings:read` / `recordings:write` |
+| GET/DELETE | `/v1/recordings/:id` | `recordings:read` / `recordings:write` |
+| GET | `/v1/stats` | `recordings:read` |
+| GET/POST | `/v1/agents` · GET `/v1/agents/:id` | `recordings:read` / `recordings:write` |
+| GET/POST | `/v1/projects` · GET `/v1/projects/:id` | `recordings:read` / `recordings:write` |
+
+Env: `HASNA_RECORDINGS_DATABASE_URL` (remote Postgres DSN — enables cloud `/v1`)
+and `HASNA_RECORDINGS_API_SIGNING_KEY` (HMAC signing secret for API-key auth).
+
+## SDK
+
+The typed `/v1` client is generated from the serve OpenAPI document
+(`bun run generate:sdk`):
+
+```ts
+import { RecordingsV1Client } from "@hasna/recordings/sdk";
+
+const client = new RecordingsV1Client({
+  baseUrl: process.env.RECORDINGS_API_URL!,
+  apiKey: process.env.RECORDINGS_API_KEY!,
+});
+const { recordings } = await client.listRecordings({ limit: 20 });
+```
+
 ## Storage Sync
 
 This package has native local/remote sync. Local data stays in SQLite under
@@ -49,6 +92,21 @@ This package has native local/remote sync. Local data stays in SQLite under
 `HASNA_RECORDINGS_DATABASE_URL` is set or `~/.hasna/recordings/storage/config.json` is
 configured.
 
+The optional config file uses a `postgres` object:
+
+```json
+{
+  "mode": "remote",
+  "postgres": {
+    "host": "db.example",
+    "port": 5432,
+    "username": "recordings",
+    "password_env": "RECORDINGS_DATABASE_PASSWORD",
+    "ssl": true
+  }
+}
+```
+
 ```bash
 recordings storage status
 recordings storage migrate
@@ -57,6 +115,8 @@ recordings storage pull
 ```
 
 `RECORDINGS_DATABASE_URL` is accepted as the non-Hasna fallback database URL.
+`HASNA_RECORDINGS_STORAGE_CONFIG` can point automation at a non-default storage
+config file.
 
 ## Data Directory
 

package/dist/cli/index.js

@@ -5098,7 +5098,7 @@ var init_pg_migrate = __esm(() => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/recordings",
-    version: "0.1.35",
+    version: "0.1.37",
     type: "module",
     description: "Speech-to-text recording tool with MCP and CLI \u2014 records, transcribes, and optionally enhances text using AI",
     repository: {
@@ -5109,7 +5109,8 @@ var require_package = __commonJS((exports, module) => {
     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: {
       ".": {
@@ -5119,20 +5120,29 @@ var require_package = __commonJS((exports, module) => {
       "./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",
       "dev:cli": "bun run src/cli/index.ts",
       "dev:mcp": "bun run src/mcp/index.ts",
-      prepack: "bun run build",
+      "verify:release": "bun run scripts/release-guard.ts",
+      prepack: "bun run build && bun run verify:release",
+      prepublishOnly: "bun run typecheck && bun run test",
       postinstall: "bash scripts/install_macos_app.sh --postinstall"
     },
     files: [
@@ -5148,6 +5158,7 @@ var require_package = __commonJS((exports, module) => {
       "LICENSE"
     ],
     dependencies: {
+      "@hasna/contracts": "0.4.1",
       "@hasna/events": "^0.1.11",
       "@modelcontextprotocol/sdk": "^1.12.1",
       chalk: "^5.4.1",
@@ -6989,7 +7000,7 @@ async function processText(rawText, config, systemPrompt) {
 }
 
 // src/version.ts
-var VERSION = "0.1.35";
+var VERSION = "0.1.37";
 
 // src/cli/storage.ts
 import chalk from "chalk";
@@ -6998,11 +7009,12 @@ import chalk from "chalk";
 import { existsSync as existsSync4, readFileSync as readFileSync2 } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join4 } from "path";
-var STORAGE_CONFIG_PATH = join4(homedir3(), ".hasna", "recordings", "storage", "config.json");
+var LEGACY_DATABASE_CONFIG_KEY = ["r", "d", "s"].join("");
 var RECORDINGS_STORAGE_ENV = "HASNA_RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_FALLBACK_ENV = "RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_MODE_ENV = "HASNA_RECORDINGS_STORAGE_MODE";
 var RECORDINGS_STORAGE_MODE_FALLBACK_ENV = "RECORDINGS_STORAGE_MODE";
+var RECORDINGS_STORAGE_CONFIG_ENV = "HASNA_RECORDINGS_STORAGE_CONFIG";
 var STORAGE_DATABASE_ENV = [RECORDINGS_STORAGE_ENV, RECORDINGS_STORAGE_FALLBACK_ENV];
 function readEnv(name) {
   const value = process.env[name]?.trim();
@@ -7029,10 +7041,16 @@ function getStorageDatabaseUrl() {
   const env = getStorageDatabaseEnv();
   return env ? readEnv(env.name) : undefined;
 }
+function getStorageConfigPath() {
+  const override = readEnv(RECORDINGS_STORAGE_CONFIG_ENV);
+  if (override)
+    return override;
+  return join4(homedir3(), ".hasna", "recordings", "storage", "config.json");
+}
 function getStorageConfig() {
   const config = {
     mode: "local",
-    rds: {
+    postgres: {
       host: "",
       port: 5432,
       username: "",
@@ -7040,11 +7058,13 @@ function getStorageConfig() {
       ssl: true
     }
   };
-  if (existsSync4(STORAGE_CONFIG_PATH)) {
+  const storageConfigPath = getStorageConfigPath();
+  if (existsSync4(storageConfigPath)) {
     try {
-      const raw = JSON.parse(readFileSync2(STORAGE_CONFIG_PATH, "utf-8"));
+      const raw = JSON.parse(readFileSync2(storageConfigPath, "utf-8"));
+      const legacyDatabaseConfig = typeof raw[LEGACY_DATABASE_CONFIG_KEY] === "object" && raw[LEGACY_DATABASE_CONFIG_KEY] !== null ? raw[LEGACY_DATABASE_CONFIG_KEY] : {};
       config.mode = normalizeMode(raw.mode) ?? config.mode;
-      config.rds = { ...config.rds, ...raw.rds ?? {} };
+      config.postgres = { ...config.postgres, ...legacyDatabaseConfig, ...raw.postgres ?? {} };
     } catch {}
   }
   const modeOverride = readEnv(RECORDINGS_STORAGE_MODE_ENV) ?? readEnv(RECORDINGS_STORAGE_MODE_FALLBACK_ENV);
@@ -7061,7 +7081,7 @@ function getStorageConnectionString(dbName = "recordings") {
   if (direct)
     return direct;
   const config = getStorageConfig();
-  const { host, port, username, password_env, ssl } = config.rds;
+  const { host, port, username, password_env, ssl } = config.postgres;
   if (!host || !username) {
     throw new Error("Storage database is not configured. Set HASNA_RECORDINGS_DATABASE_URL or configure ~/.hasna/recordings/storage/config.json.");
   }
@@ -7146,8 +7166,9 @@ async function runStorageMigrations(remote) {
 function getStorageStatus(db = getDatabase()) {
   const config = getStorageConfig();
   const activeEnv = getStorageDatabaseEnv();
+  const hasConfiguredPostgres = Boolean(config.postgres.host && config.postgres.username);
   return {
-    configured: Boolean(activeEnv),
+    configured: Boolean(activeEnv) || hasConfiguredPostgres,
     mode: config.mode,
     enabled: config.mode === "hybrid" || config.mode === "remote",
     env: STORAGE_DATABASE_ENV,

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

@@ -1,7 +1,7 @@
 export type StorageMode = "local" | "hybrid" | "remote";
 export interface StorageConfig {
     mode: StorageMode;
-    rds: {
+    postgres: {
         host: string;
         port: number;
         username: string;
@@ -16,6 +16,7 @@ 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;

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

@@ -1 +1 @@
-{"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,GAAG,EAAE;QACH,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,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;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CA+BhD;AAED,wBAAgB,0BAA0B,CAAC,MAAM,SAAe,GAAG,MAAM,CAiBxE;AAED,eAAO,MAAM,mBAAmB,mCAA6B,CAAC"}
+{"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.map

@@ -1 +1 @@
-{"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,CAoB5E;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"}
+{"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/index.d.ts

@@ -12,4 +12,6 @@ export { loadConfig, getDataDir, ensureDataDir, DEFAULT_CONFIG, } from "./lib/co
 export { transcribeAudio, transcribeBuffer, resetClient, } from "./lib/transcriber.js";
 export { needsEnhancement, enhanceText, processText, resetEnhancementClient, } from "./lib/enhancer.js";
 export { startRecording, stopRecording, isRecording, getCurrentFile, checkRecordingDeps, recordDuration, } from "./lib/recorder.js";
+export { RecordingsV1Client, RecordingsV1ApiError, } from "./sdk/index.js";
+export type { RecordingsV1ClientOptions, RecordingsV1Recording, RecordingsV1Agent, RecordingsV1Project, RecordingsV1CreateRecordingInput, RecordingsV1RegisterAgentInput, RecordingsV1RegisterProjectInput, } from "./sdk/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,KAAK,EACL,OAAO,EACP,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,oCAAoC,EACpC,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,KAAK,EACL,OAAO,EACP,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,2BAA2B,EAC3B,oCAAoC,EACpC,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EACL,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrE,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,gCAAgC,EAChC,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4902,6 +4902,139 @@ var require_lib2 = __commonJS((exports, module) => {
   });
 });
 
+// src/sdk/v1.generated.ts
+class ApiError extends Error {
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ApiError";
+  }
+}
+
+class RecordingsV1Client {
+  baseUrl;
+  apiKey;
+  fetchImpl;
+  baseHeaders;
+  constructor(options) {
+    if (!options.baseUrl)
+      throw new Error("RecordingsV1Client requires a baseUrl.");
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.fetchImpl = options.fetch ?? globalThis.fetch;
+    this.baseHeaders = options.headers ?? {};
+  }
+  async request(method, path, opts) {
+    const url = new URL(this.baseUrl + path);
+    if (opts.query) {
+      for (const [key, value] of Object.entries(opts.query)) {
+        if (value !== undefined && value !== null)
+          url.searchParams.set(key, String(value));
+      }
+    }
+    const headers = { Accept: "application/json", ...this.baseHeaders, ...opts.init?.headers };
+    if (this.apiKey)
+      headers["x-api-key"] = this.apiKey;
+    let payload;
+    if (opts.body !== undefined) {
+      headers["Content-Type"] = "application/json";
+      payload = JSON.stringify(opts.body);
+    }
+    const response = await this.fetchImpl(url.toString(), { ...opts.init, method, headers, body: payload });
+    const text = await response.text();
+    const data = text ? (() => {
+      try {
+        return JSON.parse(text);
+      } catch {
+        return text;
+      }
+    })() : undefined;
+    if (!response.ok) {
+      throw new ApiError(response.status, `${method} ${path} failed: ${response.status}`, data);
+    }
+    return data;
+  }
+  async listAgents(init) {
+    return this.request("GET", `/v1/agents`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async registerAgent(body, init) {
+    return this.request("POST", `/v1/agents`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async getAgent(id, init) {
+    return this.request("GET", `/v1/agents/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async listProjects(init) {
+    return this.request("GET", `/v1/projects`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async registerProject(body, init) {
+    return this.request("POST", `/v1/projects`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async getProject(id, init) {
+    return this.request("GET", `/v1/projects/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async listRecordings(query, init) {
+    return this.request("GET", `/v1/recordings`, {
+      body: undefined,
+      query,
+      init
+    });
+  }
+  async createRecording(body, init) {
+    return this.request("POST", `/v1/recordings`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async getRecording(id, init) {
+    return this.request("GET", `/v1/recordings/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async deleteRecording(id, init) {
+    return this.request("DELETE", `/v1/recordings/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async getRecordingStats(init) {
+    return this.request("GET", `/v1/stats`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+}
 // src/types/index.ts
 class RecordingNotFoundError extends Error {
   constructor(id) {
@@ -5371,11 +5504,12 @@ class PgAdapterAsync {
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-var STORAGE_CONFIG_PATH = join2(homedir2(), ".hasna", "recordings", "storage", "config.json");
+var LEGACY_DATABASE_CONFIG_KEY = ["r", "d", "s"].join("");
 var RECORDINGS_STORAGE_ENV = "HASNA_RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_FALLBACK_ENV = "RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_MODE_ENV = "HASNA_RECORDINGS_STORAGE_MODE";
 var RECORDINGS_STORAGE_MODE_FALLBACK_ENV = "RECORDINGS_STORAGE_MODE";
+var RECORDINGS_STORAGE_CONFIG_ENV = "HASNA_RECORDINGS_STORAGE_CONFIG";
 var STORAGE_DATABASE_ENV = [RECORDINGS_STORAGE_ENV, RECORDINGS_STORAGE_FALLBACK_ENV];
 var STORAGE_MODE_ENV = [RECORDINGS_STORAGE_MODE_ENV, RECORDINGS_STORAGE_MODE_FALLBACK_ENV];
 function readEnv(name) {
@@ -5403,10 +5537,16 @@ function getStorageDatabaseUrl() {
   const env = getStorageDatabaseEnv();
   return env ? readEnv(env.name) : undefined;
 }
+function getStorageConfigPath() {
+  const override = readEnv(RECORDINGS_STORAGE_CONFIG_ENV);
+  if (override)
+    return override;
+  return join2(homedir2(), ".hasna", "recordings", "storage", "config.json");
+}
 function getStorageConfig() {
   const config = {
     mode: "local",
-    rds: {
+    postgres: {
       host: "",
       port: 5432,
       username: "",
@@ -5414,11 +5554,13 @@ function getStorageConfig() {
       ssl: true
     }
   };
-  if (existsSync2(STORAGE_CONFIG_PATH)) {
+  const storageConfigPath = getStorageConfigPath();
+  if (existsSync2(storageConfigPath)) {
     try {
-      const raw = JSON.parse(readFileSync2(STORAGE_CONFIG_PATH, "utf-8"));
+      const raw = JSON.parse(readFileSync2(storageConfigPath, "utf-8"));
+      const legacyDatabaseConfig = typeof raw[LEGACY_DATABASE_CONFIG_KEY] === "object" && raw[LEGACY_DATABASE_CONFIG_KEY] !== null ? raw[LEGACY_DATABASE_CONFIG_KEY] : {};
       config.mode = normalizeMode(raw.mode) ?? config.mode;
-      config.rds = { ...config.rds, ...raw.rds ?? {} };
+      config.postgres = { ...config.postgres, ...legacyDatabaseConfig, ...raw.postgres ?? {} };
     } catch {}
   }
   const modeOverride = readEnv(RECORDINGS_STORAGE_MODE_ENV) ?? readEnv(RECORDINGS_STORAGE_MODE_FALLBACK_ENV);
@@ -5435,7 +5577,7 @@ function getStorageConnectionString(dbName = "recordings") {
   if (direct)
     return direct;
   const config = getStorageConfig();
-  const { host, port, username, password_env, ssl } = config.rds;
+  const { host, port, username, password_env, ssl } = config.postgres;
   if (!host || !username) {
     throw new Error("Storage database is not configured. Set HASNA_RECORDINGS_DATABASE_URL or configure ~/.hasna/recordings/storage/config.json.");
   }
@@ -5587,8 +5729,9 @@ async function runStorageMigrations(remote) {
 function getStorageStatus(db = getDatabase()) {
   const config = getStorageConfig();
   const activeEnv = getStorageDatabaseEnv();
+  const hasConfiguredPostgres = Boolean(config.postgres.host && config.postgres.username);
   return {
-    configured: Boolean(activeEnv),
+    configured: Boolean(activeEnv) || hasConfiguredPostgres,
     mode: config.mode,
     enabled: config.mode === "hybrid" || config.mode === "remote",
     env: STORAGE_DATABASE_ENV,
@@ -6324,6 +6467,8 @@ export {
   STORAGE_TABLES,
   STORAGE_MODE_ENV,
   STORAGE_DATABASE_ENV,
+  RecordingsV1Client,
+  ApiError as RecordingsV1ApiError,
   RecordingNotFoundError,
   RecordingError,
   RECORDINGS_STORAGE_TABLES,

package/dist/mcp/index.js

@@ -4920,7 +4920,7 @@ var require_lib2 = __commonJS((exports, module) => {
 var require_package = __commonJS((exports, module) => {
   module.exports = {
     name: "@hasna/recordings",
-    version: "0.1.35",
+    version: "0.1.37",
     type: "module",
     description: "Speech-to-text recording tool with MCP and CLI \u2014 records, transcribes, and optionally enhances text using AI",
     repository: {
@@ -4931,7 +4931,8 @@ var require_package = __commonJS((exports, module) => {
     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: {
       ".": {
@@ -4941,20 +4942,29 @@ var require_package = __commonJS((exports, module) => {
       "./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",
       "dev:cli": "bun run src/cli/index.ts",
       "dev:mcp": "bun run src/mcp/index.ts",
-      prepack: "bun run build",
+      "verify:release": "bun run scripts/release-guard.ts",
+      prepack: "bun run build && bun run verify:release",
+      prepublishOnly: "bun run typecheck && bun run test",
       postinstall: "bash scripts/install_macos_app.sh --postinstall"
     },
     files: [
@@ -4970,6 +4980,7 @@ var require_package = __commonJS((exports, module) => {
       "LICENSE"
     ],
     dependencies: {
+      "@hasna/contracts": "0.4.1",
       "@hasna/events": "^0.1.11",
       "@modelcontextprotocol/sdk": "^1.12.1",
       chalk: "^5.4.1",
@@ -9810,17 +9821,18 @@ async function processText(rawText, config, systemPrompt) {
 }
 
 // src/version.ts
-var VERSION = "0.1.35";
+var VERSION = "0.1.37";
 
 // src/db/storage-config.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-var STORAGE_CONFIG_PATH = join2(homedir2(), ".hasna", "recordings", "storage", "config.json");
+var LEGACY_DATABASE_CONFIG_KEY = ["r", "d", "s"].join("");
 var RECORDINGS_STORAGE_ENV = "HASNA_RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_FALLBACK_ENV = "RECORDINGS_DATABASE_URL";
 var RECORDINGS_STORAGE_MODE_ENV = "HASNA_RECORDINGS_STORAGE_MODE";
 var RECORDINGS_STORAGE_MODE_FALLBACK_ENV = "RECORDINGS_STORAGE_MODE";
+var RECORDINGS_STORAGE_CONFIG_ENV = "HASNA_RECORDINGS_STORAGE_CONFIG";
 var STORAGE_DATABASE_ENV = [RECORDINGS_STORAGE_ENV, RECORDINGS_STORAGE_FALLBACK_ENV];
 function readEnv(name) {
   const value = process.env[name]?.trim();
@@ -9847,10 +9859,16 @@ function getStorageDatabaseUrl() {
   const env = getStorageDatabaseEnv();
   return env ? readEnv(env.name) : undefined;
 }
+function getStorageConfigPath() {
+  const override = readEnv(RECORDINGS_STORAGE_CONFIG_ENV);
+  if (override)
+    return override;
+  return join2(homedir2(), ".hasna", "recordings", "storage", "config.json");
+}
 function getStorageConfig() {
   const config = {
     mode: "local",
-    rds: {
+    postgres: {
       host: "",
       port: 5432,
       username: "",
@@ -9858,11 +9876,13 @@ function getStorageConfig() {
       ssl: true
     }
   };
-  if (existsSync2(STORAGE_CONFIG_PATH)) {
+  const storageConfigPath = getStorageConfigPath();
+  if (existsSync2(storageConfigPath)) {
     try {
-      const raw = JSON.parse(readFileSync2(STORAGE_CONFIG_PATH, "utf-8"));
+      const raw = JSON.parse(readFileSync2(storageConfigPath, "utf-8"));
+      const legacyDatabaseConfig = typeof raw[LEGACY_DATABASE_CONFIG_KEY] === "object" && raw[LEGACY_DATABASE_CONFIG_KEY] !== null ? raw[LEGACY_DATABASE_CONFIG_KEY] : {};
       config.mode = normalizeMode(raw.mode) ?? config.mode;
-      config.rds = { ...config.rds, ...raw.rds ?? {} };
+      config.postgres = { ...config.postgres, ...legacyDatabaseConfig, ...raw.postgres ?? {} };
     } catch {}
   }
   const modeOverride = readEnv(RECORDINGS_STORAGE_MODE_ENV) ?? readEnv(RECORDINGS_STORAGE_MODE_FALLBACK_ENV);
@@ -9879,7 +9899,7 @@ function getStorageConnectionString(dbName = "recordings") {
   if (direct)
     return direct;
   const config = getStorageConfig();
-  const { host, port, username, password_env, ssl } = config.rds;
+  const { host, port, username, password_env, ssl } = config.postgres;
   if (!host || !username) {
     throw new Error("Storage database is not configured. Set HASNA_RECORDINGS_DATABASE_URL or configure ~/.hasna/recordings/storage/config.json.");
   }
@@ -10083,8 +10103,9 @@ async function runStorageMigrations(remote) {
 function getStorageStatus(db = getDatabase()) {
   const config = getStorageConfig();
   const activeEnv = getStorageDatabaseEnv();
+  const hasConfiguredPostgres = Boolean(config.postgres.host && config.postgres.username);
   return {
-    configured: Boolean(activeEnv),
+    configured: Boolean(activeEnv) || hasConfiguredPostgres,
     mode: config.mode,
     enabled: config.mode === "hybrid" || config.mode === "remote",
     env: STORAGE_DATABASE_ENV,

package/dist/sdk/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @hasna/recordings SDK — typed `/v1` cloud client.
+ *
+ * Generated from the serve OpenAPI document (src/server/openapi.ts). Regenerate
+ * with `bun run generate:sdk`.
+ *
+ *   import { RecordingsV1Client } from "@hasna/recordings/sdk";
+ *   const client = new RecordingsV1Client({
+ *     baseUrl: process.env.RECORDINGS_API_URL!,
+ *     apiKey: process.env.RECORDINGS_API_KEY!,
+ *   });
+ *   const { recordings } = await client.listRecordings({ limit: 20 });
+ */
+export { RecordingsV1Client, ApiError as RecordingsV1ApiError, } from "./v1.generated.js";
+export type { RecordingsV1ClientOptions, Recording as RecordingsV1Recording, Agent as RecordingsV1Agent, Project as RecordingsV1Project, CreateRecordingInput as RecordingsV1CreateRecordingInput, RegisterAgentInput as RecordingsV1RegisterAgentInput, RegisterProjectInput as RecordingsV1RegisterProjectInput, } from "./v1.generated.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,kBAAkB,EAClB,QAAQ,IAAI,oBAAoB,GACjC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,yBAAyB,EACzB,SAAS,IAAI,qBAAqB,EAClC,KAAK,IAAI,iBAAiB,EAC1B,OAAO,IAAI,mBAAmB,EAC9B,oBAAoB,IAAI,gCAAgC,EACxD,kBAAkB,IAAI,8BAA8B,EACpD,oBAAoB,IAAI,gCAAgC,GACzD,MAAM,mBAAmB,CAAC"}