@alta-foundation/plaud-extractor 1.0.0

package/dist/client/types.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export const TranscriptSegmentSchema = z.object({
+    index: z.number(),
+    startMs: z.number(),
+    endMs: z.number(),
+    speaker: z.string().optional(),
+    text: z.string(),
+    confidence: z.number().min(0).max(1).optional(),
+});
+export const PlaudRecordingSchema = z.object({
+    id: z.string(),
+    title: z.string().optional(),
+    /** Duration in seconds */
+    duration: z.number(),
+    recordedAt: z.string().datetime(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    fileSize: z.number().optional(),
+    mimeType: z.string().default('audio/mp4'),
+    hasTranscript: z.boolean(),
+    transcriptStatus: z.enum(['pending', 'processing', 'completed', 'failed']).optional(),
+    language: z.string().optional(),
+    deviceId: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+    folderId: z.string().optional(),
+    summary: z.string().optional(),
+    /** Raw API payload preserved verbatim for forward-compatibility */
+    _raw: z.record(z.unknown()),
+});
+export const PlaudTranscriptSchema = z.object({
+    recordingId: z.string(),
+    language: z.string().optional(),
+    /** Duration in seconds */
+    duration: z.number(),
+    segments: z.array(TranscriptSegmentSchema),
+    /** Concatenated full text for convenience */
+    fullText: z.string(),
+    createdAt: z.string().datetime().optional(),
+    _raw: z.record(z.unknown()),
+});
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IACzC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,mEAAmE;IACnE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAC5B,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAC5B,CAAC,CAAA"}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+export declare class PlaudError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class AuthError extends PlaudError {
+    constructor(message: string, cause?: unknown);
+}
+export declare class ApiError extends PlaudError {
+    readonly statusCode: number;
+    readonly recordingId?: string | undefined;
+    constructor(message: string, statusCode: number, recordingId?: string | undefined, cause?: unknown);
+    get isRetryable(): boolean;
+}
+export declare class StorageError extends PlaudError {
+    readonly path: string;
+    constructor(message: string, path: string, cause?: unknown);
+}
+export declare class ChecksumMismatchError extends PlaudError {
+    readonly filePath: string;
+    readonly expected: string;
+    readonly actual: string;
+    constructor(filePath: string, expected: string, actual: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aAGjB,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAQlC;AAED,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,qBAAa,QAAS,SAAQ,UAAU;aAGpB,UAAU,EAAE,MAAM;aAClB,WAAW,CAAC,EAAE,MAAM;gBAFpC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,YAAA,EACpC,KAAK,CAAC,EAAE,OAAO;IAMjB,IAAI,WAAW,IAAI,OAAO,CAEzB;CACF;AAED,qBAAa,YAAa,SAAQ,UAAU;aAGxB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EAC5B,KAAK,CAAC,EAAE,OAAO;CAKlB;AAED,qBAAa,qBAAsB,SAAQ,UAAU;aAEjC,QAAQ,EAAE,MAAM;aAChB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,MAAM;gBAFd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;CAKjC"}

package/dist/errors.js

@@ -0,0 +1,51 @@
+export class PlaudError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'PlaudError';
+        if (cause instanceof Error && cause.stack) {
+            this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+        }
+    }
+}
+export class AuthError extends PlaudError {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = 'AuthError';
+    }
+}
+export class ApiError extends PlaudError {
+    statusCode;
+    recordingId;
+    constructor(message, statusCode, recordingId, cause) {
+        super(message, cause);
+        this.statusCode = statusCode;
+        this.recordingId = recordingId;
+        this.name = 'ApiError';
+    }
+    get isRetryable() {
+        return this.statusCode >= 500 || this.statusCode === 429;
+    }
+}
+export class StorageError extends PlaudError {
+    path;
+    constructor(message, path, cause) {
+        super(message, cause);
+        this.path = path;
+        this.name = 'StorageError';
+    }
+}
+export class ChecksumMismatchError extends PlaudError {
+    filePath;
+    expected;
+    actual;
+    constructor(filePath, expected, actual) {
+        super(`Checksum mismatch for ${filePath}: expected ${expected}, got ${actual}`);
+        this.filePath = filePath;
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'ChecksumMismatchError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IAFlB,YACE,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;QACxB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAA;QACzD,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACrB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,UAAU;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,UAAkB,EAClB,WAAoB,EACpC,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAJL,eAAU,GAAV,UAAU,CAAQ;QAClB,gBAAW,GAAX,WAAW,CAAS;QAIpC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACxB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAA;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,UAAU;IAGxB;IAFlB,YACE,OAAe,EACC,IAAY,EAC5B,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAHL,SAAI,GAAJ,IAAI,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IAEjC;IACA;IACA;IAHlB,YACkB,QAAgB,EAChB,QAAgB,EAChB,MAAc;QAE9B,KAAK,CAAC,yBAAyB,QAAQ,cAAc,QAAQ,SAAS,MAAM,EAAE,CAAC,CAAA;QAJ/D,aAAQ,GAAR,QAAQ,CAAQ;QAChB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { PlaudExtractor } from './PlaudExtractor.js';
+export type { PlaudExtractorConfig } from './PlaudExtractor.js';
+export type { SyncOptions, SyncResult, BackfillOptions, VerifyResult } from './sync/types.js';
+export type { PlaudRecording, PlaudTranscript, TranscriptSegment, ListOptions } from './client/types.js';
+export type { AuthSession, StoredCredentials } from './auth/types.js';
+export { PlaudError, AuthError, ApiError, StorageError, ChecksumMismatchError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC7F,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACxG,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAGrE,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// SDK public API — what Alta CORE and other consumers import
+export { PlaudExtractor } from './PlaudExtractor.js';
+// Errors — consumers may need to catch these
+export { PlaudError, AuthError, ApiError, StorageError, ChecksumMismatchError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQpD,6CAA6C;AAC7C,OAAO,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+import pino from 'pino';
+export type Logger = pino.Logger;
+export declare function createLogger(outDir: string, opts?: {
+    verbose?: boolean;
+    redact?: boolean;
+}): pino.Logger;
+export declare function getLogger(): pino.Logger;
+export declare function setLogger(logger: pino.Logger): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;AAIhC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,MAAM,CA6BxG;AAED,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAMvC;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAEnD"}

package/dist/logger.js

@@ -0,0 +1,37 @@
+import pino from 'pino';
+import { runLogsPath } from './storage/paths.js';
+let _logger = null;
+export function createLogger(outDir, opts) {
+    const level = process.env['LOG_LEVEL'] ?? (opts?.verbose ? 'debug' : 'info');
+    const targets = [
+        {
+            target: 'pino/file',
+            options: { destination: runLogsPath(outDir), mkdir: true },
+            level: 'debug',
+        },
+        {
+            target: 'pino-pretty',
+            options: { colorize: true, translateTime: 'SYS:standard' },
+            level,
+        },
+    ];
+    const redactPaths = opts?.redact
+        ? ['authToken', 'cookies', '*.value', 'Authorization', '*.Authorization']
+        : [];
+    _logger = pino({
+        level: 'debug',
+        redact: redactPaths.length > 0 ? { paths: redactPaths, censor: '[REDACTED]' } : undefined,
+    }, pino.transport({ targets }));
+    return _logger;
+}
+export function getLogger() {
+    if (!_logger) {
+        // Fallback: stdout-only logger for when SDK is used without init
+        _logger = pino({ level: process.env['LOG_LEVEL'] ?? 'info' });
+    }
+    return _logger;
+}
+export function setLogger(logger) {
+    _logger = logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAIhD,IAAI,OAAO,GAAuB,IAAI,CAAA;AAEtC,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAA8C;IACzF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAE5E,MAAM,OAAO,GAAkC;QAC7C;YACE,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;YAC1D,KAAK,EAAE,OAAO;SACf;QACD;YACE,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,cAAc,EAAE;YAC1D,KAAK;SACN;KACF,CAAA;IAED,MAAM,WAAW,GAAG,IAAI,EAAE,MAAM;QAC9B,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,CAAC;QACzE,CAAC,CAAC,EAAE,CAAA;IAEN,OAAO,GAAG,IAAI,CACZ;QACE,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS;KAC1F,EACD,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAC5B,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,iEAAiE;QACjE,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,MAAM,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAmB;IAC3C,OAAO,GAAG,MAAM,CAAA;AAClB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"job-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/job-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAwDxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgGxE"}

package/dist/mcp/job-tools.js

@@ -0,0 +1,108 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { z } from 'zod';
+import { stateDir } from '../storage/paths.js';
+import { PlaudExtractor } from '../PlaudExtractor.js';
+import { getLogger } from '../logger.js';
+function jobsDir(outDir) {
+    return path.join(stateDir(outDir), 'jobs');
+}
+async function writeJob(outDir, state) {
+    await fs.mkdir(jobsDir(outDir), { recursive: true });
+    await fs.writeFile(path.join(jobsDir(outDir), `${state.id}.json`), JSON.stringify(state, null, 2));
+}
+async function readJob(outDir, jobId) {
+    try {
+        const raw = await fs.readFile(path.join(jobsDir(outDir), `${jobId}.json`), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function newJobId(type) {
+    const ts = new Date().toISOString().replace(/[-:.TZ]/g, '').slice(0, 14);
+    const rand = crypto.randomBytes(3).toString('hex');
+    return `${type}_${ts}_${rand}`;
+}
+// ─── Async job runner ──────────────────────────────────────────────────────────
+function runAsync(fn) {
+    fn().catch(err => getLogger().error({ err }, 'Unhandled job error'));
+}
+// ─── Tool registration ─────────────────────────────────────────────────────────
+export function registerJobTools(server, outDir) {
+    // ── plaud_sync ─────────────────────────────────────────────────────────────
+    server.tool('plaud_sync', 'Start an incremental sync (new/changed recordings only) in the background. Returns a jobId immediately — poll with plaud_job_status to check progress.', {
+        since: z.string().optional().describe('ISO date — only sync recordings after this date'),
+        limit: z.number().int().min(1).optional().describe('Max recordings to sync'),
+        dryRun: z.boolean().default(false).describe('Preview without downloading'),
+    }, async ({ since, limit, dryRun }) => {
+        const jobId = newJobId('sync');
+        const job = { id: jobId, type: 'sync', status: 'running', startedAt: new Date().toISOString() };
+        await writeJob(outDir, job);
+        runAsync(async () => {
+            try {
+                const extractor = new PlaudExtractor({ outDir, logger: getLogger() });
+                const result = await extractor.sync({
+                    since: since ? new Date(since) : undefined,
+                    limit,
+                    dryRun,
+                });
+                await writeJob(outDir, { ...job, status: 'completed', completedAt: new Date().toISOString(), result });
+            }
+            catch (err) {
+                await writeJob(outDir, { ...job, status: 'failed', completedAt: new Date().toISOString(), error: String(err) });
+            }
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        jobId,
+                        status: 'running',
+                        message: `Sync started. Poll with: plaud_job_status({ jobId: "${jobId}" })`,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── plaud_backfill ─────────────────────────────────────────────────────────
+    server.tool('plaud_backfill', 'Re-evaluate and re-download all recordings in the background. Returns a jobId immediately — poll with plaud_job_status to check progress.', {
+        limit: z.number().int().min(1).optional().describe('Max recordings to process'),
+    }, async ({ limit }) => {
+        const jobId = newJobId('backfill');
+        const job = { id: jobId, type: 'backfill', status: 'running', startedAt: new Date().toISOString() };
+        await writeJob(outDir, job);
+        runAsync(async () => {
+            try {
+                const extractor = new PlaudExtractor({ outDir, logger: getLogger() });
+                const result = await extractor.backfill({ limit });
+                await writeJob(outDir, { ...job, status: 'completed', completedAt: new Date().toISOString(), result });
+            }
+            catch (err) {
+                await writeJob(outDir, { ...job, status: 'failed', completedAt: new Date().toISOString(), error: String(err) });
+            }
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        jobId,
+                        status: 'running',
+                        message: `Backfill started. Poll with: plaud_job_status({ jobId: "${jobId}" })`,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── plaud_job_status ───────────────────────────────────────────────────────
+    server.tool('plaud_job_status', 'Check the status of a background sync or backfill job.', {
+        jobId: z.string().describe('The jobId returned by plaud_sync or plaud_backfill'),
+    }, async ({ jobId }) => {
+        const job = await readJob(outDir, jobId);
+        if (!job) {
+            return { content: [{ type: 'text', text: `Job not found: ${jobId}` }] };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(job, null, 2) }] };
+    });
+}
+//# sourceMappingURL=job-tools.js.map

package/dist/mcp/job-tools.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/read-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAMxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8IzE"}

package/dist/mcp/read-tools.js

@@ -0,0 +1,173 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { loadCredentials, isExpired } from '../auth/token-store.js';
+import { syncStatePath } from '../storage/paths.js';
+import { SyncStateSchema } from '../sync/types.js';
+export function registerReadTools(server, outDir) {
+    // ── plaud_status ──────────────────────────────────────────────────────────
+    server.tool('plaud_status', 'Check Plaud connection status, last sync time, and local recording count.', {}, async () => {
+        const creds = await loadCredentials().catch(() => null);
+        let auth;
+        if (!creds) {
+            auth = 'not authenticated — run: alta-plaud auth';
+        }
+        else if (isExpired(creds)) {
+            auth = 'token expired — run: alta-plaud auth';
+        }
+        else {
+            auth = 'authenticated';
+        }
+        let lastSync = 'never';
+        let recordingCount = 0;
+        try {
+            const raw = await fs.readFile(syncStatePath(outDir), 'utf8');
+            const state = SyncStateSchema.parse(JSON.parse(raw));
+            if (state.lastSuccessfulSyncAt)
+                lastSync = state.lastSuccessfulSyncAt;
+            recordingCount = Object.keys(state.recordings).length;
+        }
+        catch { /* no state file yet */ }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ auth, lastSync, recordingCount, outDir }, null, 2),
+                }],
+        };
+    });
+    // ── plaud_list_recordings ─────────────────────────────────────────────────
+    server.tool('plaud_list_recordings', 'List locally synced Plaud recordings. Filter by date or search title.', {
+        limit: z.number().int().min(1).max(200).default(20).describe('Max results (default 20)'),
+        since: z.string().optional().describe('ISO date — only recordings after this date'),
+        search: z.string().optional().describe('Case-insensitive title filter'),
+    }, async ({ limit, since, search }) => {
+        let recordings = await walkRecordingMeta(outDir);
+        if (since) {
+            const sinceDate = new Date(since);
+            recordings = recordings.filter(r => new Date(r.recorded_at ?? '') >= sinceDate);
+        }
+        if (search) {
+            const q = search.toLowerCase();
+            recordings = recordings.filter(r => (r.title ?? '').toLowerCase().includes(q));
+        }
+        recordings.sort((a, b) => (b.recorded_at ?? '').localeCompare(a.recorded_at ?? ''));
+        const page = recordings.slice(0, limit);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        total: recordings.length,
+                        returned: page.length,
+                        recordings: page.map(r => ({
+                            id: r.source_recording_id,
+                            title: r.title,
+                            recorded_at: r.recorded_at,
+                            duration_seconds: r.duration_seconds,
+                            has_transcript: r.has_transcript,
+                        })),
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── plaud_get_transcript ──────────────────────────────────────────────────
+    server.tool('plaud_get_transcript', 'Get the full transcript of a recording by ID or partial title match.', {
+        recordingId: z.string().optional().describe('Exact recording ID'),
+        title: z.string().optional().describe('Partial title match (case-insensitive)'),
+    }, async ({ recordingId, title }) => {
+        if (!recordingId && !title) {
+            return { content: [{ type: 'text', text: 'Error: provide recordingId or title' }] };
+        }
+        const recordings = await walkRecordingMeta(outDir);
+        let match;
+        if (recordingId) {
+            match = recordings.find(r => r.source_recording_id === recordingId);
+        }
+        else if (title) {
+            const q = title.toLowerCase();
+            match = recordings.find(r => (r.title ?? '').toLowerCase().includes(q));
+        }
+        if (!match) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `No recording found matching: ${recordingId ?? title}`,
+                    }],
+            };
+        }
+        let transcript = '';
+        try {
+            transcript = await fs.readFile(path.join(match._dir, 'transcript.txt'), 'utf8');
+        }
+        catch {
+            try {
+                const raw = await fs.readFile(path.join(match._dir, 'transcript.json'), 'utf8');
+                const data = JSON.parse(raw);
+                transcript = (data.segments ?? []).map(s => s.text ?? '').filter(Boolean).join('\n\n');
+            }
+            catch {
+                transcript = '(no transcript available)';
+            }
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        id: match.source_recording_id,
+                        title: match.title,
+                        recorded_at: match.recorded_at,
+                        duration_seconds: match.duration_seconds,
+                        transcript,
+                    }, null, 2),
+                }],
+        };
+    });
+}
+async function walkRecordingMeta(outDir) {
+    const recordingsBase = path.join(outDir, 'recordings');
+    const results = [];
+    let yearDirs;
+    try {
+        yearDirs = await fs.readdir(recordingsBase);
+    }
+    catch {
+        return results;
+    }
+    for (const year of yearDirs) {
+        let monthDirs;
+        try {
+            monthDirs = await fs.readdir(path.join(recordingsBase, year));
+        }
+        catch {
+            continue;
+        }
+        for (const month of monthDirs) {
+            let recDirs;
+            try {
+                recDirs = await fs.readdir(path.join(recordingsBase, year, month));
+            }
+            catch {
+                continue;
+            }
+            for (const recDir of recDirs) {
+                const dirPath = path.join(recordingsBase, year, month, recDir);
+                try {
+                    const raw = await fs.readFile(path.join(dirPath, 'meta.json'), 'utf8');
+                    const meta = JSON.parse(raw);
+                    results.push({
+                        source_recording_id: String(meta['source_recording_id'] ?? ''),
+                        title: meta['title'],
+                        recorded_at: meta['recorded_at'],
+                        duration_seconds: meta['duration_seconds'],
+                        has_transcript: meta['has_transcript'],
+                        _dir: dirPath,
+                    });
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=read-tools.js.map

package/dist/mcp/read-tools.js.map

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

package/dist/mcp/server.d.ts

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

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

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

package/dist/mcp/server.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import os from 'node:os';
+import pino from 'pino';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { defaultOutDir, runLogsPath } from '../storage/paths.js';
+import { setLogger } from '../logger.js';
+import { registerReadTools } from './read-tools.js';
+import { registerJobTools } from './job-tools.js';
+const rawDir = process.env['ALTA_DATA_DIR'];
+const outDir = rawDir
+    ? path.resolve(rawDir.replace(/^~/, os.homedir()))
+    : defaultOutDir();
+// MCP communicates over stdio — logs must go to file only, never stdout
+const logger = pino({ level: 'debug' }, pino.transport({
+    targets: [{
+            target: 'pino/file',
+            options: { destination: runLogsPath(outDir), mkdir: true },
+            level: 'debug',
+        }],
+}));
+setLogger(logger);
+const server = new McpServer({
+    name: 'alta-plaud',
+    version: '1.0.0',
+});
+registerReadTools(server, outDir);
+registerJobTools(server, outDir);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;AAC3C,MAAM,MAAM,GAAG,MAAM;IACnB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,aAAa,EAAE,CAAA;AAEnB,wEAAwE;AACxE,MAAM,MAAM,GAAG,IAAI,CACjB,EAAE,KAAK,EAAE,OAAO,EAAE,EAClB,IAAI,CAAC,SAAS,CAAC;IACb,OAAO,EAAE,CAAC;YACR,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE;YAC1D,KAAK,EAAE,OAAO;SACf,CAAC;CACH,CAAC,CACH,CAAA;AACD,SAAS,CAAC,MAAM,CAAC,CAAA;AAEjB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEhC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA"}

package/dist/storage/atomic.d.ts

@@ -0,0 +1,5 @@
+/** Write a file atomically: write to .tmp-<rand>, then rename. */
+export declare function writeFileAtomic(filePath: string, data: string | Buffer): Promise<void>;
+/** Stream a ReadableStream to a file atomically. */
+export declare function writeStreamAtomic(filePath: string, stream: AsyncIterable<Uint8Array> | NodeJS.ReadableStream): Promise<void>;
+//# sourceMappingURL=atomic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/storage/atomic.ts"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5F;AAED,oDAAoD;AACpD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,cAAc,GACxD,OAAO,CAAC,IAAI,CAAC,CA0Bf"}