@dopemarkets/agent 0.1.0

package/dist/credentials.js

@@ -0,0 +1,133 @@
+"use strict";
+// Local credential storage for `dope`.
+//
+// Stores the Agent Key in ~/.dope/credentials.json with 0600 permissions.
+// Multi-credential support — keyed by `name` (e.g. "default", "claude").
+// Default credential is whichever was most recently `dope login`-ed.
+//
+// Note: the spec recommends OS-native secret storage (macOS Keychain /
+// Linux Secret Service / Windows Credential Manager). File-based is the
+// MVP because `keytar`-style native bindings cause install headaches.
+// A future module can transparently upgrade to keychain while keeping
+// this API surface stable.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.credentialsPath = void 0;
+exports.saveCredential = saveCredential;
+exports.loadCredential = loadCredential;
+exports.listCredentials = listCredentials;
+exports.deleteCredential = deleteCredential;
+exports.setDefaultCredential = setDefaultCredential;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const CREDENTIALS_DIR = path.join(os.homedir(), '.dope');
+const CREDENTIALS_FILE = path.join(CREDENTIALS_DIR, 'credentials.json');
+const FILE_MODE = 0o600;
+const DIR_MODE = 0o700;
+const EMPTY_FILE = {
+    version: 1,
+    default_name: null,
+    credentials: {},
+};
+function readFileOrEmpty() {
+    if (!fs.existsSync(CREDENTIALS_FILE))
+        return { ...EMPTY_FILE };
+    try {
+        const raw = fs.readFileSync(CREDENTIALS_FILE, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed.version !== 1) {
+            throw new Error(`credential file version ${parsed.version} is not supported`);
+        }
+        return parsed;
+    }
+    catch (err) {
+        throw new Error(`failed to read ${CREDENTIALS_FILE}: ${err.message}. Run \`dope login\` to recreate.`);
+    }
+}
+function writeFile(data) {
+    if (!fs.existsSync(CREDENTIALS_DIR)) {
+        fs.mkdirSync(CREDENTIALS_DIR, { mode: DIR_MODE, recursive: true });
+    }
+    const tmp = CREDENTIALS_FILE + '.tmp';
+    fs.writeFileSync(tmp, JSON.stringify(data, null, 2), { mode: FILE_MODE });
+    fs.renameSync(tmp, CREDENTIALS_FILE);
+    // Re-assert mode in case the umask softened it.
+    fs.chmodSync(CREDENTIALS_FILE, FILE_MODE);
+}
+function saveCredential(cred, { makeDefault = true } = {}) {
+    const file = readFileOrEmpty();
+    file.credentials[cred.name] = cred;
+    if (makeDefault || !file.default_name) {
+        file.default_name = cred.name;
+    }
+    writeFile(file);
+}
+function loadCredential(name) {
+    const file = readFileOrEmpty();
+    const key = name ?? file.default_name;
+    if (!key)
+        return null;
+    return file.credentials[key] ?? null;
+}
+function listCredentials() {
+    const file = readFileOrEmpty();
+    return {
+        default_name: file.default_name,
+        credentials: Object.values(file.credentials),
+    };
+}
+function deleteCredential(name) {
+    const file = readFileOrEmpty();
+    if (!file.credentials[name])
+        return false;
+    delete file.credentials[name];
+    if (file.default_name === name) {
+        const remaining = Object.keys(file.credentials);
+        file.default_name = remaining[0] ?? null;
+    }
+    writeFile(file);
+    return true;
+}
+function setDefaultCredential(name) {
+    const file = readFileOrEmpty();
+    if (!file.credentials[name])
+        return false;
+    file.default_name = name;
+    writeFile(file);
+    return true;
+}
+exports.credentialsPath = CREDENTIALS_FILE;
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { parseArgs } from './util.js';
+export { parseArgs };

package/dist/index.js

