@hasna/recordings 0.1.36 → 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

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.36",
+    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,14 +5120,21 @@ 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",
@@ -5150,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",
@@ -6991,7 +7000,7 @@ async function processText(rawText, config, systemPrompt) {
 }
 
 // src/version.ts
-var VERSION = "0.1.36";
+var VERSION = "0.1.37";
 
 // src/cli/storage.ts
 import chalk from "chalk";

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) {
@@ -6334,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.36",
+    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,14 +4942,21 @@ 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",
@@ -4972,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",
@@ -9812,7 +9821,7 @@ async function processText(rawText, config, systemPrompt) {
 }
 
 // src/version.ts
-var VERSION = "0.1.36";
+var VERSION = "0.1.37";
 
 // src/db/storage-config.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";

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"}

package/dist/sdk/index.js

@@ -0,0 +1,171 @@
+// @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = import.meta.require;
+
+// 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
+    });
+  }
+}
+export {
+  RecordingsV1Client,
+  ApiError as RecordingsV1ApiError
+};

package/dist/sdk/v1.generated.d.ts

@@ -0,0 +1,150 @@
+export interface Recording {
+    "id"?: string;
+    "audio_path"?: string | null;
+    "raw_text"?: string;
+    "processed_text"?: string | null;
+    "processing_mode"?: "raw" | "enhanced";
+    "model_used"?: string;
+    "enhancement_model"?: string | null;
+    "duration_ms"?: number;
+    "language"?: string | null;
+    "tags"?: Array<string>;
+    "agent_id"?: string | null;
+    "project_id"?: string | null;
+    "session_id"?: string | null;
+    "goal"?: string | null;
+    "role"?: string | null;
+    "task_list_id"?: string | null;
+    "machine_id"?: string | null;
+    "metadata"?: Record<string, unknown>;
+    "created_at"?: string;
+}
+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 CreateRecordingInput {
+    "raw_text": string;
+    "audio_path"?: string;
+    "processed_text"?: string;
+    "processing_mode"?: "raw" | "enhanced";
+    "model_used"?: string;
+    "enhancement_model"?: string;
+    "duration_ms"?: number;
+    "language"?: string;
+    "tags"?: Array<string>;
+    "agent_id"?: string;
+    "project_id"?: string;
+    "session_id"?: string;
+    "goal"?: string;
+    "role"?: string;
+    "task_list_id"?: string;
+    "machine_id"?: string;
+    "metadata"?: Record<string, unknown>;
+}
+export interface RegisterAgentInput {
+    "name": string;
+    "description"?: string;
+    "role"?: string;
+}
+export interface RegisterProjectInput {
+    "name": string;
+    "path": string;
+    "description"?: string;
+}
+export interface RecordingsV1ClientOptions {
+    /** Base URL, e.g. process.env.APP_API_URL. */
+    baseUrl: string;
+    /** API key, e.g. process.env.APP_API_KEY. Sent as the 'x-api-key' header. */
+    apiKey?: string;
+    /** Custom fetch (defaults to global fetch). */
+    fetch?: typeof fetch;
+    /** Extra headers merged into every request. */
+    headers?: Record<string, string>;
+}
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, message: string, body: unknown);
+}
+export declare class RecordingsV1Client {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly fetchImpl;
+    private readonly baseHeaders;
+    constructor(options: RecordingsV1ClientOptions);
+    private request;
+    /** List agents */
+    listAgents(init?: RequestInit): Promise<{
+        "agents"?: Array<Agent>;
+        "count"?: number;
+    }>;
+    /** Register (upsert) an agent */
+    registerAgent(body: RegisterAgentInput, init?: RequestInit): Promise<{
+        "agent"?: Agent;
+    }>;
+    /** Get an agent by id or name */
+    getAgent(id: string, init?: RequestInit): Promise<{
+        "agent"?: Agent;
+    }>;
+    /** List projects */
+    listProjects(init?: RequestInit): Promise<{
+        "projects"?: Array<Project>;
+        "count"?: number;
+    }>;
+    /** Register (upsert) a project */
+    registerProject(body: RegisterProjectInput, init?: RequestInit): Promise<{
+        "project"?: Project;
+    }>;
+    /** Get a project by id or path */
+    getProject(id: string, init?: RequestInit): Promise<{
+        "project"?: Project;
+    }>;
+    /** List recordings */
+    listRecordings(query?: {
+        "agent_id"?: string;
+        "project_id"?: string;
+        "session_id"?: string;
+        "processing_mode"?: "raw" | "enhanced";
+        "search"?: string;
+        "limit"?: number;
+        "offset"?: number;
+    }, init?: RequestInit): Promise<{
+        "recordings"?: Array<Recording>;
+        "count"?: number;
+    }>;
+    /** Create a recording */
+    createRecording(body: CreateRecordingInput, init?: RequestInit): Promise<{
+        "recording"?: Recording;
+    }>;
+    /** Get a recording by id */
+    getRecording(id: string, init?: RequestInit): Promise<{
+        "recording"?: Recording;
+    }>;
+    /** Delete a recording by id */
+    deleteRecording(id: string, init?: RequestInit): Promise<{
+        "deleted"?: boolean;
+    }>;
+    /** Aggregate recording statistics */
+    getRecordingStats(init?: RequestInit): Promise<{
+        "total"?: number;
+        "raw"?: number;
+        "enhanced"?: number;
+        "total_duration_ms"?: number;
+        "by_model"?: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=v1.generated.d.ts.map