@hasna/recordings 0.1.36 → 0.2.0

package/dist/server/openapi.d.ts

@@ -0,0 +1,614 @@
+export declare function buildV1OpenApiDocument(version?: string): {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description: string;
+    };
+    servers: {
+        url: string;
+    }[];
+    components: {
+        securitySchemes: {
+            apiKey: {
+                type: string;
+                in: string;
+                name: string;
+            };
+        };
+        schemas: {
+            Recording: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly audio_path: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly raw_text: {
+                        readonly type: "string";
+                    };
+                    readonly processed_text: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly processing_mode: {
+                        readonly type: "string";
+                        readonly enum: readonly ["raw", "enhanced"];
+                    };
+                    readonly model_used: {
+                        readonly type: "string";
+                    };
+                    readonly enhancement_model: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly duration_ms: {
+                        readonly type: "number";
+                    };
+                    readonly language: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly tags: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly agent_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly project_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly session_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly goal: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly task_list_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly machine_id: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly metadata: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            Agent: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                    };
+                    readonly metadata: {
+                        readonly type: "object";
+                        readonly additionalProperties: true;
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly last_seen_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            Project: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly nullable: true;
+                    };
+                    readonly created_at: {
+                        readonly type: "string";
+                    };
+                    readonly updated_at: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            CreateRecordingInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    raw_text: {
+                        type: string;
+                    };
+                    audio_path: {
+                        type: string;
+                    };
+                    processed_text: {
+                        type: string;
+                    };
+                    processing_mode: {
+                        type: string;
+                        enum: string[];
+                    };
+                    model_used: {
+                        type: string;
+                    };
+                    enhancement_model: {
+                        type: string;
+                    };
+                    duration_ms: {
+                        type: string;
+                    };
+                    language: {
+                        type: string;
+                    };
+                    tags: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    agent_id: {
+                        type: string;
+                    };
+                    project_id: {
+                        type: string;
+                    };
+                    session_id: {
+                        type: string;
+                    };
+                    goal: {
+                        type: string;
+                    };
+                    role: {
+                        type: string;
+                    };
+                    task_list_id: {
+                        type: string;
+                    };
+                    machine_id: {
+                        type: string;
+                    };
+                    metadata: {
+                        type: string;
+                        additionalProperties: boolean;
+                    };
+                };
+            };
+            RegisterAgentInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                    role: {
+                        type: string;
+                    };
+                };
+            };
+            RegisterProjectInput: {
+                type: string;
+                required: string[];
+                properties: {
+                    name: {
+                        type: string;
+                    };
+                    path: {
+                        type: string;
+                    };
+                    description: {
+                        type: string;
+                    };
+                };
+            };
+        };
+    };
+    security: {
+        apiKey: never[];
+    }[];
+    paths: {
+        "/v1/recordings": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: ({
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                        enum?: undefined;
+                    };
+                } | {
+                    name: string;
+                    in: string;
+                    schema: {
+                        type: string;
+                        enum: string[];
+                    };
+                })[];
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        recordings: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        recording: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/recordings/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        recording: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    "404": {
+                        description: string;
+                    };
+                };
+            };
+            delete: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        deleted: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/stats": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        total: {
+                                            type: string;
+                                        };
+                                        raw: {
+                                            type: string;
+                                        };
+                                        enhanced: {
+                                            type: string;
+                                        };
+                                        total_duration_ms: {
+                                            type: string;
+                                        };
+                                        by_model: {
+                                            type: string;
+                                            additionalProperties: {
+                                                type: string;
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/agents": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        agents: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        agent: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/agents/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        agent: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    "404": {
+                        description: string;
+                    };
+                };
+            };
+        };
+        "/v1/projects": {
+            get: {
+                operationId: string;
+                summary: string;
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        projects: {
+                                            type: string;
+                                            items: {
+                                                $ref: string;
+                                            };
+                                        };
+                                        count: {
+                                            type: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+            post: {
+                operationId: string;
+                summary: string;
+                requestBody: {
+                    required: boolean;
+                    content: {
+                        "application/json": {
+                            schema: {
+                                $ref: string;
+                            };
+                        };
+                    };
+                };
+                responses: {
+                    "201": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        project: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        "/v1/projects/{id}": {
+            get: {
+                operationId: string;
+                summary: string;
+                parameters: {
+                    name: string;
+                    in: string;
+                    required: boolean;
+                    schema: {
+                        type: string;
+                    };
+                }[];
+                responses: {
+                    "200": {
+                        description: string;
+                        content: {
+                            "application/json": {
+                                schema: {
+                                    type: string;
+                                    properties: {
+                                        project: {
+                                            $ref: string;
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    "404": {
+                        description: string;
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/server/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/server/openapi.ts"],"names":[],"mappings":"AAyDA,wBAAgB,sBAAsB,CAAC,OAAO,SAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4SvD"}

package/dist/server/repo.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Postgres-native repository for `recordings-serve` (A1 pure-remote).
+ *
+ * These functions mirror the local SQLite CRUD in `src/db/*.ts` but run against
+ * the shared cloud Postgres DIRECTLY through the repo's own async adapter
+ * (`PgAdapterAsync`) — there is NO local sync/cache in the service. The SQL uses
+ * `?` placeholders (the adapter translates them to `$n`) and Postgres-native
+ * upsert (`ON CONFLICT`) instead of SQLite's `INSERT OR IGNORE`.
+ *
+ * This is a real wrapper over the same relational schema the core lib uses
+ * (`PG_MIGRATIONS`); it shares the domain types and the row-parsing shape. No
+ * stubs — every operation executes real SQL.
+ */
+import type { PgAdapterAsync } from "../db/remote-storage.js";
+import type { Recording, CreateRecordingInput, RecordingFilter, Agent, Project } from "../types/index.js";
+export declare function createRecording(pg: PgAdapterAsync, input: CreateRecordingInput): Promise<Recording>;
+export declare function getRecording(pg: PgAdapterAsync, id: string): Promise<Recording | null>;
+export declare function listRecordings(pg: PgAdapterAsync, filter?: RecordingFilter): Promise<Recording[]>;
+export declare function deleteRecording(pg: PgAdapterAsync, id: string): Promise<boolean>;
+export declare function searchRecordings(pg: PgAdapterAsync, query: string, filter?: RecordingFilter): Promise<Recording[]>;
+export declare function getRecordingStats(pg: PgAdapterAsync): Promise<{
+    total: number;
+    raw: number;
+    enhanced: number;
+    total_duration_ms: number;
+    by_model: Record<string, number>;
+}>;
+export declare function registerAgent(pg: PgAdapterAsync, name: string, description?: string | null, role?: string | null): Promise<Agent>;
+export declare function getAgent(pg: PgAdapterAsync, idOrName: string): Promise<Agent | null>;
+export declare function listAgents(pg: PgAdapterAsync): Promise<Agent[]>;
+export declare function heartbeatAgent(pg: PgAdapterAsync, idOrName: string): Promise<Agent | null>;
+export declare function setAgentFocus(pg: PgAdapterAsync, idOrName: string, projectId: string | null): Promise<Agent | null>;
+export declare function registerProject(pg: PgAdapterAsync, name: string, path: string, description?: string | null): Promise<Project>;
+export declare function getProject(pg: PgAdapterAsync, idOrPath: string): Promise<Project | null>;
+export declare function listProjects(pg: PgAdapterAsync): Promise<Project[]>;
+export declare function saveFeedback(pg: PgAdapterAsync, input: {
+    message: string;
+    email?: string | null;
+    category?: string | null;
+    version?: string | null;
+}): Promise<{
+    saved: true;
+}>;
+//# sourceMappingURL=repo.d.ts.map

package/dist/server/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/server/repo.ts"],"names":[],"mappings":"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"}

package/dist/server/serve.d.ts

@@ -0,0 +1,11 @@
+export declare const SECURITY_HEADERS: Record<string, string>;
+export interface StartServerOptions {
+    host?: string;
+}
+export declare function buildFetch(): (req: Request, server: {
+    requestIP(req: Request): {
+        address: string;
+    } | null;
+}) => Promise<Response>;
+export declare function startServer(port: number, options?: StartServerOptions): Promise<ReturnType<typeof Bun.serve>>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/server/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAyCF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,KAEtB,KAAK,OAAO,EACZ,QAAQ;IAAE,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAAE,KAC9D,OAAO,CAAC,QAAQ,CAAC,CAmFrB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAqBnH"}

package/dist/server/v1.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handle a `/v1/*` request. Returns `null` when the path is not a `/v1` route so
+ * the caller can fall through to other handlers.
+ */
+export declare function handleV1Request(req: Request, url: URL): Promise<Response | null>;
+//# sourceMappingURL=v1.d.ts.map

package/dist/server/v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../src/server/v1.ts"],"names":[],"mappings":"AAkCA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuKtF"}