@hasna/recordings 0.4.0 → 0.5.0

package/dist/cli/index.js

@@ -1919,7 +1919,7 @@ function setAgentFocus(idOrName, projectId, db) {
 // package.json
 var package_default = {
   name: "@hasna/recordings",
-  version: "0.4.0",
+  version: "0.5.0",
   type: "module",
   description: "Speech-to-text recording tool with MCP and CLI \u2014 records, transcribes, and optionally enhances text using AI",
   repository: {
@@ -1945,6 +1945,19 @@ var package_default = {
     "./sdk": {
       import: "./dist/sdk/index.js",
       types: "./dist/sdk/index.d.ts"
+    },
+    "./contracts/hosted-v1": {
+      import: "./dist/contracts/hosted-v1.js",
+      types: "./dist/contracts/hosted-v1.d.ts"
+    },
+    "./contracts/stream-v1": {
+      import: "./dist/contracts/stream-v1.js",
+      types: "./dist/contracts/stream-v1.d.ts"
+    },
+    "./contracts/fixtures/v1": "./contracts/v1/fixtures.json",
+    "./hosted": {
+      import: "./dist/hosted/index.js",
+      types: "./dist/hosted/index.d.ts"
     }
   },
   engines: {
@@ -1956,17 +1969,17 @@ var package_default = {
     "build:cli": "bun build src/cli/index.ts --target=bun --outfile=dist/cli/index.js --external=commander --external=chalk --external=openai --external=@aws-sdk/client-s3",
     "build:mcp": "bun build src/mcp/index.ts --target=bun --outfile=dist/mcp/index.js --external=@modelcontextprotocol/sdk --external=openai --external=@aws-sdk/client-s3",
     "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 --external=@aws-sdk/client-s3",
-    "build:lib": "bun build src/index.ts src/storage.ts src/sdk/index.ts --target=bun --outdir=dist --external=openai --external=@aws-sdk/client-s3",
+    "build:lib": "bun build src/index.ts src/storage.ts src/sdk/index.ts --target=bun --outdir=dist --external=openai --external=@aws-sdk/client-s3 && bun run build:contracts",
     "build:native-fs-guard": "/bin/bash scripts/build_native_fs_guard.sh",
     "generate:sdk": "bun run scripts/generate-sdk.ts",
     migrate: "bun run scripts/migrate.ts",
     typecheck: "tsc --noEmit",
     "typecheck:tcc-contract": "tsc --noEmit -p tsconfig.tcc-contract.json",
-    test: "bun test",
+    test: "bun scripts/release-suite-gate.ts --all",
     "verify:ci-suite": "bun scripts/ci-linux-suite.ts --check",
     "verify:ci-suite:run": "bun scripts/ci-linux-suite.ts --verify-run",
     "verify:ci-native": "bun scripts/ci-native-build.ts",
-    "test:gated": 'bun scripts/ci-linux-suite.ts --check && RECORDINGS_TEST_TIMEOUT_MS="${RECORDINGS_TEST_TIMEOUT_MS:-120000}" bun test --timeout "${RECORDINGS_TEST_TIMEOUT_MS:-120000}" $(bun scripts/ci-linux-suite.ts --gated)',
+    "test:gated": "bun scripts/release-suite-gate.ts",
     "test:vacuity-battery": 'bun scripts/vacuity-manifest-gen.ts > "${TMPDIR:-/tmp}/vacuity-corrupt-sites.tsv" && bun scripts/vacuity-mutation-battery.ts "${TMPDIR:-/tmp}/vacuity-corrupt-sites.tsv"',
     "test:vacuity-battery:source": "bun scripts/vacuity-mutation-battery.ts scripts/vacuity-manifests/source-side.tsv",
     "test:vacuity-battery:chain": "bun scripts/vacuity-mutation-battery.ts scripts/vacuity-manifests/install-chain.tsv",
@@ -1984,11 +1997,16 @@ var package_default = {
     "prepack:platform-gate": `bash -c 'if [ "$(uname -s)" = Darwin ]; then bun run build:native-fs-guard; else echo "WARN: native fs-guard build skipped on $(uname -s) \u2014 dry-run/CI pack; publish recordings from macOS"; fi'`,
     prepublishOnly: "bun run typecheck && bun run release-suite-gate",
     "release-suite-gate": "bun run scripts/release-suite-gate.ts",
-    "typecheck:shortcut-contract": "tsc --noEmit -p tsconfig.test.json"
+    "typecheck:shortcut-contract": "tsc --noEmit -p tsconfig.test.json",
+    "build:contracts": "bun build src/contracts/hosted-v1.ts src/contracts/stream-v1.ts src/hosted/index.ts --target=bun --root src --outdir=dist --splitting --external=@hasna/contracts"
   },
   files: [
     "dist/",
+    "!dist/__tests__/",
     "scripts/",
+    "!scripts/test-recorder-fixtures.ts",
+    "!scripts/**/__pycache__/",
+    "!scripts/**/*.pyc",
     "Dockerfile.package",
     "bun.lock",
     "src/native/Recordings/App/",
@@ -2000,7 +2018,10 @@ var package_default = {
     "src/native/Recordings/build.sh",
     "packaging/macos/",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "contracts/v1/fixtures.json",
+    "docs/wire-contracts.md",
+    "docs/hosted-sdk.md"
   ],
   dependencies: {
     "@aws-sdk/client-s3": "^3.1007.0",
@@ -7481,7 +7502,7 @@ appCommand.command("permissions").description("Show macOS permission state for H
     installed_app_path: status.installed_app_path,
     installed: status.installed,
     legacy_install_paths: status.legacy_install_paths,
-    permission_subject: describeTccAuthorizationSubject(status.installed_app_path),
+    permission_subject: describeTccAuthorizationSubject(status.installed ? status.installed_app_path : null),
     microphone: status.microphone_permission,
     accessibility: status.accessibility_permission,
     app_code_hash: status.app_code_hash,

package/dist/contracts/hosted-v1.d.ts

@@ -0,0 +1,105 @@
+import { type ContractParser, type JSONValue } from "./stream-v1.js";
+export type { ContractParser, ContractResult, JSONValue } from "./stream-v1.js";
+export { ContractValidationError } from "./stream-v1.js";
+export interface HostedRecordingInput {
+    id: string;
+    sessionId?: string;
+    title: string;
+    transcript: string;
+    durationMs: number;
+}
+export interface HostedRecording extends HostedRecordingInput {
+    createdAt: string;
+    updatedAt: string;
+    provenance?: Record<string, JSONValue>;
+    [key: string]: unknown;
+}
+export interface HostedPasteInput {
+    id: string;
+    recordingId?: string | null;
+    text: string;
+    destinationAppId?: string;
+    destinationAppName?: string;
+    status: "attempted" | "confirmed" | "failed";
+    occurredAt?: string;
+}
+export interface HostedPasteReceipt extends HostedPasteInput {
+    recordingId: string | null;
+    occurredAt: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Reported by the client; the server does not independently observe the paste target. */
+    evidenceSource: "client_reported";
+    [key: string]: unknown;
+}
+export interface HostedAccount {
+    id: string;
+    displayName: string;
+    email: string;
+    createdAt: string;
+    [key: string]: unknown;
+}
+export interface HostedPageOptions {
+    limit?: number;
+    before?: string;
+    beforeId?: string;
+}
+export interface HostedAccountResponse {
+    account: HostedAccount;
+    wireVersion?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+export interface HostedVersionResponse {
+    name: "recordings";
+    version: string;
+    apiVersion: "v1";
+    wireVersion?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+export interface HostedHealthResponse {
+    status: "ok";
+    [key: string]: unknown;
+}
+export interface HostedReadyResponse {
+    status: "ready";
+    [key: string]: unknown;
+}
+export declare const recordingInputParser: ContractParser<HostedRecordingInput>;
+export declare const recordingParser: ContractParser<HostedRecording>;
+export declare const pasteInputParser: ContractParser<HostedPasteInput>;
+export declare const pasteReceiptParser: ContractParser<HostedPasteReceipt>;
+export declare const pageOptionsParser: ContractParser<HostedPageOptions>;
+export declare const bootstrapInputParser: ContractParser<Record<string, never>>;
+export declare const renameInputParser: ContractParser<{
+    title: string;
+}>;
+export declare const accountResponseParser: ContractParser<HostedAccountResponse>;
+export declare const versionResponseParser: ContractParser<HostedVersionResponse>;
+export declare const healthResponseParser: ContractParser<HostedHealthResponse>;
+export declare const readyResponseParser: ContractParser<HostedReadyResponse>;
+export declare const recordingResponseParser: ContractParser<{
+    recording: HostedRecording;
+    [key: string]: unknown;
+}>;
+export declare const recordingListParser: ContractParser<{
+    recordings: HostedRecording[];
+    [key: string]: unknown;
+}>;
+export declare const pasteResponseParser: ContractParser<{
+    receipt: HostedPasteReceipt;
+    [key: string]: unknown;
+}>;
+export declare const pasteListParser: ContractParser<{
+    receipts: HostedPasteReceipt[];
+    [key: string]: unknown;
+}>;
+export declare const pendingDeletionParser: ContractParser<{
+    audioCleanup: {
+        state: "pending";
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}>;
+//# sourceMappingURL=hosted-v1.d.ts.map

package/dist/contracts/hosted-v1.d.ts.map

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

package/dist/contracts/hosted-v1.js

@@ -0,0 +1,41 @@
+// @bun
+import {
+  accountResponseParser,
+  bootstrapInputParser,
+  healthResponseParser,
+  pageOptionsParser,
+  pasteInputParser,
+  pasteListParser,
+  pasteReceiptParser,
+  pasteResponseParser,
+  pendingDeletionParser,
+  readyResponseParser,
+  recordingInputParser,
+  recordingListParser,
+  recordingParser,
+  recordingResponseParser,
+  renameInputParser,
+  versionResponseParser
+} from "../hosted-v1-gdr9extc.js";
+import {
+  ContractValidationError
+} from "../hosted-v1-aavn7ktb.js";
+export {
+  versionResponseParser,
+  renameInputParser,
+  recordingResponseParser,
+  recordingParser,
+  recordingListParser,
+  recordingInputParser,
+  readyResponseParser,
+  pendingDeletionParser,
+  pasteResponseParser,
+  pasteReceiptParser,
+  pasteListParser,
+  pasteInputParser,
+  pageOptionsParser,
+  healthResponseParser,
+  bootstrapInputParser,
+  accountResponseParser,
+  ContractValidationError
+};

package/dist/contracts/stream-v1.d.ts

@@ -0,0 +1,117 @@
+/** Public wire values only. Implementations own transport, credentials and session state. */
+export type JSONValue = null | boolean | number | string | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type ContractResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: {
+        code: "invalid_contract";
+    };
+};
+export interface ContractParser<T> {
+    parse(value: unknown): T;
+    safeParse(value: unknown): ContractResult<T>;
+}
+/** Never retains the rejected input, schema issues, a cause or a server message. */
+export declare class ContractValidationError extends Error {
+    readonly code = "invalid_contract";
+    constructor();
+}
+export declare const WIRE_VERSION: "1.0";
+export declare const REQUIRED_CAPABILITIES: readonly ["version-negotiation", "pcm-s16le-24000-mono", "audio-ack", "session-authorize"];
+export declare const PCM_FORMAT: Readonly<{
+    readonly encoding: "pcm_s16le";
+    readonly sampleRateHz: 24000;
+    readonly channels: 1;
+}>;
+export declare const MAX_PCM_FRAME_BYTES = 24000;
+export declare const MAX_PCM_BYTES = 86400000;
+export declare const MAX_CONTROL_BYTES = 20000;
+export interface WireMetadata {
+    wireVersion: string;
+    capabilities: string[];
+}
+export interface StreamStart {
+    type: "session.start";
+    sessionId: string;
+    model?: string;
+    language?: string;
+    wireVersion?: string;
+    capabilities?: string[];
+}
+export type StreamControl = StreamStart | {
+    type: "input.finish";
+} | {
+    type: "session.cancel";
+} | {
+    type: "session.authorize";
+    accessToken: string;
+};
+export interface StreamSegment {
+    id: string;
+    text: string;
+    startSecond?: number;
+    endSecond?: number;
+    [key: string]: unknown;
+}
+export interface StreamTranscript {
+    sessionId: string;
+    text: string;
+    segments?: StreamSegment[];
+    provenance?: Record<string, JSONValue>;
+    [key: string]: unknown;
+}
+interface EventBase {
+    sessionId: string;
+    sequence?: number;
+    [key: string]: unknown;
+}
+export interface AudioAccepted extends EventBase {
+    type: "audio.accepted";
+    bytes: number;
+    totalBytes: number;
+}
+export type StreamEvent = (EventBase & {
+    type: "session.ready";
+    format: typeof PCM_FORMAT;
+    maxInFlightAudioBytes?: number;
+    maxAudioDurationMs?: number;
+    expiresAt?: number;
+    wireVersion?: string;
+    capabilities?: string[];
+}) | AudioAccepted | (EventBase & {
+    type: "session.authorized";
+    expiresAt: number;
+}) | (EventBase & {
+    type: "partial" | "committed";
+    segment: StreamSegment;
+}) | (EventBase & {
+    type: "final";
+    transcript: StreamTranscript;
+    recordingId?: string;
+}) | (EventBase & {
+    type: "error";
+    code: string;
+    message?: string;
+    requestId?: string;
+});
+export declare const recordingIDParser: ContractParser<string>;
+export declare const wireMetadataParser: ContractParser<WireMetadata>;
+/** Absence is legacy v1. An explicit advertisement must be complete and compatible. */
+export declare function optionalWireMetadata(value: {
+    wireVersion?: unknown;
+    capabilities?: unknown;
+}): WireMetadata | undefined;
+/** A decoded JSON control object; use parseStreamControlJSON for the byte-limited wire message. */
+export declare const streamControlParser: ContractParser<StreamControl>;
+export declare function parseStreamControlJSON(message: string): StreamControl;
+export declare const streamEventParser: ContractParser<StreamEvent>;
+/** No conversion, copy or cumulative accounting. The caller owns the session's total/buffer limits. */
+export declare const pcmFrameParser: ContractParser<Uint8Array>;
+/** Pure readback check; does not mutate counters or acknowledge unsent audio. */
+export declare function acceptsAudioAcknowledgement(event: AudioAccepted, sentBytes: number, acknowledgedBytes: number): boolean;
+export {};
+//# sourceMappingURL=stream-v1.d.ts.map

package/dist/contracts/stream-v1.d.ts.map

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

package/dist/contracts/stream-v1.js

@@ -0,0 +1,35 @@
+// @bun
+import {
+  ContractValidationError,
+  MAX_CONTROL_BYTES,
+  MAX_PCM_BYTES,
+  MAX_PCM_FRAME_BYTES,
+  PCM_FORMAT,
+  REQUIRED_CAPABILITIES,
+  WIRE_VERSION,
+  acceptsAudioAcknowledgement,
+  optionalWireMetadata,
+  parseStreamControlJSON,
+  pcmFrameParser,
+  recordingIDParser,
+  streamControlParser,
+  streamEventParser,
+  wireMetadataParser
+} from "../hosted-v1-aavn7ktb.js";
+export {
+  wireMetadataParser,
+  streamEventParser,
+  streamControlParser,
+  recordingIDParser,
+  pcmFrameParser,
+  parseStreamControlJSON,
+  optionalWireMetadata,
+  acceptsAudioAcknowledgement,
+  WIRE_VERSION,
+  REQUIRED_CAPABILITIES,
+  PCM_FORMAT,
+  MAX_PCM_FRAME_BYTES,
+  MAX_PCM_BYTES,
+  MAX_CONTROL_BYTES,
+  ContractValidationError
+};

package/dist/hosted/index.d.ts

@@ -0,0 +1,58 @@
+import * as contract from "../contracts/hosted-v1.js";
+import { type ClientOptions, type RequestOptions } from "./transport.js";
+export { RecordingsSDKError, type SDKErrorCode, type CredentialProvider, type ClientOptions, type RequestOptions } from "./transport.js";
+export type { HostedRecordingInput as RecordingInput, HostedRecording as Recording, HostedPasteInput as PasteInput, HostedPasteReceipt as PasteReceipt, HostedAccount as Account, HostedAccountResponse as AccountResponse, HostedPageOptions as PageOptions } from "../contracts/hosted-v1.js";
+export interface Cursor {
+    before: string;
+    beforeId: string;
+}
+export type DeletionResult = {
+    state: "removed";
+} | {
+    state: "pending";
+};
+/** Explicit cursor for the last received row. No extra request or inferred total. */
+export declare const recordingCursor: (last: contract.HostedRecording) => Cursor;
+export declare const pasteCursor: (last: contract.HostedPasteReceipt) => Cursor;
+/** Hosted JSON API adapter. No native control, ambient login or automatic retry. */
+export declare class HostedRecordingsClient {
+    #private;
+    constructor(options: ClientOptions);
+    get apiBase(): string;
+    health(options?: RequestOptions): Promise<contract.HostedHealthResponse>;
+    version(options?: RequestOptions): Promise<contract.HostedVersionResponse>;
+    ready(options?: RequestOptions): Promise<contract.HostedReadyResponse>;
+    account(options?: RequestOptions): Promise<contract.HostedAccountResponse>;
+    /** Caller owns broker OAuth/PKCE. Profile authority comes from the opaque bearer session. */
+    bootstrap(options?: RequestOptions): Promise<contract.HostedAccountResponse>;
+    logout(options?: RequestOptions): Promise<void>;
+    listRecordings(page?: contract.HostedPageOptions, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recordings: contract.HostedRecording[];
+    }>;
+    getRecording(id: string, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    saveRecording(value: contract.HostedRecordingInput, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    renameRecording(id: string, title: string, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        recording: contract.HostedRecording;
+    }>;
+    /** Pending is durable deletion accepted, not completed audio purge. Repeat explicitly. */
+    deleteRecording(id: string, options?: RequestOptions): Promise<DeletionResult>;
+    listPasteReceipts(page?: contract.HostedPageOptions, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        receipts: contract.HostedPasteReceipt[];
+    }>;
+    savePasteReceipt(value: contract.HostedPasteInput, options?: RequestOptions): Promise<{
+        [key: string]: unknown;
+        receipt: contract.HostedPasteReceipt;
+    }>;
+    deletePasteReceipt(id: string, options?: RequestOptions): Promise<void>;
+    clearPasteHistory(options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hosted/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,2BAA2B,CAAC;AAEtD,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzI,YAAY,EAAE,oBAAoB,IAAI,cAAc,EAAE,eAAe,IAAI,SAAS,EAAE,gBAAgB,IAAI,UAAU,EAChH,kBAAkB,IAAI,YAAY,EAAE,aAAa,IAAI,OAAO,EAAE,qBAAqB,IAAI,eAAe,EACtG,iBAAiB,IAAI,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACtE,MAAM,WAAW,MAAM;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC5D,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AACzE,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,MAAM,QAAQ,CAAC,eAAe,KAAG,MAAyD,CAAC;AAC3H,eAAO,MAAM,WAAW,GAAI,MAAM,QAAQ,CAAC,kBAAkB,KAAG,MAA0D,CAAC;AAE3H,oFAAoF;AACpF,qBAAa,sBAAsB;;gBAErB,OAAO,EAAE,aAAa;IAClC,IAAI,OAAO,IAAI,MAAM,CAAiC;IAChD,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc;IAC/B,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc;IAChC,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc;IAC9B,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc;IACtC,6FAA6F;IACvF,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc;IAGlC,MAAM,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/C,cAAc,CAAC,IAAI,GAAE,QAAQ,CAAC,iBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG9E,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGjD,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG5E,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGzE,0FAA0F;IACpF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAK9E,iBAAiB,CAAC,IAAI,GAAE,QAAQ,CAAC,iBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAGjF,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,cAAc;;;;IAG3E,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IACvE,iBAAiB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CACjE"}