opennote-cli 1.3.0

package/src/providers/retry.ts

@@ -0,0 +1,54 @@
+const RETRYABLE_STATUS = new Set([408, 409, 425, 429, 500, 502, 503, 504]);
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function parseRetryAfterMs(value: string | null): number | null {
+  if (!value) return null;
+  const sec = Number.parseFloat(value);
+  if (Number.isFinite(sec) && sec >= 0) return Math.round(sec * 1000);
+  const date = Date.parse(value);
+  if (!Number.isNaN(date)) {
+    const diff = date - Date.now();
+    return diff > 0 ? diff : 0;
+  }
+  return null;
+}
+
+function parseTryAgainMs(text: string): number | null {
+  const match = text.match(/try again in\s+(\d+(?:\.\d+)?)s/i);
+  if (!match) return null;
+  const sec = Number.parseFloat(match[1]);
+  if (!Number.isFinite(sec) || sec < 0) return null;
+  return Math.round(sec * 1000);
+}
+
+function backoffMs(attempt: number): number {
+  const base = 500 * Math.pow(2, attempt);
+  const jitter = Math.floor(Math.random() * 250);
+  return base + jitter;
+}
+
+export function shouldRetryStatus(status: number): boolean {
+  return RETRYABLE_STATUS.has(status);
+}
+
+export function computeRetryDelayMs(
+  headersRetryAfter: string | null,
+  responseText: string,
+  attempt: number,
+): number {
+  const fromHeader = parseRetryAfterMs(headersRetryAfter);
+  if (fromHeader != null) return Math.min(10_000, Math.max(250, fromHeader));
+
+  const fromBody = parseTryAgainMs(responseText);
+  if (fromBody != null) return Math.min(10_000, Math.max(250, fromBody));
+
+  return Math.min(10_000, backoffMs(attempt));
+}
+
+export async function waitForRetry(ms: number): Promise<void> {
+  await sleep(ms);
+}
+

package/src/types.js

@@ -0,0 +1 @@
+export {};

package/src/types.ts

@@ -0,0 +1,17 @@
+export type GeneratedNote = {
+  pitch: number;      // 0..127
+  velocity: number;   // 1..127
+  durationMs: number; // >= 1
+};
+
+export type NextNoteRequest = {
+  theme: string;
+  targetLength: number;
+  seedPitch: number;
+  history: GeneratedNote[];
+  bpm: number;
+};
+
+export interface LLMProvider {
+  nextNote(input: NextNoteRequest): Promise<GeneratedNote>;
+}

package/src/validate.js

@@ -0,0 +1,10 @@
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+export function sanitizeNote(note) {
+    return {
+        pitch: clamp(Math.round(note.pitch), 0, 127),
+        velocity: clamp(Math.round(note.velocity), 1, 127),
+        durationMs: Math.max(1, Math.round(note.durationMs)),
+    };
+}

package/src/validate.ts

@@ -0,0 +1,13 @@
+import type { GeneratedNote } from './types';
+
+function clamp(n: number, min: number, max: number): number {
+  return Math.max(min, Math.min(max, n));
+}
+
+export function sanitizeNote(note: GeneratedNote): GeneratedNote {
+  return {
+    pitch: clamp(Math.round(note.pitch), 0, 127),
+    velocity: clamp(Math.round(note.velocity), 1, 127),
+    durationMs: Math.max(1, Math.round(note.durationMs)),
+  };
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": ["src"]
+}