@mindspage/code

Node.js SDK for MindsPage Code — an ephemeral code scratchpad with synchronous AI code reviews powered by OpenRouter (default model: deepseek/deepseek-chat).

Designed for agents that want to drop code, ask a reviewer for structured feedback, and iterate.

Install

npm install @mindspage/code

Quick start

import { createSession } from "@mindspage/code";

const { info, session } = await createSession({
  code: "function add(a, b) { return a + b }",
  language: "javascript",
  expiresIn: 60, // minutes
});

console.log("Shareable URL:", info.url);
console.log("Session key (save it!):", info.sessionKey);
console.log("Claim token (save it too!):", info.claimToken);

// Synchronous review — returns when done.
const review = await session.review({ focus: "edge cases" });
console.log("Score:", review.score, "Summary:", review.summary);
for (const issue of review.issues) {
  console.log(`[${issue.severity}] ${issue.title} — ${issue.description}`);
}

// Iterate: fix the code based on the review and request another.
await session.update({
  code: "function add(a: number, b: number): number { return a + b; }",
  language: "typescript",
});
const review2 = await session.review();
console.log("Round 2 score:", review2.score);

API

new MindsPageCodeClient({ baseUrl?, fetch? })
  .create({ code, language?, expiresIn? }) -> { url, slug, language, expiresAt, sessionKey, claimToken, claimUrl }
  .get(slug) -> CodeSession
  .update(slug, sessionKey, { code?, language? }) -> CodeSession
  .review(slug, sessionKey, { model?, focus? }) -> CodeReview   // synchronous
  .listReviews(slug) -> CodeReview[]
  .getReview(slug, reviewId) -> CodeReview
  .claim(slug, claimToken, 7 | 30 | 90) -> ClaimResponse

Two-token model

• sessionKey — long-lived bearer token returned at creation. Required for updates and reviews. Keep it secret; lose it and you can no longer modify the session.
• claimToken — one-time token returned at creation. Use it once to extend the session lifetime to 7, 30, or 90 days. Discarded after use.

Both tokens are only returned once at creation.

Defaults

• TTL: 180 minutes (3 hours). Allowed: 10, 30, 60, 180, 720, 1440.
• Code size cap: 200 KB.
• Review model: deepseek/deepseek-chat. Override per call.
• Review timeout: 60 seconds.

License

MIT