publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/antigravity/storage.js

@@ -1,366 +1,12 @@
-// Storage commands for Antigravity:
-//   Renderer-side (4): storage-keys / storage-get / cookies / idb-list
-//   VSCode FS-side (4): state-keys / state-get / recent-paths / workspaces-list
-//   Settings (1):       settings-read
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as os from 'node:os';
-import { execFileSync } from 'node:child_process';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import {
-    ArgumentError,
-    CommandExecutionError,
-    EmptyResultError,
-} from '@jackwener/opencli/errors';
-import { unwrapEvaluateResult } from './_actions.js';
-
-const STORAGE_COLUMNS = [
-    'Index',
-    'Key',
-    'Bytes',
-    'Name',
-    'Preview',
-    'Database',
-    'Version',
-    'Kind',
-    'Path',
-    'Workspace Id',
-    'Folder',
-    'Modified',
-    'Field',
-    'Value',
-];
-
-// ====== Path helpers ======
-const AG_APP_SUPPORT = path.join(os.homedir(), 'Library/Application Support/Antigravity');
-const AG_USER_DIR = path.join(AG_APP_SUPPORT, 'User');
-const AG_GLOBAL_STATE_DB = path.join(AG_USER_DIR, 'globalStorage/state.vscdb');
-const AG_WORKSPACE_STORAGE = path.join(AG_USER_DIR, 'workspaceStorage');
-const AG_SETTINGS_JSON = path.join(AG_USER_DIR, 'settings.json');
-
-function sqliteQuery(db, sql) {
-    if (!fs.existsSync(db)) {
-        throw new CommandExecutionError(`state.vscdb not found: ${db}`, 'Has Antigravity been run at least once?');
-    }
-    try {
-        return execFileSync('/usr/bin/sqlite3', [db, sql], { encoding: 'utf-8', maxBuffer: 64 * 1024 * 1024 });
-    } catch (e) {
-        throw new CommandExecutionError(
-            `sqlite3 failed on ${path.basename(db)}: ${e.message}`,
-            'The DB may be locked by a running Antigravity instance. Try closing it or wait a few seconds.',
-        );
-    }
-}
-function listKeys(db) {
-    const out = sqliteQuery(db, 'SELECT key FROM ItemTable ORDER BY key;');
-    return out.split('\n').map((s) => s.trim()).filter(Boolean);
-}
-function getValue(db, key) {
-    const esc = key.replace(/'/g, "''");
-    const raw = sqliteQuery(db, `SELECT value FROM ItemTable WHERE key = '${esc}';`).trim();
-    if (!raw) return null;
-    try { return JSON.parse(raw); } catch { return raw; }
-}
-function resolveStateDb(args) {
-    const ws = args?.workspace ? String(args.workspace).trim() : '';
-    if (!ws) return AG_GLOBAL_STATE_DB;
-    const db = path.join(AG_WORKSPACE_STORAGE, ws, 'state.vscdb');
-    if (!fs.existsSync(db)) {
-        throw new CommandExecutionError(`Workspace state.vscdb not found: ${db}`, 'List workspace ids with `opencli antigravity workspaces-list`.');
-    }
-    return db;
-}
-
-// ====== Renderer-side: storage-keys ======
-cli({
-    site: 'antigravity',
-    name: 'storage-keys',
-    access: 'read',
-    description: 'List localStorage / sessionStorage keys on the Antigravity renderer (CDP).',
-    domain: '127.0.0.1',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'storage', required: false, default: 'local', help: '"local" or "session"' },
-        { name: 'filter', required: false, help: 'Case-insensitive substring filter' },
-        { name: 'limit', type: 'int', required: false, default: 100, help: 'Max rows to return' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (page, kwargs) => {
-        const s = String(kwargs?.storage || 'local').trim().toLowerCase();
-        if (s !== 'local' && s !== 'session') throw new ArgumentError('storage', 'must be "local" or "session"');
-        const store = s === 'session' ? 'sessionStorage' : 'localStorage';
-        const raw = unwrapEvaluateResult(await page.evaluate(`(() => {
-      const s = ${store};
+import*as J from"node:fs";import*as q from"node:path";import*as b from"node:os";import{execFileSync as f}from"node:child_process";import{cli as B,Strategy as I}from"@jackwener/opencli/registry";import{ArgumentError as h,CommandExecutionError as D,EmptyResultError as K}from"@jackwener/opencli/errors";import{unwrapEvaluateResult as P}from"./_actions.js";const W=["Index","Key","Bytes","Name","Preview","Database","Version","Kind","Path","Workspace Id","Folder","Modified","Field","Value"],y=q.join(b.homedir(),"Library/Application Support/Antigravity"),L=q.join(y,"User"),x=q.join(L,"globalStorage/state.vscdb"),M=q.join(L,"workspaceStorage"),U=q.join(L,"settings.json");function v(H,z){if(!J.existsSync(H))throw new D(`state.vscdb not found: ${H}`,"Has Antigravity been run at least once?");try{return f("/usr/bin/sqlite3",[H,z],{encoding:"utf-8",maxBuffer:67108864})}catch(Z){throw new D(`sqlite3 failed on ${q.basename(H)}: ${Z.message}`,"The DB may be locked by a running Antigravity instance. Try closing it or wait a few seconds.")}}function G(H){return v(H,"SELECT key FROM ItemTable ORDER BY key;").split(`
+`).map((Z)=>Z.trim()).filter(Boolean)}function C(H,z){const Z=z.replace(/'/g,"''"),Y=v(H,`SELECT value FROM ItemTable WHERE key = '${Z}';`).trim();if(!Y)return null;try{return JSON.parse(Y)}catch{return Y}}function T(H){const z=H?.workspace?String(H.workspace).trim():"";if(!z)return x;const Z=q.join(M,z,"state.vscdb");if(!J.existsSync(Z))throw new D(`Workspace state.vscdb not found: ${Z}`,"List workspace ids with `opencli antigravity workspaces-list`.");return Z}B({site:"antigravity",name:"storage-keys",access:"read",description:"List localStorage / sessionStorage keys on the Antigravity renderer (CDP).",domain:"127.0.0.1",strategy:I.UI,browser:!0,args:[{name:"storage",required:!1,default:"local",help:'"local" or "session"'},{name:"filter",required:!1,help:"Case-insensitive substring filter"},{name:"limit",type:"int",required:!1,default:100,help:"Max rows to return"}],columns:W,func:async(H,z)=>{const Z=String(z?.storage||"local").trim().toLowerCase();if(Z!=="local"&&Z!=="session")throw new h("storage",'must be "local" or "session"');const Y=Z==="session"?"sessionStorage":"localStorage",X=P(await H.evaluate(`(() => {
+      const s = ${Y};
       const out = [];
       for (let i = 0; i < s.length; i++) {
         const k = s.key(i); const v = s.getItem(k) || '';
         out.push({ k, bytes: v.length });
       }
       return out;
-    })()`));
-        const flt = kwargs?.filter ? String(kwargs.filter).toLowerCase() : null;
-        const filtered = flt ? raw.filter((r) => r.k.toLowerCase().includes(flt)) : raw;
-        if (!filtered.length) throw new EmptyResultError('antigravity storage-keys', flt ? `No keys match "${flt}".` : `${store} is empty.`);
-        filtered.sort((a, b) => a.k.localeCompare(b.k));
-        const limit = Number.isInteger(kwargs?.limit) && kwargs.limit > 0 ? kwargs.limit : 100;
-        return filtered.slice(0, limit).map((r, i) => ({ Index: i + 1, Key: r.k, Bytes: r.bytes }));
-    },
-});
-
-// ====== Renderer-side: storage-get ======
-cli({
-    site: 'antigravity',
-    name: 'storage-get',
-    access: 'read',
-    description: 'Read a single localStorage / sessionStorage value on the Antigravity renderer.',
-    domain: '127.0.0.1',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'key', positional: true, required: true, help: 'Storage key name' },
-        { name: 'storage', required: false, default: 'local', help: '"local" or "session"' },
-        { name: 'max-bytes', type: 'int', required: false, default: 4000, help: 'Truncate value to this many chars' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (page, kwargs) => {
-        const key = String(kwargs?.key || '').trim();
-        if (!key) throw new ArgumentError('key', 'is required');
-        const s = String(kwargs?.storage || 'local').trim().toLowerCase();
-        const store = s === 'session' ? 'sessionStorage' : 'localStorage';
-        const raw = unwrapEvaluateResult(await page.evaluate(`${store}.getItem(${JSON.stringify(key)})`));
-        if (raw === null) throw new CommandExecutionError(`Key not found in ${store}: ${key}`, '');
-        const max = Number.isInteger(kwargs['max-bytes']) && kwargs['max-bytes'] > 0 ? kwargs['max-bytes'] : 4000;
-        let parsed = raw, kind = 'string';
-        try { parsed = JSON.parse(raw); kind = Array.isArray(parsed) ? 'array' : typeof parsed; } catch {}
-        const text = kind === 'string' ? parsed : JSON.stringify(parsed, null, 2);
-        const truncated = text.length > max;
-        return [
-            { Field: 'Key', Value: key },
-            { Field: 'Store', Value: store },
-            { Field: 'Type', Value: kind },
-            { Field: 'Size', Value: `${text.length} chars${truncated ? ' (truncated)' : ''}` },
-            { Field: 'Value', Value: truncated ? text.slice(0, max) + '\n...(truncated)' : text },
-        ];
-    },
-});
-
-// ====== Renderer-side: cookies ======
-cli({
-    site: 'antigravity',
-    name: 'cookies',
-    access: 'read',
-    description: 'List cookies on the Antigravity renderer (JS-visible via document.cookie).',
-    domain: '127.0.0.1',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    columns: STORAGE_COLUMNS,
-    func: async (page) => {
-        const raw = unwrapEvaluateResult(await page.evaluate('document.cookie'));
-        if (!raw) throw new EmptyResultError('antigravity cookies', 'document.cookie is empty.');
-        const cookies = raw.split('; ').map((pair) => {
-            const idx = pair.indexOf('=');
-            if (idx < 0) return { name: pair, value: '' };
-            return { name: pair.slice(0, idx), value: pair.slice(idx + 1) };
-        });
-        return cookies.map((c, i) => ({
-            Index: i + 1, Name: c.name, Bytes: c.value.length,
-            Preview: c.value.slice(0, 40) + (c.value.length > 40 ? '…' : ''),
-        }));
-    },
-});
-
-// ====== Renderer-side: idb-list ======
-cli({
-    site: 'antigravity',
-    name: 'idb-list',
-    access: 'read',
-    description: 'List IndexedDB databases on the Antigravity renderer.',
-    domain: '127.0.0.1',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [],
-    columns: STORAGE_COLUMNS,
-    func: async (page) => {
-        const dbs = unwrapEvaluateResult(await page.evaluate(`(async () => indexedDB.databases ? await indexedDB.databases() : [])()`));
-        if (!Array.isArray(dbs) || !dbs.length) throw new EmptyResultError('antigravity idb-list', 'No IndexedDB databases.');
-        return dbs.map((d, i) => ({ Index: i + 1, Database: d.name || '(unnamed)', Version: String(d.version || '') }));
-    },
-});
-
-// ====== FS-side: state-keys ======
-cli({
-    site: 'antigravity',
-    name: 'state-keys',
-    access: 'read',
-    description: 'List keys in Antigravity\'s globalStorage state.vscdb (VSCode-style). Pass --workspace <id> to query a per-workspace DB. Works while Antigravity is closed.',
-    domain: 'localhost',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [
-        { name: 'filter', required: false, help: 'Case-insensitive substring filter over keys' },
-        { name: 'workspace', required: false, help: 'Workspace id (from workspaces-list) to query per-workspace DB' },
-        { name: 'limit', type: 'int', required: false, default: 200, help: 'Max rows to return' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (args) => {
-        const db = resolveStateDb(args);
-        const keys = listKeys(db);
-        const flt = args?.filter ? String(args.filter).toLowerCase() : null;
-        const filtered = flt ? keys.filter((k) => k.toLowerCase().includes(flt)) : keys;
-        if (!filtered.length) throw new EmptyResultError('antigravity state-keys', flt ? `No keys match "${flt}".` : 'No keys.');
-        const limit = Number.isInteger(args?.limit) && args.limit > 0 ? args.limit : 200;
-        return filtered.slice(0, limit).map((k, i) => ({ Index: i + 1, Key: k }));
-    },
-});
-
-// ====== FS-side: state-get ======
-cli({
-    site: 'antigravity',
-    name: 'state-get',
-    access: 'read',
-    description: 'Read one value from Antigravity\'s state.vscdb. Pass --workspace <id> for per-workspace.',
-    domain: 'localhost',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [
-        { name: 'key', positional: true, required: true, help: 'Storage key name' },
-        { name: 'workspace', required: false, help: 'Workspace id (from workspaces-list) to query per-workspace DB' },
-        { name: 'max-bytes', type: 'int', required: false, default: 8000, help: 'Truncate value to this many chars' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (args) => {
-        const key = String(args?.key || '').trim();
-        if (!key) throw new ArgumentError('key', 'is required');
-        const db = resolveStateDb(args);
-        const val = getValue(db, key);
-        if (val === null) throw new CommandExecutionError(`Key not found: ${key}`, '');
-        const max = Number.isInteger(args['max-bytes']) && args['max-bytes'] > 0 ? args['max-bytes'] : 8000;
-        const valStr = typeof val === 'string' ? val : JSON.stringify(val, null, 2);
-        const truncated = valStr.length > max;
-        return [
-            { Field: 'Key', Value: key },
-            { Field: 'Type', Value: typeof val === 'string' ? 'string' : (Array.isArray(val) ? 'array' : typeof val) },
-            { Field: 'Size', Value: `${valStr.length} chars${truncated ? ' (truncated)' : ''}` },
-            { Field: 'Value', Value: truncated ? valStr.slice(0, max) + '\n...(truncated)' : valStr },
-        ];
-    },
-});
-
-// ====== FS-side: recent-paths ======
-cli({
-    site: 'antigravity',
-    name: 'recent-paths',
-    access: 'read',
-    description: 'Show Antigravity\'s recently-opened folders/files (history.recentlyOpenedPathsList).',
-    domain: 'localhost',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', required: false, default: 20, help: 'Max rows to return' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (args) => {
-        const val = getValue(AG_GLOBAL_STATE_DB, 'history.recentlyOpenedPathsList');
-        if (!val) throw new EmptyResultError('antigravity recent-paths', 'No recent paths recorded.');
-        const entries = val.entries || [];
-        if (!entries.length) throw new EmptyResultError('antigravity recent-paths', 'Recent paths list is empty.');
-        const limit = Number.isInteger(args?.limit) && args.limit > 0 ? args.limit : 20;
-        return entries.slice(0, limit).map((e, i) => {
-            let kind = 'other', target = JSON.stringify(e).slice(0, 200);
-            if (e.folderUri) {
-                kind = 'folder';
-                target = decodeURI(String(e.folderUri).replace(/^file:\/\//, ''));
-            } else if (e.fileUri) {
-                kind = 'file';
-                target = decodeURI(String(e.fileUri).replace(/^file:\/\//, ''));
-            } else if (e.workspace?.configPath) {
-                kind = 'workspace';
-                target = decodeURI(String(e.workspace.configPath).replace(/^file:\/\//, ''));
-            }
-            return { Index: i + 1, Kind: kind, Path: target };
-        });
-    },
-});
-
-// ====== FS-side: workspaces-list ======
-cli({
-    site: 'antigravity',
-    name: 'workspaces-list',
-    access: 'read',
-    description: 'List Antigravity workspaceStorage entries (each represents a previously-opened folder).',
-    domain: 'localhost',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', required: false, default: 50, help: 'Max rows to return' },
-    ],
-    columns: STORAGE_COLUMNS,
-    func: async (args) => {
-        if (!fs.existsSync(AG_WORKSPACE_STORAGE)) {
-            throw new CommandExecutionError(`workspaceStorage not found: ${AG_WORKSPACE_STORAGE}`, '');
-        }
-        const dirs = fs.readdirSync(AG_WORKSPACE_STORAGE).filter((n) => {
-            const full = path.join(AG_WORKSPACE_STORAGE, n);
-            return fs.statSync(full).isDirectory();
-        });
-        if (!dirs.length) throw new EmptyResultError('antigravity workspaces-list', 'No workspace storage.');
-        const rows = dirs.map((id) => {
-            const dir = path.join(AG_WORKSPACE_STORAGE, id);
-            const wj = path.join(dir, 'workspace.json');
-            let folder = '(no workspace.json)';
-            if (fs.existsSync(wj)) {
-                try {
-                    const outer = JSON.parse(fs.readFileSync(wj, 'utf-8'));
-                    if (outer.folder) folder = decodeURI(outer.folder.replace(/^file:\/\//, ''));
-                    else if (outer.workspace) folder = '(multi-folder) ' + decodeURI(outer.workspace.replace(/^file:\/\//, ''));
-                } catch { folder = '(invalid workspace.json)'; }
-            }
-            return { id, folder, mtime: fs.statSync(dir).mtimeMs };
-        }).sort((a, b) => b.mtime - a.mtime);
-        const limit = Number.isInteger(args?.limit) && args.limit > 0 ? args.limit : 50;
-        return rows.slice(0, limit).map((r, i) => ({
-            Index: i + 1,
-            'Workspace Id': r.id,
-            Folder: r.folder.slice(0, 120),
-            Modified: new Date(r.mtime).toISOString().replace('T', ' ').slice(0, 19),
-        }));
-    },
-});
-
-// ====== Settings ======
-cli({
-    site: 'antigravity',
-    name: 'settings-read',
-    access: 'read',
-    description: 'Read Antigravity\'s user settings.json (theme, proxy, agCockpit, tfa.system.autoAccept, etc.).',
-    domain: 'localhost',
-    strategy: Strategy.LOCAL,
-    browser: false,
-    args: [],
-    columns: STORAGE_COLUMNS,
-    func: async () => {
-        if (!fs.existsSync(AG_SETTINGS_JSON)) {
-            throw new CommandExecutionError(`settings.json not found: ${AG_SETTINGS_JSON}`, '');
-        }
-        const raw = fs.readFileSync(AG_SETTINGS_JSON, 'utf-8');
-        // VSCode allows JSONC (line + block comments + trailing commas).
-        // Strip comments and trailing commas before parsing.
-        const stripped = raw
-            .replace(/\/\*[\s\S]*?\*\//g, '')              // block comments
-            .replace(/^\s*\/\/.*$/gm, '')                  // line comments (full line)
-            .replace(/([^:"])\/\/.*$/gm, '$1')             // line comments (after code)
-            .replace(/,(\s*[}\]])/g, '$1');                // trailing commas
-        let obj;
-        try { obj = JSON.parse(stripped); } catch (e) {
-            throw new CommandExecutionError(`Failed to parse settings.json: ${e.message}`, '');
-        }
-        const rows = [];
-        for (const [k, v] of Object.entries(obj)) {
-            rows.push({ Field: k, Value: typeof v === 'object' ? JSON.stringify(v) : String(v) });
-        }
-        return rows;
-    },
-});
+    })()`)),$=z?.filter?String(z.filter).toLowerCase():null,F=$?X.filter((V)=>V.k.toLowerCase().includes($)):X;if(!F.length)throw new K("antigravity storage-keys",$?`No keys match "${$}".`:`${Y} is empty.`);F.sort((V,j)=>V.k.localeCompare(j.k));const Q=Number.isInteger(z?.limit)&&z.limit>0?z.limit:100;return F.slice(0,Q).map((V,j)=>({Index:j+1,Key:V.k,Bytes:V.bytes}))}});B({site:"antigravity",name:"storage-get",access:"read",description:"Read a single localStorage / sessionStorage value on the Antigravity renderer.",domain:"127.0.0.1",strategy:I.UI,browser:!0,args:[{name:"key",positional:!0,required:!0,help:"Storage key name"},{name:"storage",required:!1,default:"local",help:'"local" or "session"'},{name:"max-bytes",type:"int",required:!1,default:4000,help:"Truncate value to this many chars"}],columns:W,func:async(H,z)=>{const Z=String(z?.key||"").trim();if(!Z)throw new h("key","is required");const X=String(z?.storage||"local").trim().toLowerCase()==="session"?"sessionStorage":"localStorage",$=P(await H.evaluate(`${X}.getItem(${JSON.stringify(Z)})`));if($===null)throw new D(`Key not found in ${X}: ${Z}`,"");const F=Number.isInteger(z["max-bytes"])&&z["max-bytes"]>0?z["max-bytes"]:4000;let Q=$,V="string";try{Q=JSON.parse($);V=Array.isArray(Q)?"array":typeof Q}catch{}const j=V==="string"?Q:JSON.stringify(Q,null,2),N=j.length>F;return[{Field:"Key",Value:Z},{Field:"Store",Value:X},{Field:"Type",Value:V},{Field:"Size",Value:`${j.length} chars${N?" (truncated)":""}`},{Field:"Value",Value:N?j.slice(0,F)+`
+...(truncated)`:j}]}});B({site:"antigravity",name:"cookies",access:"read",description:"List cookies on the Antigravity renderer (JS-visible via document.cookie).",domain:"127.0.0.1",strategy:I.UI,browser:!0,args:[],columns:W,func:async(H)=>{const z=P(await H.evaluate("document.cookie"));if(!z)throw new K("antigravity cookies","document.cookie is empty.");return z.split("; ").map((Y)=>{const X=Y.indexOf("=");if(X<0)return{name:Y,value:""};return{name:Y.slice(0,X),value:Y.slice(X+1)}}).map((Y,X)=>({Index:X+1,Name:Y.name,Bytes:Y.value.length,Preview:Y.value.slice(0,40)+(Y.value.length>40?"…":"")}))}});B({site:"antigravity",name:"idb-list",access:"read",description:"List IndexedDB databases on the Antigravity renderer.",domain:"127.0.0.1",strategy:I.UI,browser:!0,args:[],columns:W,func:async(H)=>{const z=P(await H.evaluate("(async () => indexedDB.databases ? await indexedDB.databases() : [])()"));if(!Array.isArray(z)||!z.length)throw new K("antigravity idb-list","No IndexedDB databases.");return z.map((Z,Y)=>({Index:Y+1,Database:Z.name||"(unnamed)",Version:String(Z.version||"")}))}});B({site:"antigravity",name:"state-keys",access:"read",description:"List keys in Antigravity's globalStorage state.vscdb (VSCode-style). Pass --workspace <id> to query a per-workspace DB. Works while Antigravity is closed.",domain:"localhost",strategy:I.LOCAL,browser:!1,args:[{name:"filter",required:!1,help:"Case-insensitive substring filter over keys"},{name:"workspace",required:!1,help:"Workspace id (from workspaces-list) to query per-workspace DB"},{name:"limit",type:"int",required:!1,default:200,help:"Max rows to return"}],columns:W,func:async(H)=>{const z=T(H),Z=G(z),Y=H?.filter?String(H.filter).toLowerCase():null,X=Y?Z.filter((F)=>F.toLowerCase().includes(Y)):Z;if(!X.length)throw new K("antigravity state-keys",Y?`No keys match "${Y}".`:"No keys.");const $=Number.isInteger(H?.limit)&&H.limit>0?H.limit:200;return X.slice(0,$).map((F,Q)=>({Index:Q+1,Key:F}))}});B({site:"antigravity",name:"state-get",access:"read",description:"Read one value from Antigravity's state.vscdb. Pass --workspace <id> for per-workspace.",domain:"localhost",strategy:I.LOCAL,browser:!1,args:[{name:"key",positional:!0,required:!0,help:"Storage key name"},{name:"workspace",required:!1,help:"Workspace id (from workspaces-list) to query per-workspace DB"},{name:"max-bytes",type:"int",required:!1,default:8000,help:"Truncate value to this many chars"}],columns:W,func:async(H)=>{const z=String(H?.key||"").trim();if(!z)throw new h("key","is required");const Z=T(H),Y=C(Z,z);if(Y===null)throw new D(`Key not found: ${z}`,"");const X=Number.isInteger(H["max-bytes"])&&H["max-bytes"]>0?H["max-bytes"]:8000,$=typeof Y==="string"?Y:JSON.stringify(Y,null,2),F=$.length>X;return[{Field:"Key",Value:z},{Field:"Type",Value:typeof Y==="string"?"string":Array.isArray(Y)?"array":typeof Y},{Field:"Size",Value:`${$.length} chars${F?" (truncated)":""}`},{Field:"Value",Value:F?$.slice(0,X)+`
+...(truncated)`:$}]}});B({site:"antigravity",name:"recent-paths",access:"read",description:"Show Antigravity's recently-opened folders/files (history.recentlyOpenedPathsList).",domain:"localhost",strategy:I.LOCAL,browser:!1,args:[{name:"limit",type:"int",required:!1,default:20,help:"Max rows to return"}],columns:W,func:async(H)=>{const z=C(x,"history.recentlyOpenedPathsList");if(!z)throw new K("antigravity recent-paths","No recent paths recorded.");const Z=z.entries||[];if(!Z.length)throw new K("antigravity recent-paths","Recent paths list is empty.");const Y=Number.isInteger(H?.limit)&&H.limit>0?H.limit:20;return Z.slice(0,Y).map((X,$)=>{let F="other",Q=JSON.stringify(X).slice(0,200);if(X.folderUri){F="folder";Q=decodeURI(String(X.folderUri).replace(/^file:\/\//,""))}else if(X.fileUri){F="file";Q=decodeURI(String(X.fileUri).replace(/^file:\/\//,""))}else if(X.workspace?.configPath){F="workspace";Q=decodeURI(String(X.workspace.configPath).replace(/^file:\/\//,""))}return{Index:$+1,Kind:F,Path:Q}})}});B({site:"antigravity",name:"workspaces-list",access:"read",description:"List Antigravity workspaceStorage entries (each represents a previously-opened folder).",domain:"localhost",strategy:I.LOCAL,browser:!1,args:[{name:"limit",type:"int",required:!1,default:50,help:"Max rows to return"}],columns:W,func:async(H)=>{if(!J.existsSync(M))throw new D(`workspaceStorage not found: ${M}`,"");const z=J.readdirSync(M).filter((X)=>{const $=q.join(M,X);return J.statSync($).isDirectory()});if(!z.length)throw new K("antigravity workspaces-list","No workspace storage.");const Z=z.map((X)=>{const $=q.join(M,X),F=q.join($,"workspace.json");let Q="(no workspace.json)";if(J.existsSync(F))try{const V=JSON.parse(J.readFileSync(F,"utf-8"));if(V.folder)Q=decodeURI(V.folder.replace(/^file:\/\//,""));else if(V.workspace)Q="(multi-folder) "+decodeURI(V.workspace.replace(/^file:\/\//,""))}catch{Q="(invalid workspace.json)"}return{id:X,folder:Q,mtime:J.statSync($).mtimeMs}}).sort((X,$)=>$.mtime-X.mtime),Y=Number.isInteger(H?.limit)&&H.limit>0?H.limit:50;return Z.slice(0,Y).map((X,$)=>({Index:$+1,"Workspace Id":X.id,Folder:X.folder.slice(0,120),Modified:new Date(X.mtime).toISOString().replace("T"," ").slice(0,19)}))}});B({site:"antigravity",name:"settings-read",access:"read",description:"Read Antigravity's user settings.json (theme, proxy, agCockpit, tfa.system.autoAccept, etc.).",domain:"localhost",strategy:I.LOCAL,browser:!1,args:[],columns:W,func:async()=>{if(!J.existsSync(U))throw new D(`settings.json not found: ${U}`,"");const z=J.readFileSync(U,"utf-8").replace(/\/\*[\s\S]*?\*\//g,"").replace(/^\s*\/\/.*$/gm,"").replace(/([^:"])\/\/.*$/gm,"$1").replace(/,(\s*[}\]])/g,"$1");let Z;try{Z=JSON.parse(z)}catch(X){throw new D(`Failed to parse settings.json: ${X.message}`,"")}const Y=[];for(const[X,$]of Object.entries(Z))Y.push({Field:X,Value:typeof $==="object"?JSON.stringify($):String($)});return Y}});

package/clis/antigravity/watch.js

@@ -1,43 +1,6 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-export const watchCommand = cli({
-    site: 'antigravity',
-    name: 'watch',
-    access: 'read',
-    description: 'Stream new chat messages from Antigravity in real-time',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'timeout', type: 'int', required: false, default: 86400, help: 'Max seconds to keep watching (default: 86400 — 24h)' },
-    ],
-    columns: [], // We use direct stdout streaming
-    func: async (page) => {
-        console.log('Watching Antigravity chat... (Press Ctrl+C to stop)');
-        let lastLength = 0;
-        // Loop until process gets killed
-        while (true) {
-            const text = await page.evaluate(`
+import{cli as C,Strategy as D}from"@jackwener/opencli/registry";export const watchCommand=C({site:"antigravity",name:"watch",access:"read",description:"Stream new chat messages from Antigravity in real-time",domain:"localhost",strategy:D.UI,browser:!0,args:[{name:"timeout",type:"int",required:!1,default:86400,help:"Max seconds to keep watching (default: 86400 — 24h)"}],columns:[],func:async(B)=>{console.log("Watching Antigravity chat... (Press Ctrl+C to stop)");let b=0;while(!0){const A=await B.evaluate(`
         async () => {
           const container = document.getElementById('conversation');
           return container ? container.innerText : '';
         }
-      `);
-            const currentLength = text.length;
-            if (currentLength > lastLength) {
-                // Delta mode
-                const newSegment = text.substring(lastLength);
-                if (newSegment.trim().length > 0) {
-                    process.stdout.write(newSegment);
-                }
-                lastLength = currentLength;
-            }
-            else if (currentLength < lastLength) {
-                // The conversation was cleared or updated significantly
-                lastLength = currentLength;
-                console.log('\\n--- Conversation Cleared/Changed ---\\n');
-                process.stdout.write(text);
-            }
-            await new Promise(resolve => setTimeout(resolve, 500));
-        }
-    },
-});
+      `),q=A.length;if(q>b){const z=A.substring(b);if(z.trim().length>0)process.stdout.write(z);b=q}else if(q<b){b=q;console.log("\\n--- Conversation Cleared/Changed ---\\n");process.stdout.write(A)}await new Promise((z)=>setTimeout(z,500))}}});

package/clis/apple-podcasts/episodes.js

@@ -1,29 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-import { itunesFetch, formatDuration, formatDate } from './utils.js';
-cli({
-    site: 'apple-podcasts',
-    name: 'episodes',
-    access: 'read',
-    description: 'List recent episodes of an Apple Podcast (use ID from search)',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'Podcast ID (collectionId from search output)' },
-        { name: 'limit', type: 'int', default: 15, help: 'Max episodes to show' },
-    ],
-    columns: ['title', 'duration', 'date'],
-    func: async (args) => {
-        const limit = Math.max(1, Math.min(Number(args.limit), 200));
-        // results[0] is the podcast itself; the rest are episodes
-        const data = await itunesFetch(`/lookup?id=${args.id}&entity=podcastEpisode&limit=${limit + 1}`);
-        const episodes = (data.results ?? []).filter((r) => r.kind === 'podcast-episode');
-        if (!episodes.length)
-            throw new CliError('NOT_FOUND', 'No episodes found', 'Check the podcast ID from: opencli apple-podcasts search <keyword>');
-        return episodes.slice(0, limit).map((ep) => ({
-            title: ep.trackName,
-            duration: formatDuration(ep.trackTimeMillis),
-            date: formatDate(ep.releaseDate),
-        }));
-    },
-});
+import{cli as z,Strategy as A}from"@jackwener/opencli/registry";import{CliError as B}from"@jackwener/opencli/errors";import{itunesFetch as G,formatDuration as H,formatDate as I}from"./utils.js";z({site:"apple-podcasts",name:"episodes",access:"read",description:"List recent episodes of an Apple Podcast (use ID from search)",strategy:A.PUBLIC,browser:!1,args:[{name:"id",positional:!0,required:!0,help:"Podcast ID (collectionId from search output)"},{name:"limit",type:"int",default:15,help:"Max episodes to show"}],columns:["title","duration","date"],func:async(q)=>{const v=Math.max(1,Math.min(Number(q.limit),200)),x=((await G(`/lookup?id=${q.id}&entity=podcastEpisode&limit=${v+1}`)).results??[]).filter((b)=>b.kind==="podcast-episode");if(!x.length)throw new B("NOT_FOUND","No episodes found","Check the podcast ID from: opencli apple-podcasts search <keyword>");return x.slice(0,v).map((b)=>({title:b.trackName,duration:H(b.trackTimeMillis),date:I(b.releaseDate)}))}});

package/clis/apple-podcasts/search.js

@@ -1,31 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-import { itunesFetch } from './utils.js';
-cli({
-    site: 'apple-podcasts',
-    name: 'search',
-    access: 'read',
-    description: 'Search Apple Podcasts',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Search keyword' },
-        { name: 'limit', type: 'int', default: 10, help: 'Max results' },
-    ],
-    columns: ['id', 'title', 'author', 'episodes', 'genre', 'url'],
-    func: async (args) => {
-        const term = encodeURIComponent(args.query);
-        const limit = Math.max(1, Math.min(Number(args.limit), 25));
-        const data = await itunesFetch(`/search?term=${term}&media=podcast&limit=${limit}`);
-        if (!data.results?.length)
-            throw new CliError('NOT_FOUND', 'No podcasts found', `Try a different keyword`);
-        return data.results.map((p) => ({
-            id: p.collectionId,
-            title: p.collectionName,
-            author: p.artistName,
-            episodes: p.trackCount ?? '',
-            genre: p.primaryGenreName ?? '',
-            url: p.collectionViewUrl || '',
-        }));
-    },
-});
+import{cli as o,Strategy as s}from"@jackwener/opencli/registry";import{CliError as l}from"@jackwener/opencli/errors";import{itunesFetch as n}from"./utils.js";o({site:"apple-podcasts",name:"search",access:"read",description:"Search Apple Podcasts",strategy:s.PUBLIC,browser:!1,args:[{name:"query",positional:!0,required:!0,help:"Search keyword"},{name:"limit",type:"int",default:10,help:"Max results"}],columns:["id","title","author","episodes","genre","url"],func:async(t)=>{const a=encodeURIComponent(t.query),i=Math.max(1,Math.min(Number(t.limit),25)),r=await n(`/search?term=${a}&media=podcast&limit=${i}`);if(!r.results?.length)throw new l("NOT_FOUND","No podcasts found","Try a different keyword");return r.results.map((e)=>({id:e.collectionId,title:e.collectionName,author:e.artistName,episodes:e.trackCount??"",genre:e.primaryGenreName??"",url:e.collectionViewUrl||""}))}});

package/clis/apple-podcasts/top.js

@@ -1,45 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-// Apple Marketing Tools RSS API — public, no key required
-const CHARTS_URL = 'https://rss.marketingtools.apple.com/api/v2';
-const CHARTS_TIMEOUT_MS = 15_000;
-cli({
-    site: 'apple-podcasts',
-    name: 'top',
-    access: 'read',
-    description: 'Top podcasts chart on Apple Podcasts',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of podcasts (max 100)' },
-        { name: 'country', default: 'us', help: 'Country code (e.g. us, cn, gb, jp)' },
-    ],
-    columns: ['rank', 'title', 'author', 'id'],
-    func: async (args) => {
-        const limit = Math.max(1, Math.min(Number(args.limit), 100));
-        const country = String(args.country || 'us').trim().toLowerCase();
-        const url = `${CHARTS_URL}/${country}/podcasts/top/${limit}/podcasts.json`;
-        let resp;
-        try {
-            resp = await fetch(url, {
-                signal: AbortSignal.timeout(CHARTS_TIMEOUT_MS),
-            });
-        }
-        catch (error) {
-            const reason = error?.cause?.code ?? error?.message ?? 'unknown network error';
-            throw new CliError('FETCH_ERROR', `Unable to reach Apple Podcasts charts for ${country.toUpperCase()}`, `Apple charts may be temporarily unavailable (${reason}). Try again later.`);
-        }
-        if (!resp.ok)
-            throw new CliError('FETCH_ERROR', `Charts API HTTP ${resp.status}`, `Check country code: ${country}`);
-        const data = await resp.json();
-        const results = data?.feed?.results;
-        if (!results?.length)
-            throw new CliError('NOT_FOUND', 'No chart data found', `Try a different country code`);
-        return results.map((p, i) => ({
-            rank: i + 1,
-            title: p.name,
-            author: p.artistName,
-            id: p.id,
-        }));
-    },
-});
+import{cli as J,Strategy as K}from"@jackwener/opencli/registry";import{CliError as z}from"@jackwener/opencli/errors";const N="https://rss.marketingtools.apple.com/api/v2",Q=15000;J({site:"apple-podcasts",name:"top",access:"read",description:"Top podcasts chart on Apple Podcasts",strategy:K.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of podcasts (max 100)"},{name:"country",default:"us",help:"Country code (e.g. us, cn, gb, jp)"}],columns:["rank","title","author","id"],func:async(B)=>{const F=Math.max(1,Math.min(Number(B.limit),100)),v=String(B.country||"us").trim().toLowerCase(),G=`${N}/${v}/podcasts/top/${F}/podcasts.json`;let h;try{h=await fetch(G,{signal:AbortSignal.timeout(Q)})}catch(f){const x=f?.cause?.code??f?.message??"unknown network error";throw new z("FETCH_ERROR",`Unable to reach Apple Podcasts charts for ${v.toUpperCase()}`,`Apple charts may be temporarily unavailable (${x}). Try again later.`)}if(!h.ok)throw new z("FETCH_ERROR",`Charts API HTTP ${h.status}`,`Check country code: ${v}`);const D=(await h.json())?.feed?.results;if(!D?.length)throw new z("NOT_FOUND","No chart data found","Try a different country code");return D.map((f,x)=>({rank:x+1,title:f.name,author:f.artistName,id:f.id}))}});

package/clis/apple-podcasts/utils.js

@@ -1,30 +1 @@
-/**
- * Shared Apple Podcasts utilities.
- *
- * Uses the public iTunes Search API — no API key required.
- * https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/iTuneSearchAPI/
- */
-import { CliError } from '@jackwener/opencli/errors';
-const BASE = 'https://itunes.apple.com';
-export async function itunesFetch(path) {
-    const resp = await fetch(`${BASE}${path}`);
-    if (!resp.ok) {
-        throw new CliError('FETCH_ERROR', `iTunes API HTTP ${resp.status}`, 'Check your search term or podcast ID');
-    }
-    return resp.json();
-}
-/** Format milliseconds to mm:ss. Returns '-' for missing input. */
-export function formatDuration(ms) {
-    if (!ms || !Number.isFinite(ms))
-        return '-';
-    const totalSec = Math.round(ms / 1000);
-    const m = Math.floor(totalSec / 60);
-    const s = totalSec % 60;
-    return `${m}:${String(s).padStart(2, '0')}`;
-}
-/** Format ISO date string to YYYY-MM-DD. Returns '-' for missing input. */
-export function formatDate(iso) {
-    if (!iso)
-        return '-';
-    return iso.slice(0, 10);
-}
+import{CliError as y}from"@jackwener/opencli/errors";const z="https://itunes.apple.com";export async function itunesFetch(b){const q=await fetch(`${z}${b}`);if(!q.ok)throw new y("FETCH_ERROR",`iTunes API HTTP ${q.status}`,"Check your search term or podcast ID");return q.json()}export function formatDuration(b){if(!b||!Number.isFinite(b))return"-";const q=Math.round(b/1000),v=Math.floor(q/60),x=q%60;return`${v}:${String(x).padStart(2,"0")}`}export function formatDate(b){if(!b)return"-";return b.slice(0,10)}