@palmyr/cli 1.0.0

package/dist/config.js

@@ -0,0 +1,183 @@
+/**
+ * Palmyr local config + data management
+ * Everything lives in ~/.palmyr/
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, unlinkSync, statSync, renameSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const HOME = join(homedir(), '.palmyr');
+// One-time migration: rename legacy ~/.agentos/ → ~/.palmyr/ on first run after rebrand.
+const LEGACY_HOME = join(homedir(), '.agentos');
+if (existsSync(LEGACY_HOME) && !existsSync(HOME)) {
+    try {
+        renameSync(LEGACY_HOME, HOME);
+        process.stderr.write(`migrated config dir: ${LEGACY_HOME} → ${HOME}\n`);
+    }
+    catch (e) {
+        process.stderr.write(`warning: could not migrate ${LEGACY_HOME} → ${HOME}: ${e.message}\n`);
+    }
+}
+// Directory structure
+const DIRS = {
+    root: HOME,
+    data: join(HOME, 'data'),
+    logs: join(HOME, 'logs'),
+    drafts: join(HOME, 'drafts'),
+    memory: join(HOME, 'memory'),
+};
+const LOG_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+export function ensureDirs() {
+    for (const dir of Object.values(DIRS)) {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+    }
+    // Prune log files older than 30 days
+    try {
+        const now = Date.now();
+        for (const f of readdirSync(DIRS.logs).filter(f => f.endsWith('.log'))) {
+            const fpath = join(DIRS.logs, f);
+            if (now - statSync(fpath).mtimeMs > LOG_MAX_AGE_MS) {
+                unlinkSync(fpath);
+            }
+        }
+    }
+    catch { }
+}
+const CONFIG_PATH = join(HOME, 'config.json');
+const DEFAULT_CONFIG = {
+    api: 'https://palmyr.ai',
+    wallets: {},
+    defaultChain: 'solana',
+};
+export function loadConfig() {
+    if (!existsSync(CONFIG_PATH))
+        return DEFAULT_CONFIG;
+    try {
+        const raw = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+        // Migrate legacy single-keyfile config
+        if (raw.keyfile && !raw.wallets) {
+            const chain = raw.chain || 'solana';
+            raw.wallets = { [chain]: { keyfile: raw.keyfile } };
+            raw.defaultChain = chain;
+            delete raw.keyfile;
+            delete raw.chain;
+        }
+        return { ...DEFAULT_CONFIG, ...raw };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+export function saveConfig(config) {
+    ensureDirs();
+    writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+export function addWalletToConfig(chain, keyfile) {
+    const config = loadConfig();
+    if (!config.wallets)
+        config.wallets = {};
+    config.wallets[chain] = { keyfile: keyfile.replace(homedir(), '~') };
+    if (!config.setupDone)
+        config.defaultChain = chain;
+    config.setupDone = true;
+    saveConfig(config);
+}
+// ── Credentials ──
+export function getKeyfile(chain) {
+    const config = loadConfig();
+    const targetChain = chain || config.defaultChain || 'solana';
+    // Priority: env var > config wallet > default locations
+    if (process.env.PALMYR_KEYFILE)
+        return process.env.PALMYR_KEYFILE;
+    const walletConfig = config.wallets?.[targetChain];
+    if (walletConfig?.keyfile) {
+        const resolved = walletConfig.keyfile.replace('~', homedir());
+        if (existsSync(resolved))
+            return resolved;
+    }
+    // Default Solana location
+    if (targetChain === 'solana') {
+        const defaultSol = join(homedir(), '.config', 'solana', 'id.json');
+        if (existsSync(defaultSol))
+            return defaultSol;
+    }
+    return null;
+}
+export function loadKeypair(chain) {
+    const path = getKeyfile(chain);
+    if (!path)
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf8'));
+        return Uint8Array.from(data);
+    }
+    catch {
+        return null;
+    }
+}
+export function getConfiguredChains() {
+    const config = loadConfig();
+    return Object.keys(config.wallets || {});
+}
+// ── Data Store (small JSON files) ──
+function dataPath(file) { return join(DIRS.data, file); }
+export function getData(file) {
+    const p = dataPath(file);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function setData(file, data) {
+    ensureDirs();
+    writeFileSync(dataPath(file), JSON.stringify(data, null, 2));
+}
+// Helpers for common data
+export function getPhones() { return getData('phones.json') || []; }
+export function addPhone(phone) { const p = getPhones(); p.push(phone); setData('phones.json', p); }
+export function getInboxes() { return getData('inboxes.json') || []; }
+export function addInbox(inbox) { const i = getInboxes(); i.push(inbox); setData('inboxes.json', i); }
+export function getServers() { return getData('servers.json') || []; }
+export function addServer(server) { const s = getServers(); s.push(server); setData('servers.json', s); }
+export function getDomains() { return getData('domains.json') || []; }
+export function addDomain(domain) { const d = getDomains(); d.push(domain); setData('domains.json', d); }
+export function getAccounts() { return getData('accounts.json') || []; }
+export function addAccount(account) { const a = getAccounts(); a.push(account); setData('accounts.json', a); }
+// ── Drafts ──
+export function saveDraft(id, draft) {
+    ensureDirs();
+    writeFileSync(join(DIRS.drafts, `${id}.json`), JSON.stringify(draft, null, 2));
+}
+export function getDraft(id) {
+    const p = join(DIRS.drafts, `${id}.json`);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ── Memory ──
+export function addNote(note) {
+    ensureDirs();
+    const p = join(DIRS.memory, 'notes.md');
+    const existing = existsSync(p) ? readFileSync(p, 'utf8') : '';
+    const timestamp = new Date().toISOString();
+    writeFileSync(p, existing + `\n- [${timestamp}] ${note}`);
+}
+// ── Logging ──
+export function log(message) {
+    ensureDirs();
+    const date = new Date().toISOString().split('T')[0];
+    const p = join(DIRS.logs, `${date}.log`);
+    const existing = existsSync(p) ? readFileSync(p, 'utf8') : '';
+    const timestamp = new Date().toISOString();
+    writeFileSync(p, existing + `[${timestamp}] ${message}\n`);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/credential-store.d.ts

@@ -0,0 +1,4 @@
+export declare function isCredentialStoreAvailable(): boolean;
+export declare function storeSecret(account: string, secret: string): void;
+export declare function retrieveSecret(account: string): string | null;
+export declare function deleteSecret(account: string): void;

package/dist/credential-store.js

@@ -0,0 +1,180 @@
+/**
+ * OS credential store — CLI-side module for protecting wallet session secrets.
+ *
+ * Windows: DPAPI via PowerShell (encrypted blob at ~/.palmyr/secrets/<id>.dpapi)
+ * macOS:   Keychain via `security` CLI
+ * Linux:   Secret Service via `secret-tool` CLI
+ *
+ * Security: All inputs are validated as hex-only before use. All OS commands
+ * use execFileSync/spawnSync with argument arrays — never shell interpolation.
+ */
+import { execFileSync, spawnSync } from 'child_process';
+import { existsSync, mkdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const SECRETS_DIR = join(homedir(), '.palmyr', 'secrets');
+const SERVICE = 'palmyr-wallet';
+const HEX_RE = /^[0-9a-f]+$/i;
+function ensureSecretsDir() {
+    if (!existsSync(SECRETS_DIR))
+        mkdirSync(SECRETS_DIR, { recursive: true });
+}
+function dpapiPath(account) {
+    return join(SECRETS_DIR, `${account}.dpapi`);
+}
+function assertHex(value, label) {
+    if (!value || !HEX_RE.test(value)) {
+        throw new Error(`${label} must be a non-empty hex string, got: ${typeof value === 'string' ? value.slice(0, 20) : typeof value}`);
+    }
+}
+function platform() {
+    const p = process.platform;
+    if (p === 'win32' || p === 'darwin')
+        return p;
+    return 'linux';
+}
+// ─── Windows (DPAPI) ───
+function storeWindows(account, secret) {
+    ensureSecretsDir();
+    const outPath = dpapiPath(account);
+    const script = [
+        'Add-Type -AssemblyName System.Security',
+        `$bytes = [System.Text.Encoding]::UTF8.GetBytes('${secret}')`,
+        '$enc = [System.Security.Cryptography.ProtectedData]::Protect($bytes, $null, [System.Security.Cryptography.DataProtectionScope]::CurrentUser)',
+        `[System.IO.File]::WriteAllBytes('${outPath.replace(/\\/g, '\\\\')}', $enc)`,
+    ].join('; ');
+    execFileSync('powershell.exe', ['-NoProfile', '-Command', script], { stdio: 'ignore', timeout: 10000 });
+}
+function retrieveWindows(account) {
+    const fpath = dpapiPath(account);
+    if (!existsSync(fpath))
+        return null;
+    const script = [
+        'Add-Type -AssemblyName System.Security',
+        `$enc = [System.IO.File]::ReadAllBytes('${fpath.replace(/\\/g, '\\\\')}')`,
+        '$dec = [System.Security.Cryptography.ProtectedData]::Unprotect($enc, $null, [System.Security.Cryptography.DataProtectionScope]::CurrentUser)',
+        '[System.Text.Encoding]::UTF8.GetString($dec)',
+    ].join('; ');
+    try {
+        return execFileSync('powershell.exe', ['-NoProfile', '-Command', script], { encoding: 'utf8', timeout: 10000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function deleteWindows(account) {
+    const fpath = dpapiPath(account);
+    if (existsSync(fpath))
+        unlinkSync(fpath);
+}
+// ─── macOS (Keychain) ───
+function storeMac(account, secret) {
+    try {
+        execFileSync('security', ['delete-generic-password', '-s', SERVICE, '-a', account], { stdio: 'ignore' });
+    }
+    catch { }
+    execFileSync('security', ['add-generic-password', '-s', SERVICE, '-a', account, '-w', secret], { stdio: 'ignore', timeout: 5000 });
+}
+function retrieveMac(account) {
+    try {
+        return execFileSync('security', ['find-generic-password', '-s', SERVICE, '-a', account, '-w'], { encoding: 'utf8', timeout: 5000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function deleteMac(account) {
+    try {
+        execFileSync('security', ['delete-generic-password', '-s', SERVICE, '-a', account], { stdio: 'ignore' });
+    }
+    catch { }
+}
+// ─── Linux (secret-tool) ───
+function storeLinux(account, secret) {
+    const result = spawnSync('secret-tool', ['store', `--label=${SERVICE}`, 'service', SERVICE, 'account', account], {
+        input: secret,
+        stdio: ['pipe', 'ignore', 'ignore'],
+        timeout: 5000,
+    });
+    if (result.status !== 0) {
+        throw new Error(`secret-tool store failed with exit code ${result.status}`);
+    }
+}
+function retrieveLinux(account) {
+    try {
+        return execFileSync('secret-tool', ['lookup', 'service', SERVICE, 'account', account], { encoding: 'utf8', timeout: 5000 }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function deleteLinux(account) {
+    try {
+        execFileSync('secret-tool', ['clear', 'service', SERVICE, 'account', account], { stdio: 'ignore' });
+    }
+    catch { }
+}
+// ─── Public API ───
+export function isCredentialStoreAvailable() {
+    const p = platform();
+    try {
+        if (p === 'win32') {
+            execFileSync('powershell.exe', ['-NoProfile', '-Command', 'Add-Type -AssemblyName System.Security'], { stdio: 'ignore', timeout: 5000 });
+            return true;
+        }
+        if (p === 'darwin') {
+            execFileSync('which', ['security'], { stdio: 'ignore', timeout: 2000 });
+            return true;
+        }
+        execFileSync('which', ['secret-tool'], { stdio: 'ignore', timeout: 2000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function storeSecret(account, secret) {
+    assertHex(account, 'account');
+    assertHex(secret, 'secret');
+    const p = platform();
+    try {
+        if (p === 'win32')
+            return storeWindows(account, secret);
+        if (p === 'darwin')
+            return storeMac(account, secret);
+        return storeLinux(account, secret);
+    }
+    catch (err) {
+        throw new Error(`Failed to store secret in OS credential store (${p}): ${err.message}. ` +
+            `Your wallet key cannot be stored securely. On Windows, ensure PowerShell and DPAPI are available. ` +
+            `On macOS, ensure the 'security' command works. On Linux, install 'secret-tool'.`);
+    }
+}
+export function retrieveSecret(account) {
+    assertHex(account, 'account');
+    const p = platform();
+    try {
+        if (p === 'win32')
+            return retrieveWindows(account);
+        if (p === 'darwin')
+            return retrieveMac(account);
+        return retrieveLinux(account);
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteSecret(account) {
+    assertHex(account, 'account');
+    const p = platform();
+    try {
+        if (p === 'win32')
+            deleteWindows(account);
+        else if (p === 'darwin')
+            deleteMac(account);
+        else
+            deleteLinux(account);
+    }
+    catch { }
+}
+//# sourceMappingURL=credential-store.js.map

package/dist/credential-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../credential-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;AACzD,MAAM,OAAO,GAAG,eAAe,CAAA;AAC/B,MAAM,MAAM,GAAG,cAAc,CAAA;AAE7B,SAAS,gBAAgB;IACvB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,QAAQ,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,KAAa;IAC7C,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yCAAyC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAA;IACnI,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAA;IAC1B,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAA;IAC7C,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,0BAA0B;AAE1B,SAAS,YAAY,CAAC,OAAe,EAAE,MAAc;IACnD,gBAAgB,EAAE,CAAA;IAClB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG;QACb,wCAAwC;QACxC,mDAAmD,MAAM,IAAI;QAC7D,8IAA8I;QAC9I,oCAAoC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU;KAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,YAAY,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;AACzG,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAChC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnC,MAAM,MAAM,GAAG;QACb,wCAAwC;QACxC,0CAA0C,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI;QAC1E,8IAA8I;QAC9I,8CAA8C;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACZ,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACxH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IAChC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAED,2BAA2B;AAE3B,SAAS,QAAQ,CAAC,OAAe,EAAE,MAAc;IAC/C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,CAAC,yBAAyB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,YAAY,CAAC,UAAU,EAAE,CAAC,sBAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AACpI,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,UAAU,EAAE,CAAC,uBAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,CAAC,yBAAyB,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC;AAED,8BAA8B;AAE9B,SAAS,UAAU,CAAC,OAAe,EAAE,MAAc;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;QAC/G,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACnC,OAAO,EAAE,IAAI;KACd,CAAC,CAAA;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACpI,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,IAAI,CAAC;QACH,YAAY,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrG,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC;AAED,qBAAqB;AAErB,MAAM,UAAU,0BAA0B;IACxC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAClB,YAAY,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,wCAAwC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YACxI,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnB,YAAY,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YACvE,OAAO,IAAI,CAAA;QACb,CAAC;QACD,YAAY,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1E,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAc;IACzD,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC7B,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC3B,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACvD,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACpD,OAAO,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,kDAAkD,CAAC,MAAM,GAAG,CAAC,OAAO,IAAI;YACxE,oGAAoG;YACpG,iFAAiF,CAClF,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC7B,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAA;QAClD,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAA;QAC/C,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC7B,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAA;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,OAAO;YAAE,aAAa,CAAC,OAAO,CAAC,CAAA;aACpC,IAAI,CAAC,KAAK,QAAQ;YAAE,SAAS,CAAC,OAAO,CAAC,CAAA;;YACtC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;AACZ,CAAC"}

package/dist/mascot-data.d.ts

@@ -0,0 +1 @@
+export declare const MASCOT_STIPPLE: string[];

package/dist/mascot-data.js

@@ -0,0 +1,14 @@
+// Braille mascot: clean round eyes (no dots), original cheeky smile kept
+export const MASCOT_STIPPLE = [
+    "⠀⠀⠀⢀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⣀⡀⠀⠀⠀",
+    "⠀⠀⣼⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀⠀",
+    "⠀⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⠀",
+    "⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀",
+    "⠀⣿⣿⣿⣿⠀⠀⠀⣿⣿⣿⣿⠀⠀⠀⣿⣿⣿⣿⠀",
+    "⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀",
+    "⠀⣿⣿⣿⣿⣿⡿⢻⣿⣿⣿⣿⡟⢿⣿⣿⣿⣿⣿⠀",
+    "⠀⣿⣿⣿⣿⣿⣿⣧⣍⣛⣛⣩⣼⣿⣿⣿⣿⣿⣿⠀",
+    "⠀⢉⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡉⠀",
+    "⠀⠀⠘⠻⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠿⠟⠃⠀⠀",
+];
+//# sourceMappingURL=mascot-data.js.map

package/dist/mascot-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mascot-data.js","sourceRoot":"","sources":["../mascot-data.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAa;IACtC,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;CACvB,CAAC"}

package/dist/pay.d.ts

@@ -0,0 +1,60 @@
+/**
+ * x402 payment handler for Palmyr CLI
+ * Supports both Solana (SPL USDC transfer) and Base/EVM (EIP-3009 TransferWithAuthorization).
+ * Both flows are gasless: the server/facilitator absorbs chain fees.
+ */
+/**
+ * A single PaymentRequirements entry from the 402 response (one per chain).
+ * Keeps the full server-supplied object so it can be echoed back verbatim
+ * in the PaymentPayload's `accepted` field — the canonical x402 v2 client
+ * (`@x402/core/client/createPaymentPayload`) and the CDP facilitator's zod
+ * validators both reject a stubbed `{ scheme, network }`.
+ */
+interface PaymentOption {
+    amount: bigint;
+    payTo: string;
+    feePayer: string;
+    asset: string;
+    network: string;
+    /** Full PaymentRequirements object — echo this into `paymentPayload.accepted`. */
+    requirements: Record<string, any>;
+}
+/**
+ * Parse a 402 response. Returns available payment options by chain plus the
+ * top-level `resource` block so callers can echo it into the PaymentPayload.
+ */
+export declare function parsePaymentRequired(data: any): {
+    solana: PaymentOption | null;
+    base: PaymentOption | null;
+    resource: any;
+    extensions: any;
+};
+/**
+ * Build and partially sign a USDC transfer transaction for x402 payment.
+ * Uses raw keypair for transaction building (needed for multi-instruction Solana txs).
+ */
+export declare function buildPaymentTransaction(payTo: string, amount: bigint, feePayer: string, walletId?: string, passphrase?: string): Promise<{
+    transaction: string;
+    payer: string;
+} | null>;
+/**
+ * Like paidRequest, but returns the raw Response from the final paid call
+ * so the caller can consume a streaming body (e.g. text/event-stream for i402).
+ *
+ * The probe request is always issued without a payment header to elicit the
+ * server's 402 with proper payment-required metadata — this lets the server
+ * advertise the exact amount due (critical for i402 /chat/:id/execute which
+ * charges plan.total_cost_usdc rather than a fixed fee).
+ */
+export declare function paidStreamRequest(api: string, method: string, path: string, body?: Record<string, unknown>, passphrase?: string): Promise<{
+    response: Response;
+    paid: boolean;
+    amountUsdc: number;
+    payer?: string;
+}>;
+export declare function paidRequest(api: string, method: string, path: string, body?: Record<string, unknown>, passphrase?: string, attempt?: number): Promise<{
+    data: any;
+    paid: boolean;
+    txHash?: string;
+}>;
+export {};