Copy a working project and change it

// Turn a text file into one MP3 with SparrowCodes text to speech. Node 18+, no packages needed.
//
//   export SPARROW_API_KEY="sk-sc-v1-..."
//   node read-aloud.mjs article.txt article.mp3 --voice F1 --lang en
//
// Long texts are split at sentence ends into pieces the model accepts, spoken one by one, and joined.
import { readFile, writeFile } from "node:fs/promises";

const BASE = process.env.SPARROW_BASE_URL ?? "https://api.sparrowcodes.com/v1";
const KEY = process.env.SPARROW_API_KEY;
const MAX = 4500; // characters per request (the models accept up to 5,000)

const args = process.argv.slice(2);
const flag = (name, fallback) => {
  const i = args.indexOf(`--${name}`);
  return i >= 0 ? args.splice(i, 2)[1] : fallback;
};
const model = flag("model", "supertone/supertonic-3");
const voice = flag("voice", "F1");
const language = flag("lang", "en");
const [input, output = "speech.mp3"] = args;
if (!KEY || !input) {
  console.error("Usage: SPARROW_API_KEY=... node read-aloud.mjs <file.txt> [out.mp3] [--voice F1] [--lang en] [--model supertone/supertonic-3]");
  process.exit(1);
}

/** Split text into pieces of at most MAX characters, breaking after a sentence where possible. */
export function split(text, max = MAX) {
  const pieces = [];
  let rest = text.replace(/\s+/g, " ").trim();
  while (rest.length > max) {
    const window = rest.slice(0, max);
    const cut = Math.max(window.lastIndexOf(". "), window.lastIndexOf("! "), window.lastIndexOf("? "), window.lastIndexOf("。"));
    const at = cut > max / 2 ? cut + 1 : window.lastIndexOf(" ") > 0 ? window.lastIndexOf(" ") : max;
    pieces.push(rest.slice(0, at).trim());
    rest = rest.slice(at).trim();
  }
  if (rest) pieces.push(rest);
  return pieces;
}

const text = await readFile(input, "utf8");
const pieces = split(text);
const audio = [];
let freeLeft = null;
for (const [i, piece] of pieces.entries()) {
  const res = await fetch(`${BASE}/audio/speech`, {
    method: "POST",
    headers: { authorization: `Bearer ${KEY}`, "content-type": "application/json", "x-title": "Voice reader" },
    body: JSON.stringify({ model, voice, language, input: piece, response_format: "mp3" }),
  });
  if (!res.ok) {
    console.error(`Piece ${i + 1} failed: ${res.status} ${await res.text()}`);
    process.exit(1);
  }
  audio.push(Buffer.from(await res.arrayBuffer()));
  freeLeft = res.headers.get("x-sparrow-free-characters-left") ?? freeLeft;
  console.log(`Spoke piece ${i + 1} of ${pieces.length} (${piece.length} characters)`);
}
// MP3 files are a series of frames, so pieces can be joined end to end.
await writeFile(output, Buffer.concat(audio));
console.log(`Saved ${output}. ${text.length.toLocaleString()} characters${freeLeft ? `, ${Number(freeLeft).toLocaleString()} free characters left today` : ""}.`);

"""Review a pull request's changes with SparrowCodes and post the review as a comment. Runs in GitHub Actions.

Needs SPARROW_API_KEY (a repository secret) and GITHUB_TOKEN (provided by Actions). Set DRY_RUN=1 to print the review
instead of posting it. No packages needed.
"""
import json, os, subprocess, urllib.request

BASE = os.environ.get("SPARROW_BASE_URL", "https://api.sparrowcodes.com/v1")
MODEL = os.environ.get("REVIEW_MODEL", "sparrow/auto")
MAX_DIFF = 60_000  # characters of diff sent to the model
MARKER = "<!-- sparrowcodes-review -->"

PROMPT = """You review pull requests. Read the diff and reply in Markdown with:
1. A one-sentence summary of the change.
2. Bugs or risky changes, each with the file and line and why it matters. Say "None found" if there are none.
3. Up to three small suggestions, only if they clearly help.
Be specific and brief. Don't praise, don't repeat the diff, and don't invent problems."""


def http(method, url, body=None, headers=None):
    req = urllib.request.Request(url, data=json.dumps(body).encode() if body is not None else None, method=method, headers={"content-type": "application/json", **(headers or {})})
    with urllib.request.urlopen(req, timeout=300) as r:
        return json.loads(r.read() or b"{}"), r.headers


def main():
    base = os.environ.get("BASE_REF", "main")
    diff = subprocess.run(["git", "diff", f"origin/{base}...HEAD"], capture_output=True, text=True, check=True).stdout
    if not diff.strip():
        print("No changes to review.")
        return
    cut = len(diff) > MAX_DIFF
    out, headers = http("POST", f"{BASE}/chat/completions", {
        "model": MODEL,
        "messages": [{"role": "system", "content": PROMPT}, {"role": "user", "content": diff[:MAX_DIFF]}],
        "max_tokens": 1500,
    }, {"authorization": f"Bearer {os.environ['SPARROW_API_KEY']}", "x-title": "PR reviewer"})
    review = out["choices"][0]["message"]["content"].strip()
    cost = out.get("usage", {}).get("cost", 0)
    footer = f"\n\n---\n<sub>Reviewed by {headers.get('x-sparrow-model', MODEL)} on SparrowCodes for ${cost:.4f}{' · diff shortened to fit' if cut else ''}.</sub>"
    body = MARKER + "\n" + review + footer

    if os.environ.get("DRY_RUN"):
        print(body)
        return
    repo, pr, token = os.environ["GITHUB_REPOSITORY"], os.environ["PR_NUMBER"], os.environ["GITHUB_TOKEN"]
    gh = {"authorization": f"Bearer {token}", "accept": "application/vnd.github+json"}
    comments, _ = http("GET", f"https://api.github.com/repos/{repo}/issues/{pr}/comments?per_page=100", headers=gh)
    mine = next((c for c in comments if MARKER in c.get("body", "")), None)
    if mine:  # update our earlier comment instead of adding a new one on every push
        http("PATCH", mine["url"], {"body": body}, gh)
    else:
        http("POST", f"https://api.github.com/repos/{repo}/issues/{pr}/comments", {"body": body}, gh)
    print(f"Posted review (${cost:.4f}).")


if __name__ == "__main__":
    main()