@@ -0,0 +1,160 @@
+"use strict";
+// `dope` CLI dispatcher.
+//
+// Each command lives in src/commands/<name>.ts. This file handles
+// argv-level routing and the --json flag.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = void 0;
+const util_js_1 = require("./util.js");
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return util_js_1.parseArgs; } });
+const output_js_1 = require("./output.js");
+const login_js_1 = require("./commands/login.js");
+const whoami_js_1 = require("./commands/whoami.js");
+const balance_js_1 = require("./commands/balance.js");
+const markets_js_1 = require("./commands/markets.js");
+const stack_js_1 = require("./commands/stack.js");
+const agent_key_js_1 = require("./commands/agent_key.js");
+const mcp_js_1 = require("./commands/mcp.js");
+const VERSION = '0.1.0';
+const HELP = `dope — DOPE Agent Mode CLI (v${VERSION})
+
+Usage:
+  dope <command> [args] [--json]
+
+Authentication:
+  dope login                           Authorize a new Agent Key on this machine.
+                                         --name <label>       e.g. "Claude Desktop" (default: "default")
+                                         --max-premium <usd>
+                                         --daily-limit <usd>
+                                         --max-payout <usd>
+                                         --expires <days>     1..90 (default 7)
+                                         --quote-only         skip activate:stack permission
+                                         --no-browser         don't auto-open the URL
+                                         --base-url <url>     override DOPE backend
+  dope whoami                          Current Agent Key identity, permissions, limits.
+
+Account:
+  dope balance                         USDC balance breakdown.
+
+Markets:
+  dope markets search [query]          Search eligible prediction markets.
+                                         --category <name>
+                                         --min-liquidity <usdc>
+                                         --closes-before <iso>
+                                         --closes-after <iso>
+                                         --limit <n>
+  dope markets show <market_id>        Full market detail.
+
+Stacks:
+  dope stack list                      Your Stacks. --status active|pending|resolved|failed|all
+  dope stack show <stack_id>           Full Stack detail with legs.
+  dope stack candidates                Server-side candidate generator.
+                                         --target-min <X>
+                                         --target-max <Y>
+                                         --max-premium <usdc>
+                                         --categories crypto,macro
+                                         --legs-min 2  --legs-max 4
+                                         --limit 5
+  dope stack quote                     Get a binding quote.
+                                         --legs <market_id:YES,market_id:NO>
+                                         --premium <usdc>
+  dope stack activate <quote_id>       Activate a quoted Stack. Signs via Turnkey.
+                                         --idempotency-key <key>  (auto-generated otherwise)
+
+Agent Keys:
+  dope agent-key list                  Your Agent Keys.
+  dope agent-key revoke <id>           Revoke. DOPE-side immediate.
+  dope agent-key create                Equivalent to \`dope login\`.
+
+MCP (Phase 5, not yet implemented):
+  dope mcp install
+  dope mcp start
+  dope mcp status
+
+Global flags:
+  --json                               Structured output. Required for agent use.
+  --help                               Show this message.
+  --version                            Print version.
+
+Environment:
+  DOPE_BASE_URL                        Default backend URL for \`dope login\`.
+`;
+async function main() {
+    const rawArgs = process.argv.slice(2);
+    if (rawArgs.length === 0 || rawArgs[0] === '--help' || rawArgs[0] === '-h' || rawArgs[0] === 'help') {
+        (0, output_js_1.printHuman)(HELP);
+        process.exit(0);
+    }
+    if (rawArgs[0] === '--version' || rawArgs[0] === '-v') {
+        (0, output_js_1.printHuman)(VERSION);
+        process.exit(0);
+    }
+    // Strip --json early so each command sees a consistent rest[].
+    const jsonIdx = rawArgs.indexOf('--json');
+    const json = jsonIdx !== -1;
+    if (jsonIdx !== -1)
+        rawArgs.splice(jsonIdx, 1);
+    const out = { json };
+    // Two-part commands ("markets show", "stack activate") consume two
+    // positional tokens. One-part commands ("login", "balance") consume one.
+    const cmd = rawArgs[0];
+    const sub = rawArgs[1];
+    const rest = rawArgs.slice(2);
+    try {
+        switch (cmd) {
+            case 'login':
+                return await (0, login_js_1.runLogin)((0, login_js_1.parseLoginArgs)(rawArgs.slice(1)), out);
+            case 'whoami':
+                return await (0, whoami_js_1.runWhoami)(out);
+            case 'balance':
+                return await (0, balance_js_1.runBalance)(out);
+            case 'markets':
+                if (sub === 'search')
+                    return await (0, markets_js_1.runMarketsSearch)(rest, out);
+                if (sub === 'show')
+                    return await (0, markets_js_1.runMarketsShow)(rest, out);
+                return unknownSub(cmd, sub, out);
+            case 'stack':
+                if (sub === 'quote')
+                    return await (0, stack_js_1.runStackQuote)(rest, out);
+                if (sub === 'activate')
+                    return await (0, stack_js_1.runStackActivate)(rest, out);
+                if (sub === 'list')
+                    return await (0, stack_js_1.runStackList)(rest, out);
+                if (sub === 'show')
+                    return await (0, stack_js_1.runStackShow)(rest, out);
+                if (sub === 'candidates')
+                    return await (0, stack_js_1.runStackCandidates)(rest, out);
+                return unknownSub(cmd, sub, out);
+            case 'agent-key':
+            case 'agent_key':
+                if (sub === 'list')
+                    return await (0, agent_key_js_1.runAgentKeyList)(rest, out);
+                if (sub === 'revoke')
+                    return await (0, agent_key_js_1.runAgentKeyRevoke)(rest, out);
+                if (sub === 'create') {
+                    (0, agent_key_js_1.runAgentKeyCreateHint)(out);
+                    return;
+                }
+                return unknownSub(cmd, sub, out);
+            case 'mcp':
+                if (sub === 'install')
+                    return (0, mcp_js_1.runMcpInstall)(rest, out);
+                if (sub === 'start')
+                    return (0, mcp_js_1.runMcpStart)(rest, out);
+                if (sub === 'status')
+                    return (0, mcp_js_1.runMcpStatus)(rest, out);
+                return unknownSub(cmd, sub, out);
+            default:
+                return (0, output_js_1.emitError)(out, { error_code: 'INVALID_REQUEST', message: `Unknown command: ${cmd ?? '(none)'}` }, 2);
+        }
+    }
+    catch (err) {
+        (0, output_js_1.emitError)(out, { error_code: 'SERVICE_UNAVAILABLE', message: err.message ?? String(err) }, 1);
+    }
+}
+function unknownSub(cmd, sub, out) {
+    return (0, output_js_1.emitError)(out, { error_code: 'INVALID_REQUEST', message: `Unknown subcommand: ${cmd} ${sub ?? ''}`.trim() }, 2);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,17 @@
+export interface CliOutput {
+    /** True if --json was passed; commands emit structured output. */
+    json: boolean;
+}
+export declare function printJson(value: unknown): void;
+export declare function printHuman(text: string): void;
+export declare function emitOk(out: CliOutput, jsonBody: unknown, humanText: string | (() => string)): void;
+export interface CliError {
+    error_code: string;
+    message?: string;
+    details?: unknown;
+}
+export declare function emitError(out: CliOutput, err: CliError, exitCode?: number): never;
+/** Right-align a label/value row for human output. */
+export declare function row(label: string, value: string, labelWidth?: number): string;
+/** Format a USDC string (e.g. "20.00") with a $ prefix and 2 decimals. Pass-through if already prefixed. */
+export declare function usd(value: string | number | null | undefined): string;

package/dist/output.js

@@ -0,0 +1,51 @@
+"use strict";
+// Output formatting helpers.
+//
+// Every command supports two output modes:
+//   - human (default): concise, legible text
+//   - json   (--json): stable structured output for agents
+//
+// Errors return non-zero exit codes. Stable `error_code` fields are
+// always present in --json mode so agents can react programmatically.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printJson = printJson;
+exports.printHuman = printHuman;
+exports.emitOk = emitOk;
+exports.emitError = emitError;
+exports.row = row;
+exports.usd = usd;
+function printJson(value) {
+    process.stdout.write(JSON.stringify(value, null, 2) + '\n');
+}
+function printHuman(text) {
+    process.stdout.write(text + '\n');
+}
+function emitOk(out, jsonBody, humanText) {
+    if (out.json) {
+        printJson(jsonBody);
+    }
+    else {
+        printHuman(typeof humanText === 'function' ? humanText() : humanText);
+    }
+}
+function emitError(out, err, exitCode = 1) {
+    if (out.json) {
+        process.stdout.write(JSON.stringify({ ok: false, ...err }, null, 2) + '\n');
+    }
+    else {
+        process.stderr.write(`error: ${err.error_code}${err.message ? ' — ' + err.message : ''}\n`);
+    }
+    process.exit(exitCode);
+}
+/** Right-align a label/value row for human output. */
+function row(label, value, labelWidth = 14) {
+    return `${label.padEnd(labelWidth)} ${value}`;
+}
+/** Format a USDC string (e.g. "20.00") with a $ prefix and 2 decimals. Pass-through if already prefixed. */
+function usd(value) {
+    if (value == null)
+        return '—';
+    const s = typeof value === 'number' ? value.toFixed(2) : String(value);
+    return s.startsWith('$') ? s : `$${s}`;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,EAAE;AACF,2CAA2C;AAC3C,6CAA6C;AAC7C,2DAA2D;AAC3D,EAAE;AACF,oEAAoE;AACpE,sEAAsE;;AAOtE,8BAEC;AAED,gCAEC;AAED,wBAMC;AAQD,8BAOC;AAGD,kBAEC;AAGD,kBAIC;AAzCD,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,MAAM,CAAC,GAAc,EAAE,QAAiB,EAAE,SAAkC;IAC1F,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAQD,SAAgB,SAAS,CAAC,GAAc,EAAE,GAAa,EAAE,QAAQ,GAAG,CAAC;IACnE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,sDAAsD;AACtD,SAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,UAAU,GAAG,EAAE;IAC/D,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,EAAE,CAAC;AAChD,CAAC;AAED,4GAA4G;AAC5G,SAAgB,GAAG,CAAC,KAAyC;IAC3D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAC9B,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/util.d.ts

@@ -0,0 +1,17 @@
+/** Open a URL in the user's default browser. Returns true on success. */
+export declare function openInBrowser(url: string): boolean;
+/** Async sleep helper. */
+export declare function sleep(ms: number): Promise<void>;
+/** Pretty-print a Bytes-like number as KB/MB/GB. */
+export declare function formatBytes(n: number): string;
+export interface ParsedArgs {
+    positionals: string[];
+    flags: Record<string, string | true>;
+}
+/**
+ * Tiny argv parser. Supports --flag, --flag=value, --flag value, -f short.
+ * Positionals collected separately. No external dep.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/** Convert a flag-or-positional value to a string, throwing if missing. */
+export declare function required(value: unknown, fieldName: string): string;

package/dist/util.js

@@ -0,0 +1,106 @@
+"use strict";
+// Small CLI helpers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openInBrowser = openInBrowser;
+exports.sleep = sleep;
+exports.formatBytes = formatBytes;
+exports.parseArgs = parseArgs;
+exports.required = required;
+const node_child_process_1 = require("node:child_process");
+/** Open a URL in the user's default browser. Returns true on success. */
+function openInBrowser(url) {
+    const platform = process.platform;
+    let cmd;
+    let args;
+    if (platform === 'darwin') {
+        cmd = 'open';
+        args = [url];
+    }
+    else if (platform === 'win32') {
+        cmd = 'cmd';
+        args = ['/c', 'start', '""', url];
+    }
+    else {
+        cmd = 'xdg-open';
+        args = [url];
+    }
+    try {
+        const child = (0, node_child_process_1.spawn)(cmd, args, { stdio: 'ignore', detached: true });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Async sleep helper. */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Pretty-print a Bytes-like number as KB/MB/GB. */
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n} B`;
+    if (n < 1024 ** 2)
+        return `${(n / 1024).toFixed(1)} KB`;
+    if (n < 1024 ** 3)
+        return `${(n / 1024 ** 2).toFixed(1)} MB`;
+    return `${(n / 1024 ** 3).toFixed(1)} GB`;
+}
+/**
+ * Tiny argv parser. Supports --flag, --flag=value, --flag value, -f short.
+ * Positionals collected separately. No external dep.
+ */
+function parseArgs(argv) {
+    const positionals = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (typeof a !== 'string')
+            continue;
+        if (a === '--') {
+            positionals.push(...argv.slice(i + 1).filter((x) => typeof x === 'string'));
+            break;
+        }
+        if (a.startsWith('--')) {
+            const eq = a.indexOf('=');
+            if (eq !== -1) {
+                flags[a.slice(2, eq)] = a.slice(eq + 1);
+            }
+            else {
+                const name = a.slice(2);
+                const next = argv[i + 1];
+                if (typeof next === 'string' && !next.startsWith('-')) {
+                    flags[name] = next;
+                    i++;
+                }
+                else {
+                    flags[name] = true;
+                }
+            }
+        }
+        else if (a.startsWith('-') && a.length > 1) {
+            const name = a.slice(1);
+            const next = argv[i + 1];
+            if (typeof next === 'string' && !next.startsWith('-')) {
+                flags[name] = next;
+                i++;
+            }
+            else {
+                flags[name] = true;
+            }
+        }
+        else {
+            positionals.push(a);
+        }
+    }
+    return { positionals, flags };
+}
+/** Convert a flag-or-positional value to a string, throwing if missing. */
+function required(value, fieldName) {
+    if (typeof value !== 'string' || !value.length) {
+        throw new Error(`Missing required argument: ${fieldName}`);
+    }
+    return value;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@dopemarkets/agent",
+  "version": "0.1.0",
+  "description": "DOPE Agent Mode CLI. Run agentic Stack trades on DOPE from the terminal.",
+  "bin": {
+    "dope": "bin/dope.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "dev": "node --import tsx src/index.ts"
+  },
+  "dependencies": {
+    "@dopemarkets/agent-client": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}