ai-sort 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mrinaal Arora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# ai-sort
+
+vibe-based array sorting powered by GPT.
+because `array.sort()` is too mainstream.
+
+## usage
+
+install:
+
+```bash
+npm install ai-sort
+```
+
+set your OpenAI API key:
+
+```bash
+export OPENAI_API_KEY=your_key_here
+```
+
+then use it:
+
+```js
+import { vibesort } from 'ai-sort';
+
+const result = await vibesort([5, 2, 8, 1, 9]);
+console.log(result); // [1, 2, 5, 8, 9]
+```
+
+## test
+
+```bash
+npm run test
+```
+
+## dependencies
+
+* openai
+* zod
+* dotenv (optional, for `.env` support)
+
+⚠️ requires an OpenAI API key.
+
+⚠️ experimental project — use for vibes, not for prod.

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "ai-sort",
+  "version": "1.0.0",
+  "description": "vibe-based array sorting powered by GPT",
+  "main": "src/vibesort/index.js",
+  "type": "module",
+  "scripts": {
+    "test": "node src/tests/basic.test.js"
+  },
+  "keywords": [
+    "sort",
+    "ai",
+    "vibesort",
+    "gpt",
+    "meme"
+  ],
+  "author": "Mrinaal Arora",
+  "license": "MIT",
+  "dependencies": {
+    "dotenv": "^17.2.1",
+    "openai": "^5.12.2",
+    "zod": "^3.25.76"
+  }
+}

package/src/tests/basic.test.js

@@ -0,0 +1,17 @@
+import { vibesort } from '../vibesort/index.js';
+import 'dotenv/config';
+
+const input = [6, 2, 9, 1, 4];
+
+console.log('[test] starting ai-sort with input:', input);
+
+try {
+  const result = await vibesort(input);
+
+  console.log('[test] result:', result);
+
+  const isSorted = result.every((val, i, arr) => i === 0 || arr[i - 1] <= val);
+  console.log(`[test] is sorted correctly? ${isSorted ? 'yes' : 'no'}`);
+} catch (err) {
+  console.error('[test] error:', err.message);
+}

package/src/vibesort/index.js

@@ -0,0 +1,80 @@
+import OpenAI from "openai";
+import { z } from "zod";
+import { zodTextFormat } from "openai/helpers/zod";
+
+const SortSchema = z.object({
+  sorted: z.array(z.number()),
+});
+
+function nowIso() {
+  return new Date().toISOString();
+}
+
+function logInfo(...parts) {
+  console.log(`[ai-sort] ${nowIso()} INFO:`, ...parts);
+}
+
+function logWarn(...parts) {
+  console.warn(`[ai-sort] ${nowIso()} WARN:`, ...parts);
+}
+
+function logError(...parts) {
+  console.error(`[ai-sort] ${nowIso()} ERROR:`, ...parts);
+}
+
+export async function vibesort(array) {
+  if (!Array.isArray(array)) throw new Error("input must be an array of numbers");
+  const allNumbers = array.every((value) => typeof value === "number" && Number.isFinite(value));
+  if (!allNumbers) {
+    throw new Error("input array must contain only finite numbers");
+  }
+
+  if (!process.env.OPENAI_API_KEY) {
+    const guidance = [
+      "OPENAI_API_KEY is not set.",
+      "Set it in your shell:",
+      '  export OPENAI_API_KEY="sk-..."',
+      "Or add it to a .env file:",
+      "  OPENAI_API_KEY=your_key",
+      "Then run your command again.",
+      "Forgot your key? Happens to the best of us. You can create one here: https://platform.openai.com/api-keys",
+    ].join("\n");
+    logWarn(guidance);
+    throw new Error("missing OPENAI_API_KEY");
+  }
+
+  const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+
+  logInfo("sending array to GPT for sorting:", array);
+
+  try {
+    const response = await openai.responses.parse({
+      model: "gpt-4o-2024-08-06",
+      input: [
+        {
+          role: "user",
+          content: JSON.stringify({ array, order: "asc" }),
+        },
+      ],
+      text: {
+        format: zodTextFormat(SortSchema, "vibesort"),
+      },
+    });
+
+    const result = response.output_parsed.sorted;
+    logInfo("sorted result from GPT:", result);
+    return result;
+  } catch (err) {
+    const status = err?.status || err?.code || "unknown";
+    const base = `sorting failed (status: ${status}).`;
+    const tips = [];
+    if (status === 401) tips.push("Your API key looks shy. Double-check OPENAI_API_KEY and try again.");
+    if (status === 429) tips.push("Too much vibe at once (rate-limited). Pause for a moment and retry.");
+    if (status === "unknown") tips.push("Network gremlins? Check your internet or try again.");
+    tips.push("If vibes keep failing, regenerate a fresh key: https://platform.openai.com/api-keys");
+
+    const message = [base, ...tips].join(" \n");
+    logError(message);
+    throw new Error(message);
+  }
+}