@oasissys/sqlcl-cli 0.1.2

package/dist/src/session.js

@@ -0,0 +1,270 @@
+/**
+ * SQLcl runner — talks to Oracle's SQLcl for everything.
+ *
+ * Storage model: all named connections live in SQLcl's own wallet
+ * (`%APPDATA%/dbtools/connections/` on Windows, `~/.dbtools/connections/`
+ * on Mac/Linux). Same store the official SQLcl MCP reads, so the dashboard
+ * and Claude's MCP tools are always in sync — no parallel state in
+ * ~/.oasis.json.
+ *
+ * The only thing we keep in ~/.oasis.json is `sqlcl.active` (just a name),
+ * because SQLcl itself is stateless between invocations and has no concept
+ * of a "currently selected" connection.
+ *
+ * Commands used:
+ *   - `sql -L -S -name <N>` to run SQL against a saved connection
+ *   - `sql -S /nolog` + `conn -savepwd -save …`   (add)
+ *   - `sql -S /nolog` + `connmgr delete -conn …`  (remove)
+ */
+import { spawn, execSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function resolveSqlclBin() {
+    const env = process.env.SQLCL_PATH;
+    if (env && existsSync(env))
+        return env;
+    const isWin = process.platform === "win32";
+    const binName = isWin ? "sql.exe" : "sql";
+    const home = os.homedir();
+    const bootstrap = path.join(home, ".oasis", "sqlcl", "bin", binName);
+    if (existsSync(bootstrap))
+        return bootstrap;
+    const candidates = isWin
+        ? [
+            "C:\\Oracle\\sqlcl\\bin\\sql.exe",
+            path.join(process.env.LOCALAPPDATA ?? "", "Programs", "sqlcl", "bin", "sql.exe"),
+            path.join(process.env.ProgramFiles ?? "", "sqlcl", "bin", "sql.exe"),
+        ]
+        : [
+            "/opt/sqlcl/bin/sql",
+            "/usr/local/sqlcl/bin/sql",
+            path.join(home, "sqlcl", "bin", "sql"),
+        ];
+    for (const c of candidates)
+        if (c && existsSync(c))
+            return c;
+    try {
+        const lookup = isWin ? `where ${binName}` : `which ${binName}`;
+        const found = execSync(lookup, { stdio: ["ignore", "pipe", "ignore"] }).toString().trim().split(/\r?\n/)[0];
+        if (found && existsSync(found))
+            return found;
+    }
+    catch { /* not on PATH */ }
+    return binName;
+}
+const SQLCL_BIN = resolveSqlclBin();
+/** Location of SQLcl's wallet (one subfolder per connection). */
+function dbtoolsDir() {
+    // Windows: %APPDATA%\dbtools ; Mac/Linux: ~/.dbtools
+    if (process.platform === "win32" && process.env.APPDATA) {
+        return path.join(process.env.APPDATA, "dbtools");
+    }
+    return path.join(os.homedir(), ".dbtools");
+}
+/** Parse `host[:port]/service` out of SQLcl's `connectionString` property. */
+function parseConnectString(s) {
+    // SQLcl escapes `:` as `\:` in .properties files; optional `//` EZ-connect prefix.
+    const clean = s.replace(/\\:/g, ":").replace(/^\/\//, "").trim();
+    // host:port/service   OR   host/service (port defaults to 1521, Oracle's listener)
+    const withPort = clean.match(/^([^:/]+):(\d+)\/(.+)$/);
+    if (withPort)
+        return { host: withPort[1], port: parseInt(withPort[2], 10), service: withPort[3] };
+    const noPort = clean.match(/^([^:/]+)\/(.+)$/);
+    if (noPort)
+        return { host: noPort[1], port: 1521, service: noPort[2] };
+    return null;
+}
+/**
+ * List saved connections by reading each subdirectory's `dbtools.properties`.
+ * Simpler + faster than shelling out and parsing `connmgr list` (which has
+ * ANSI codes and no machine-friendly output).
+ */
+export function listConnections() {
+    const connectionsRoot = path.join(dbtoolsDir(), "connections");
+    if (!existsSync(connectionsRoot))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(connectionsRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const propFile = path.join(connectionsRoot, entry.name, "dbtools.properties");
+        if (!existsSync(propFile))
+            continue;
+        try {
+            const props = {};
+            for (const line of readFileSync(propFile, "utf8").split(/\r?\n/)) {
+                const eq = line.indexOf("=");
+                if (eq > 0 && !line.startsWith("#")) {
+                    props[line.slice(0, eq).trim()] = line.slice(eq + 1).trim();
+                }
+            }
+            if (props.type !== "ORACLE_DATABASE")
+                continue; // skip non-Oracle entries if any
+            const parsed = parseConnectString(props.connectionString ?? "");
+            if (!props.name || !parsed)
+                continue;
+            out.push({ name: props.name, user: props.userName ?? "", ...parsed });
+        }
+        catch { /* skip broken dir */ }
+    }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Run SQL against a saved connection by name (wallet-backed, no creds on cmdline).
+ *
+ * `longBytes` controls `SET LONG` / `SET LONGCHUNKSIZE` — unlike the MCP pool
+ * path (which gets `SP2-0738` restricted-command errors), direct spawn lets us
+ * lift the LOB cap freely. Used by /api/sqlcl/lob-full to fetch full values.
+ */
+export async function runSql(connectionName, sql, opts = {}) {
+    const { timeoutMs = 60_000, format = "ansiconsole", longBytes } = opts;
+    return new Promise((resolve) => {
+        const proc = spawn(SQLCL_BIN, ["-L", "-S", "-name", connectionName], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, MSYS2_ARG_CONV_EXCL: "*" },
+        });
+        let stdout = "", stderr = "";
+        proc.stdout.on("data", d => stdout += d.toString());
+        proc.stderr.on("data", d => stderr += d.toString());
+        const timer = setTimeout(() => {
+            proc.kill();
+            resolve({ stdout, stderr: stderr + `\n[timeout after ${timeoutMs}ms]`, code: -1 });
+        }, timeoutMs);
+        proc.on("close", (code) => { clearTimeout(timer); resolve({ stdout, stderr, code: code ?? -1 }); });
+        proc.on("error", (err) => { clearTimeout(timer); resolve({ stdout, stderr: String(err), code: -1 }); });
+        const format_prelude = format === "csv"
+            ? "SET FEEDBACK OFF\nSET SQLFORMAT CSV\nSET HEADING ON\n"
+            : "SET FEEDBACK ON\nSET SQLFORMAT ANSICONSOLE\n";
+        const long_prelude = longBytes != null
+            ? `SET LONG ${longBytes}\nSET LONGCHUNKSIZE ${longBytes}\n`
+            : "";
+        proc.stdin.write(format_prelude + long_prelude);
+        proc.stdin.write(sql.trim().replace(/;?\s*$/, "") + ";\n");
+        proc.stdin.write("EXIT\n");
+        proc.stdin.end();
+    });
+}
+/**
+ * Run a raw SQLcl script against a saved connection, verbatim — no trailing-`;`
+ * rewriting, no format prelude. Caller owns the entire script including
+ * `SET …`, PL/SQL blocks ending with `/`, and `EXIT`.
+ *
+ * Used for `DBMS_SQL.describe_columns` which is a PL/SQL block terminated by
+ * `/` on its own line — the default runSql() strips that.
+ */
+export async function runSqlclScript(connectionName, script, opts = {}) {
+    const { timeoutMs = 30_000 } = opts;
+    return new Promise((resolve) => {
+        const proc = spawn(SQLCL_BIN, ["-L", "-S", "-name", connectionName], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, MSYS2_ARG_CONV_EXCL: "*" },
+        });
+        let stdout = "", stderr = "";
+        proc.stdout.on("data", d => stdout += d.toString());
+        proc.stderr.on("data", d => stderr += d.toString());
+        const timer = setTimeout(() => {
+            proc.kill();
+            resolve({ stdout, stderr: stderr + `\n[timeout after ${timeoutMs}ms]`, code: -1 });
+        }, timeoutMs);
+        proc.on("close", (code) => { clearTimeout(timer); resolve({ stdout, stderr, code: code ?? -1 }); });
+        proc.on("error", (err) => { clearTimeout(timer); resolve({ stdout, stderr: String(err), code: -1 }); });
+        proc.stdin.write(script.endsWith("\n") ? script : script + "\n");
+        proc.stdin.write("EXIT\n");
+        proc.stdin.end();
+    });
+}
+/** Run SQLcl commands in /nolog mode — no database connection, for wallet mgmt. */
+async function runSqlclNoLog(commands, timeoutMs = 30_000) {
+    return new Promise((resolve) => {
+        const proc = spawn(SQLCL_BIN, ["-S", "/nolog"], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env, MSYS2_ARG_CONV_EXCL: "*" },
+        });
+        let stdout = "", stderr = "";
+        proc.stdout.on("data", d => stdout += d.toString());
+        proc.stderr.on("data", d => stderr += d.toString());
+        const timer = setTimeout(() => {
+            proc.kill();
+            resolve({ stdout, stderr: stderr + `\n[timeout]`, code: -1 });
+        }, timeoutMs);
+        proc.on("close", (code) => { clearTimeout(timer); resolve({ stdout, stderr, code: code ?? -1 }); });
+        proc.on("error", (err) => { clearTimeout(timer); resolve({ stdout, stderr: String(err), code: -1 }); });
+        for (const cmd of commands)
+            proc.stdin.write(cmd + "\n");
+        proc.stdin.write("EXIT\n");
+        proc.stdin.end();
+    });
+}
+/**
+ * SQLcl parses its command-line inside the CLI using whitespace as the
+ * separator, so names with spaces break `conn -save <name>` unless quoted.
+ * Double-quoting is the portable escape. Embedded double-quotes in a name
+ * make no sense for a connection name — reject upfront at the API layer.
+ */
+function quoteArg(s) {
+    return `"${s.replace(/"/g, '""')}"`;
+}
+export function validateConnectionName(name) {
+    if (!name || !name.trim())
+        return "Connection name required";
+    if (name.includes('"'))
+        return "Connection name cannot contain double-quotes";
+    if (name.length > 128)
+        return "Connection name too long (max 128)";
+    return null;
+}
+/**
+ * Inspect SQLcl output for common auth/connection failures.
+ *
+ * `conn -save` is save-IF-connect-succeeds — the wallet entry only persists
+ * when auth works. SQLcl always exits 0 even on failure, so we have to look
+ * for error markers in stdout/stderr to distinguish success from silent fail.
+ */
+function didConnect(r) {
+    const all = `${r.stdout}\n${r.stderr}`;
+    if (r.code !== 0)
+        return false;
+    if (/Connection failed/i.test(all))
+        return false;
+    if (/^ORA-\d+/m.test(all))
+        return false;
+    return true;
+}
+/**
+ * Save a named connection into the SQLcl wallet. The save-and-connect happens
+ * in a single `conn -savepwd -save` command — SQLcl only persists the wallet
+ * entry if auth actually succeeds, so a successful return means the creds are
+ * verified.
+ */
+export async function saveConnection(c) {
+    const r = await runSqlclNoLog([
+        `conn -savepwd -save ${quoteArg(c.name)} ${c.user}/"${c.password}"@${c.host}:${c.port}/${c.service}`,
+        `disc`,
+    ]);
+    return didConnect(r)
+        ? { ok: true, message: "Connection saved" }
+        : { ok: false, message: summarizeSqlError(r) };
+}
+export async function deleteConnection(name) {
+    return runSqlclNoLog([`connmgr delete -conn ${quoteArg(name)}`]);
+}
+/**
+ * Verify credentials without persisting them — save under a throwaway name,
+ * check if the wallet gained an entry, then remove it regardless.
+ */
+export async function probeConnection(c) {
+    const tmpName = `__oasis_probe_${Date.now()}`;
+    const res = await saveConnection({ ...c, name: tmpName });
+    await deleteConnection(tmpName); // best-effort cleanup whether save passed or failed
+    return res;
+}
+export function summarizeSqlError(r) {
+    const combined = [r.stdout, r.stderr].filter(Boolean).join("\n");
+    const lines = combined.split(/\r?\n/).map(l => l.trim()).filter(Boolean);
+    const noise = /^(WARNING:|SQLcl:|Connected\.|\s*Version|\s*Copyright|\s*Oracle)/i;
+    const clean = lines.filter(l => !noise.test(l));
+    const diag = clean.filter(l => /^(ORA-|SP2-|PLS-|IO Error|USER|ERROR)\b/i.test(l));
+    return (diag.length ? diag : clean).slice(-5).join("\n") || `sqlcl exited with code ${r.code}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/src/session.js.map

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

package/dist/src/storage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Single owner of ~/.oasis.json. All reads/writes for creds and
+ * service-specific sections (sqlcl.connections, etc.) go through here.
+ *
+ * Guarantees:
+ *   - Atomic writes: write to a sibling `.tmp` then rename.
+ *   - In-process mutex: concurrent updateStore() calls serialize, so two
+ *     callers can't lose each other's writes within the same process.
+ */
+export declare const OASIS_FILE: string;
+export interface ServiceSection {
+    creds?: Record<string, string>;
+    [key: string]: unknown;
+}
+export type OasisStore = Record<string, ServiceSection>;
+export declare function readStore(): OasisStore;
+export declare function updateStore<T>(mutator: (store: OasisStore) => T | Promise<T>): Promise<T>;
+export declare function loadCreds(serviceKey: string): Record<string, string> | null;
+export declare function saveCreds(serviceKey: string, creds: Record<string, string>): Promise<void>;
+export declare function removeCreds(serviceKey: string): Promise<void>;
+export declare function loadSection<T extends ServiceSection>(serviceKey: string): T;
+export declare function saveSection<T extends ServiceSection>(serviceKey: string, mutator: (section: T) => T | void): Promise<void>;

package/dist/src/storage.js

@@ -0,0 +1,88 @@
+/**
+ * Single owner of ~/.oasis.json. All reads/writes for creds and
+ * service-specific sections (sqlcl.connections, etc.) go through here.
+ *
+ * Guarantees:
+ *   - Atomic writes: write to a sibling `.tmp` then rename.
+ *   - In-process mutex: concurrent updateStore() calls serialize, so two
+ *     callers can't lose each other's writes within the same process.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const OASIS_FILE = path.join(os.homedir(), ".oasis.json");
+// ─── Atomic I/O ────────────────────────────────────────────────────
+function readStoreRaw() {
+    try {
+        const data = JSON.parse(fs.readFileSync(OASIS_FILE, "utf-8"));
+        if (data && typeof data === "object")
+            return data;
+    }
+    catch {
+        /* unreadable or missing file — start from an empty store */
+    }
+    return {};
+}
+function writeStoreRaw(store) {
+    const tmp = OASIS_FILE + ".tmp";
+    fs.writeFileSync(tmp, JSON.stringify(store, null, 2));
+    fs.renameSync(tmp, OASIS_FILE);
+}
+// In-process serializer. Each update() waits for the previous promise to
+// settle before reading -> mutating -> writing. Fine for localhost single
+// node; doesn't protect against cross-process races (acceptable — dashboard
+// API and MCP handlers live in the same node process).
+let chain = Promise.resolve();
+export function readStore() {
+    return readStoreRaw();
+}
+export function updateStore(mutator) {
+    const next = chain.then(async () => {
+        const store = readStoreRaw();
+        const result = await mutator(store);
+        writeStoreRaw(store);
+        return result;
+    });
+    chain = next.catch(() => { }); // don't let a failed mutator break the chain
+    return next;
+}
+// ─── Typed section helpers ─────────────────────────────────────────
+export function loadCreds(serviceKey) {
+    const section = readStoreRaw()[serviceKey];
+    return section?.creds ?? null;
+}
+export function saveCreds(serviceKey, creds) {
+    return updateStore(store => {
+        store[serviceKey] = { ...store[serviceKey], creds };
+    });
+}
+export function removeCreds(serviceKey) {
+    return updateStore(store => {
+        if (!store[serviceKey])
+            return;
+        delete store[serviceKey].creds;
+        // Legacy: older versions of the server persisted OAuth tokens here.
+        // Clean them out on logout so the file doesn't carry dead state forward.
+        delete store[serviceKey].tokens;
+        if (Object.keys(store[serviceKey]).length === 0)
+            delete store[serviceKey];
+    });
+}
+// Generic section I/O — used by sqlcl for its `connections` / `active` keys
+// and by any future service with custom schema.
+export function loadSection(serviceKey) {
+    return readStoreRaw()[serviceKey] ?? {};
+}
+export function saveSection(serviceKey, mutator) {
+    return updateStore(store => {
+        const current = (store[serviceKey] ?? {});
+        const updated = mutator(current) ?? current;
+        if (updated === null || (typeof updated === "object" && Object.keys(updated).length === 0)) {
+            delete store[serviceKey];
+        }
+        else {
+            store[serviceKey] = updated;
+        }
+    });
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/storage.js.map

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

package/dist/src/toon.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimal TOON (Token-Oriented Object Notation) encoder.
+ *
+ * TOON is the stdout format for AXI CLIs — ~40% fewer tokens than JSON while
+ * staying readable by agents. See https://toonformat.dev/reference/spec.html.
+ *
+ * Keep all internal logic on plain JS objects; call `encode()` only at the
+ * output boundary. This encoder covers the shapes an AXI CLI actually emits:
+ *
+ *   - objects            key: value
+ *   - nested objects     key:\n  child: value
+ *   - tabular arrays      key[N]{f1,f2}:\n  a,b\n  c,d
+ *   - primitive arrays    key[N]: a,b,c
+ *   - empty arrays        key[0]:
+ *
+ * Two-space indentation, no tabs, no trailing newline (§12).
+ */
+/** Encode a JS value to a TOON document (no trailing newline). */
+export declare function encode(value: unknown): string;

package/dist/src/toon.js

@@ -0,0 +1,148 @@
+/**
+ * Minimal TOON (Token-Oriented Object Notation) encoder.
+ *
+ * TOON is the stdout format for AXI CLIs — ~40% fewer tokens than JSON while
+ * staying readable by agents. See https://toonformat.dev/reference/spec.html.
+ *
+ * Keep all internal logic on plain JS objects; call `encode()` only at the
+ * output boundary. This encoder covers the shapes an AXI CLI actually emits:
+ *
+ *   - objects            key: value
+ *   - nested objects     key:\n  child: value
+ *   - tabular arrays      key[N]{f1,f2}:\n  a,b\n  c,d
+ *   - primitive arrays    key[N]: a,b,c
+ *   - empty arrays        key[0]:
+ *
+ * Two-space indentation, no tabs, no trailing newline (§12).
+ */
+const INDENT = "  ";
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isScalar(v) {
+    return v === null || v === undefined || ["string", "number", "boolean"].includes(typeof v);
+}
+// §7.2 — a string MUST be quoted when it would otherwise be ambiguous with a
+// structural token, a literal (true/false/null), or a number. We also quote on
+// the comma delimiter so the same formatter is safe inside tabular rows.
+const NUMERIC_LIKE = /^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/i;
+const NEEDS_QUOTE = /[:"\\[\]{},]/;
+function hasControlChar(s) {
+    for (let i = 0; i < s.length; i++) {
+        if (s.charCodeAt(i) <= 0x1f)
+            return true;
+    }
+    return false;
+}
+function quoteString(s) {
+    const needs = s.length === 0 ||
+        s !== s.trim() ||
+        s === "true" ||
+        s === "false" ||
+        s === "null" ||
+        NUMERIC_LIKE.test(s) ||
+        NEEDS_QUOTE.test(s) ||
+        hasControlChar(s);
+    if (!needs)
+        return s;
+    const escaped = s
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+    return `"${escaped}"`;
+}
+function formatScalar(v) {
+    if (v === null || v === undefined)
+        return "null";
+    if (typeof v === "boolean")
+        return v ? "true" : "false";
+    if (typeof v === "number") {
+        if (!Number.isFinite(v))
+            return "null";
+        return Object.is(v, -0) ? "0" : String(v);
+    }
+    if (typeof v === "string")
+        return quoteString(v);
+    // Non-scalar leaked into a scalar slot — stringify defensively rather than throw.
+    return quoteString(JSON.stringify(v));
+}
+function tableFields(arr) {
+    // Tabular form is only valid when every row is a flat object (scalar values)
+    // sharing the first row's key set. Otherwise fall back to a list.
+    const fields = Object.keys(arr[0]);
+    if (fields.length === 0)
+        return null;
+    for (const row of arr) {
+        const keys = Object.keys(row);
+        if (keys.length !== fields.length || !fields.every(f => f in row))
+            return null;
+        if (!fields.every(f => isScalar(row[f])))
+            return null;
+    }
+    return fields;
+}
+function emitArray(key, arr, depth, lines) {
+    const pad = INDENT.repeat(depth);
+    if (arr.length === 0) {
+        lines.push(`${pad}${key}[0]:`);
+        return;
+    }
+    if (arr.every(isScalar)) {
+        lines.push(`${pad}${key}[${arr.length}]: ${arr.map(formatScalar).join(",")}`);
+        return;
+    }
+    if (arr.every(isPlainObject)) {
+        const rows = arr;
+        const fields = tableFields(rows);
+        if (fields) {
+            lines.push(`${pad}${key}[${arr.length}]{${fields.join(",")}}:`);
+            for (const row of rows) {
+                lines.push(`${INDENT.repeat(depth + 1)}${fields.map(f => formatScalar(row[f])).join(",")}`);
+            }
+            return;
+        }
+        // Non-uniform / nested objects → list of blocks.
+        lines.push(`${pad}${key}[${arr.length}]:`);
+        for (const row of rows) {
+            lines.push(`${INDENT.repeat(depth + 1)}-`);
+            emitObject(row, depth + 2, lines);
+        }
+        return;
+    }
+    // Mixed array — stringify each element as a scalar.
+    lines.push(`${pad}${key}[${arr.length}]: ${arr.map(formatScalar).join(",")}`);
+}
+function emitObject(obj, depth, lines) {
+    const pad = INDENT.repeat(depth);
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            emitArray(key, value, depth, lines);
+        }
+        else if (isPlainObject(value)) {
+            lines.push(`${pad}${key}:`);
+            emitObject(value, depth + 1, lines);
+        }
+        else {
+            lines.push(`${pad}${key}: ${formatScalar(value)}`);
+        }
+    }
+}
+/** Encode a JS value to a TOON document (no trailing newline). */
+export function encode(value) {
+    const lines = [];
+    if (Array.isArray(value)) {
+        // Root array: emit with an empty key so the header is a bare `[N]{...}:`.
+        emitArray("", value, 0, lines);
+        return lines.join("\n");
+    }
+    if (isPlainObject(value)) {
+        emitObject(value, 0, lines);
+        return lines.join("\n");
+    }
+    return formatScalar(value);
+}
+//# sourceMappingURL=toon.js.map

package/dist/src/toon.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@oasissys/sqlcl-cli",
+  "version": "0.1.2",
+  "packageManager": "pnpm@11.9.0",
+  "description": "oasis-sqlcl — AXI CLI for Oracle SQLcl on the Oasis databases: manage connections and run SQL with token-efficient TOON output",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oasissys/sqlcl-cli.git"
+  },
+  "keywords": [
+    "sqlcl",
+    "oracle",
+    "sql",
+    "cli",
+    "agent",
+    "axi",
+    "toon",
+    "oasis"
+  ],
+  "bin": {
+    "oasis-sqlcl": "./dist/bin/oasis-sqlcl.js"
+  },
+  "files": [
+    "dist",
+    "skills/sqlcl-cli",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:skill": "tsx scripts/build-skill.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "dev": "tsx bin/oasis-sqlcl.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}