/* BARE_OS_BIN_API 1.0.0 — bump when staged /bin script semantics change (see developer guide). */ /** Shared helpers for drive-resident /bin scripts (prepended before each command). */ function bareStdin(ctx) { return typeof ctx.shellStdin === 'string' ? ctx.shellStdin : '' } /** @param {number} mode @param {'file' | 'directory' | 'symlink'} type */ function bareFormatModeString(mode, type) { const typeChar = type === 'directory' ? 'd' : type === 'symlink' ? 'l' : '-' const perm = mode & 0o777 const r = (bit) => (perm & bit ? 'r' : '-') const w = (bit) => (perm & bit ? 'w' : '-') const x = (bit) => (perm & bit ? 'x' : '-') return ( typeChar + r(0o400) + w(0o200) + x(0o100) + r(0o040) + w(0o020) + x(0o010) + r(0o004) + w(0o002) + x(0o001) ) } /** @param {number} mtimeMs @param {number} [nowMs] */ function bareFormatLsMtime(mtimeMs, nowMs) { const now = nowMs != null ? nowMs : Date.now() const d = new Date(mtimeMs) const months = [ 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' ] const mon = months[d.getMonth()] const day = String(d.getDate()).padStart(2, ' ') const sixMo = 180 * 24 * 3600 * 1000 if (Math.abs(now - mtimeMs) > sixMo) { const yr = String(d.getFullYear()).padStart(4, ' ') return mon + ' ' + day + ' ' + yr } const hh = String(d.getHours()).padStart(2, '0') const mm = String(d.getMinutes()).padStart(2, '0') return mon + ' ' + day + ' ' + hh + ':' + mm } /** @param {number} size */ function barePosixBlocks(size) { return Math.ceil(Number(size) / 512) || 0 } /** * Raw stdout for NUL/binary when **`process.stdout.write`** is missing. * If **`ctx.bareOsBinWrite(Uint8Array|string)`** is set (tests / host), use it. * @param {Record} ctx * @param {string | Uint8Array} chunk * @returns {boolean} */ function bareOsEmitRaw(ctx, chunk) { if (typeof ctx.bareOsBinWrite === 'function') { const b4 = ctx.b4a const u8 = typeof chunk === 'string' ? b4 && typeof b4.from === 'function' ? b4.from(chunk) : new TextEncoder().encode(chunk) : chunk ctx.bareOsBinWrite(u8 instanceof Uint8Array ? u8 : new Uint8Array(u8)) return true } const w = globalThis.process?.stdout?.write if (typeof w === 'function') { w.call(globalThis.process.stdout, chunk) return true } return false } const BARE_P2P_SUITE_PREFIX = '[bare-p2p-v1]' const BARE_P2P_SUITE_MAX_HISTORY = 2000 function bareP2pNowMs() { return Date.now() } function bareP2pId(prefix) { const rnd = Math.floor(Math.random() * 0x7fffffff) return prefix + '-' + bareP2pNowMs().toString(36) + '-' + rnd.toString(36) } function bareP2pHome(ctx) { const env = ctx.env && typeof ctx.env === 'object' ? ctx.env : {} const home = typeof env.HOME === 'string' && env.HOME ? env.HOME : '/home/guest' return home } function bareP2pJoinPath(a, b) { if (!a.endsWith('/')) return a + '/' + b return a + b } function bareP2pDataDir(ctx) { return bareP2pJoinPath(bareP2pHome(ctx), '.bare/p2p-suite') } function bareP2pDataFile(ctx, app) { return bareP2pJoinPath(bareP2pDataDir(ctx), app + '.json') } async function bareP2pReadJson(ctx, path) { try { if (!ctx.vfs || typeof ctx.vfs.readFile !== 'function') return null const b = await ctx.vfs.readFile(path) if (!b) return null const t = ctx.b4a.toString(b).trim() if (!t) return null return JSON.parse(t) } catch { return null } } async function bareP2pWriteJson(ctx, path, obj) { if (!ctx.vfs || typeof ctx.vfs.writeFile !== 'function') return false const body = JSON.stringify(obj, null, 2) + '\n' const b4 = ctx.b4a const buf = b4 && typeof b4.from === 'function' ? b4.from(body) : new TextEncoder().encode(body) try { await ctx.vfs.writeFile(path, buf) return true } catch { return false } } function bareP2pDecodeEnvelope(line) { const s = String(line || '') if (!s.startsWith(BARE_P2P_SUITE_PREFIX)) return null const payload = s.slice(BARE_P2P_SUITE_PREFIX.length).trim() if (!payload) return null try { const obj = JSON.parse(payload) if (!obj || typeof obj !== 'object') return null return obj } catch { return null } } function bareP2pEncodeEnvelope(app, kind, payload) { return ( BARE_P2P_SUITE_PREFIX + ' ' + JSON.stringify({ schema: 1, suite: 'bare-p2p', version: '1', app, kind, tsMs: bareP2pNowMs(), payload: payload || {} }) ) } function bareP2pSend(ctx, app, kind, payload) { if (app === 'meshdrop' && typeof ctx.bareOsMeshdropSend === 'function') { return ctx.bareOsMeshdropSend({ app, kind, payload: payload || {}, tsMs: bareP2pNowMs() }) } if (typeof ctx.bareOsChatSend !== 'function') { return { ok: false, reason: 'bareOsChatSend unavailable' } } return ctx.bareOsChatSend(bareP2pEncodeEnvelope(app, kind, payload)) } function bareP2pCollectFromHistory(ctx, app, limit) { if (app === 'meshdrop' && typeof ctx.bareOsMeshdropHistory === 'function') { let hist = [] try { hist = ctx.bareOsMeshdropHistory( Math.max(1, Math.min(BARE_P2P_SUITE_MAX_HISTORY, limit || 512)) ) } catch { hist = [] } if (!Array.isArray(hist)) return [] const out = [] for (const ev of hist) { if (!ev || typeof ev !== 'object') continue if (ev.app !== app) continue out.push({ fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '', displayName: typeof ev.sender === 'string' ? ev.sender : '', local: Boolean(ev.local), receivedAtMs: typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(), packet: { app, kind: typeof ev.kind === 'string' ? ev.kind : 'unknown', payload: ev.payload && typeof ev.payload === 'object' ? ev.payload : {} } }) } return out } if (typeof ctx.bareOsChatHistory !== 'function') return [] let hist = [] try { hist = ctx.bareOsChatHistory( Math.max(1, Math.min(BARE_P2P_SUITE_MAX_HISTORY, limit || 512)) ) } catch { hist = [] } if (!Array.isArray(hist)) return [] const out = [] for (const ev of hist) { if (!ev || typeof ev !== 'object') continue const body = String(ev.body || '') const decoded = bareP2pDecodeEnvelope(body) if (!decoded || decoded.app !== app) continue out.push({ fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '', displayName: typeof ev.displayName === 'string' ? ev.displayName : '', local: Boolean(ev.local), receivedAtMs: typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(), packet: decoded }) } return out } function bareP2pSubscribe(ctx, app, fn) { if (app === 'meshdrop' && typeof ctx.bareOsMeshdropSubscribe === 'function') { return ctx.bareOsMeshdropSubscribe((ev) => { if (!ev || typeof ev !== 'object' || ev.app !== app) return fn({ fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '', displayName: typeof ev.sender === 'string' ? ev.sender : '', local: Boolean(ev.local), receivedAtMs: typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(), packet: { app, kind: typeof ev.kind === 'string' ? ev.kind : 'unknown', payload: ev.payload && typeof ev.payload === 'object' ? ev.payload : {} } }) }) } if (typeof ctx.bareOsChatSubscribe !== 'function') return () => {} return ctx.bareOsChatSubscribe((ev) => { if (!ev || typeof ev !== 'object') return const body = String(ev.body || '') const decoded = bareP2pDecodeEnvelope(body) if (!decoded || decoded.app !== app) return fn({ fromPeerKey: typeof ev.fromPeerKey === 'string' ? ev.fromPeerKey : '', displayName: typeof ev.displayName === 'string' ? ev.displayName : '', local: Boolean(ev.local), receivedAtMs: typeof ev.receivedAtMs === 'number' ? ev.receivedAtMs : bareP2pNowMs(), packet: decoded }) }) } async function bareP2pReadSwarmSnapshot(ctx) { const out = { atMs: bareP2pNowMs(), peerCount: null, topicCount: null, peers: [] } const snap = await bareP2pReadJson(ctx, '/proc/bare_os/swarm') if (!snap || typeof snap !== 'object') return out if (typeof snap.peerCount === 'number') out.peerCount = snap.peerCount if (typeof snap.topicCount === 'number') out.topicCount = snap.topicCount const peers = Array.isArray(snap.peers) ? snap.peers : [] const detailsRaw = await bareP2pReadJson(ctx, '/proc/bare_os/peer_details.json') const details = detailsRaw && typeof detailsRaw === 'object' && Array.isArray(detailsRaw.peers) ? detailsRaw.peers : [] /** @type {Map>} */ const byKey = new Map() for (const d of details) { if (!d || typeof d !== 'object') continue const rk = typeof d.remotePublicKey === 'string' ? d.remotePublicKey : '' const pid = typeof d.peerId === 'string' ? d.peerId : '' if (rk) byKey.set('k:' + rk, d) if (pid) byKey.set('p:' + pid, d) } const merged = [] for (const p of peers) { if (!p || typeof p !== 'object') continue const rk = typeof p.remotePublicKey === 'string' ? p.remotePublicKey : '' const pid = typeof p.peerId === 'string' ? p.peerId : '' const d = (rk && byKey.get('k:' + rk)) || (pid && byKey.get('p:' + pid)) || null merged.push(d && typeof d === 'object' ? { ...p, ...d } : p) } out.peers = merged.slice(0, 128) return out } async function bareP2pReadProcJson(ctx, path) { const v = await bareP2pReadJson(ctx, path) return v && typeof v === 'object' ? v : {} } const BARE_MESHDROP_CHUNK_RAW = 12 * 1024 function bareMeshdropName(path) { const parts = String(path || '').split('/') return parts[parts.length - 1] || 'file.bin' } function bareMeshdropChunkB64Limit() { const raw = BARE_MESHDROP_CHUNK_RAW return Math.ceil((raw * 4) / 3) + 16 } function bareMeshdropChunkSliceB64(b64, index) { const max = bareMeshdropChunkB64Limit() const from = index * max const to = Math.min(b64.length, from + max) return b64.slice(from, to) } async function bareMeshdropDbRead(ctx) { const p = bareP2pDataFile(ctx, 'meshdrop') const cur = await bareP2pReadJson(ctx, p) if (cur && typeof cur === 'object') return cur return { schema: 2, outgoing: {}, incoming: {}, transfers: {} } } async function bareMeshdropDbWrite(ctx, db) { return bareP2pWriteJson(ctx, bareP2pDataFile(ctx, 'meshdrop'), db) } function bareMeshdropEnsureTransfer(db, transferId) { if (!db.transfers || typeof db.transfers !== 'object') db.transfers = {} if (!db.transfers[transferId]) { db.transfers[transferId] = { transferId, status: 'new', chunksTotal: 0, chunksReceived: 0, updatedAtMs: Date.now() } } return db.transfers[transferId] } async function run(ctx, argv) { const argv0 = argv[0] || 'meshdrop' const args = argv.slice(1) if (args.includes('-h') || args.includes('--help') || args.length === 0) { ctx.console.log( 'usage: ' + argv0 + ' offer FILE [--to PEER_HINT]\n' + ' ' + argv0 + ' send-next OFFER_ID [MAX_CHUNKS]\n' + ' ' + argv0 + ' inbox [N]\n' + ' ' + argv0 + ' accept OFFER_ID\n' + ' ' + argv0 + ' fetch OFFER_ID [DEST]\n' + ' ' + argv0 + ' status [TRANSFER_ID]\n' + ' ' + argv0 + ' cancel TRANSFER_ID\n' + 'P2P file inbox/outbox over bare-p2p envelopes on chat transport.\n' + 'See man meshdrop.' ) if (args.length === 0) ctx.exitCode = 1 return } const sub = args[0] if (sub === 'offer') { const file = args[1] if (!file) { ctx.console.error(argv0 + ': offer requires FILE') ctx.exitCode = 1 return } const b = await ctx.vfs.readFile(file) if (!b) { ctx.console.error(argv0 + ': unable to read ' + file) ctx.exitCode = 1 return } const b64 = ctx.b4a.toString(b, 'base64') const toIdx = args.indexOf('--to') const to = toIdx >= 0 ? String(args[toIdx + 1] || '').trim() : '' const offerId = bareP2pId('offer') const transferId = bareP2pId('xfer') const chunkChars = bareMeshdropChunkB64Limit() const chunksTotal = Math.max(1, Math.ceil(b64.length / chunkChars)) const firstChunk = bareMeshdropChunkSliceB64(b64, 0) const db = await bareMeshdropDbRead(ctx) if (!db.outgoing || typeof db.outgoing !== 'object') db.outgoing = {} db.outgoing[offerId] = { offerId, transferId, file, fileName: bareMeshdropName(file), byteLength: b.byteLength, base64: b64, chunkChars, chunksTotal, sentChunks: firstChunk ? 1 : 0, to, status: 'offered', updatedAtMs: Date.now() } const tr = bareMeshdropEnsureTransfer(db, transferId) tr.role = 'sender' tr.offerId = offerId tr.status = 'offered' tr.chunksTotal = chunksTotal tr.chunksReceived = 0 tr.updatedAtMs = Date.now() await bareMeshdropDbWrite(ctx, db) if (typeof ctx.bareOsEmitMirrorDriveHint === 'function') { ctx.bareOsEmitMirrorDriveHint({ app: 'meshdrop', phase: 'offer', offerId, transferId, fileName: bareMeshdropName(file), byteLength: b.byteLength, chunksTotal }) } const r = bareP2pSend(ctx, 'meshdrop', 'offer', { offerId, transferId, fromPath: file, fileName: bareMeshdropName(file), byteLength: b.byteLength, chunkChars, chunksTotal, firstChunkB64: firstChunk, to }) if (r && r.ok === false) { ctx.console.error(argv0 + ': ' + String(r.reason || 'send failed')) ctx.exitCode = 1 return } ctx.console.log( 'offered ' + file + ' as ' + offerId + ' (' + chunksTotal + ' chunks)' ) return } if (sub === 'send-next') { const offerId = String(args[1] || '').trim() if (!offerId) { ctx.console.error(argv0 + ': send-next requires OFFER_ID') ctx.exitCode = 1 return } const maxChunks = Math.max( 1, Math.min(64, parseInt(args[2] || '8', 10) || 8) ) const db = await bareMeshdropDbRead(ctx) const rec = db?.outgoing?.[offerId] if (!rec) { ctx.console.error(argv0 + ': unknown offer: ' + offerId) ctx.exitCode = 1 return } let sent = 0 while (sent < maxChunks && rec.sentChunks < rec.chunksTotal) { const idx = rec.sentChunks const chunk = bareMeshdropChunkSliceB64(rec.base64, idx) const r = bareP2pSend(ctx, 'meshdrop', 'chunk', { offerId: rec.offerId, transferId: rec.transferId, index: idx, chunksTotal: rec.chunksTotal, chunkB64: chunk }) if (r && r.ok === false) break rec.sentChunks++ rec.updatedAtMs = Date.now() sent++ } rec.status = rec.sentChunks >= rec.chunksTotal ? 'all-chunks-sent' : 'sending' const tr = bareMeshdropEnsureTransfer(db, rec.transferId) tr.status = rec.status tr.updatedAtMs = rec.updatedAtMs await bareMeshdropDbWrite(ctx, db) bareP2pSend(ctx, 'meshdrop', 'progress', { offerId: rec.offerId, transferId: rec.transferId, sentChunks: rec.sentChunks, chunksTotal: rec.chunksTotal }) ctx.console.log( 'sent ' + sent + ' chunk(s), ' + rec.sentChunks + '/' + rec.chunksTotal ) return } if (sub === 'inbox') { const n = Math.max(1, Math.min(200, parseInt(args[1] || '20', 10) || 20)) const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000) const offers = rows.filter((r) => r.packet?.kind === 'offer').slice(-n) for (const row of offers) { const p = row.packet?.payload || {} const offerId = typeof p.offerId === 'string' ? p.offerId : '?' const fileName = typeof p.fileName === 'string' ? p.fileName : '?' const bytes = typeof p.byteLength === 'number' ? p.byteLength : 0 const chunks = typeof p.chunksTotal === 'number' ? p.chunksTotal : '?' const from = row.displayName || row.fromPeerKey.slice(0, 10) || 'peer' ctx.console.log( '[' + bareP2pFmtClock(row.receivedAtMs) + '] ' + offerId + ' ' + fileName + ' ' + bytes + 'B chunks=' + String(chunks) + ' from=' + from ) } return } if (sub === 'accept') { const offerId = String(args[1] || '').trim() if (!offerId) { ctx.console.error(argv0 + ': accept requires OFFER_ID') ctx.exitCode = 1 return } const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000) const offer = rows.findLast( (r) => r.packet?.kind === 'offer' && r.packet.payload && typeof r.packet.payload === 'object' && r.packet.payload.offerId === offerId ) if (!offer) { ctx.console.error(argv0 + ': offer not found: ' + offerId) ctx.exitCode = 1 return } const p = offer.packet.payload const transferId = typeof p.transferId === 'string' ? p.transferId : bareP2pId('xfer') const fileName = typeof p.fileName === 'string' ? p.fileName : offerId + '.received' const chunksTotal = typeof p.chunksTotal === 'number' ? p.chunksTotal : 1 const db = await bareMeshdropDbRead(ctx) if (!db.incoming || typeof db.incoming !== 'object') db.incoming = {} db.incoming[offerId] = { offerId, transferId, fileName, chunksTotal, chunks: {}, acceptedAtMs: Date.now(), status: 'accepted' } if (typeof p.firstChunkB64 === 'string' && p.firstChunkB64) { db.incoming[offerId].chunks[0] = p.firstChunkB64 } const tr = bareMeshdropEnsureTransfer(db, transferId) tr.role = 'receiver' tr.offerId = offerId tr.status = 'accepted' tr.chunksTotal = chunksTotal tr.chunksReceived = Object.keys(db.incoming[offerId].chunks).length tr.updatedAtMs = Date.now() await bareMeshdropDbWrite(ctx, db) bareP2pSend(ctx, 'meshdrop', 'accept', { offerId, transferId }) ctx.console.log('accepted ' + offerId + ' (transfer ' + transferId + ')') return } if (sub === 'fetch') { const offerId = String(args[1] || '').trim() if (!offerId) { ctx.console.error(argv0 + ': fetch requires OFFER_ID') ctx.exitCode = 1 return } const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000) const offer = rows.findLast( (r) => r.packet?.kind === 'offer' && r.packet.payload && typeof r.packet.payload === 'object' && r.packet.payload.offerId === offerId ) if (!offer) { ctx.console.error(argv0 + ': offer not found: ' + offerId) ctx.exitCode = 1 return } const p = offer.packet.payload const fileName = typeof p.fileName === 'string' ? p.fileName : offerId + '.bin' const dest = args[2] || fileName const db = await bareMeshdropDbRead(ctx) const incoming = db?.incoming?.[offerId] if (!incoming) { ctx.console.error( argv0 + ': offer is not accepted locally; run `' + argv0 + ' accept ' + offerId + '` first' ) ctx.exitCode = 1 return } const chunks = incoming.chunks && typeof incoming.chunks === 'object' ? incoming.chunks : {} const total = typeof incoming.chunksTotal === 'number' ? incoming.chunksTotal : 0 const pieces = [] for (let i = 0; i < total; i++) { const part = chunks[i] if (typeof part !== 'string' || !part) { ctx.console.error( argv0 + ': missing chunk ' + i + '/' + total + ' (run `' + argv0 + ' status ' + incoming.transferId + '` to inspect)' ) ctx.exitCode = 1 return } pieces.push(part) } const buf = ctx.b4a.from(pieces.join(''), 'base64') await ctx.vfs.writeFile(dest, buf) incoming.status = 'saved' incoming.savedTo = dest incoming.savedAtMs = Date.now() const tr = bareMeshdropEnsureTransfer(db, incoming.transferId) tr.status = 'saved' tr.chunksReceived = total tr.updatedAtMs = Date.now() await bareMeshdropDbWrite(ctx, db) bareP2pSend(ctx, 'meshdrop', 'complete', { offerId, transferId: incoming.transferId, savedTo: dest }) ctx.console.log('saved ' + offerId + ' -> ' + dest) return } if (sub === 'status') { const transferId = String(args[1] || '').trim() const db = await bareMeshdropDbRead(ctx) const rows = bareP2pCollectFromHistory(ctx, 'meshdrop', 2000) for (const row of rows) { const kind = row.packet?.kind const p = row.packet?.payload if (!p || typeof p !== 'object') continue const id = typeof p.transferId === 'string' ? p.transferId : '' if (transferId && id !== transferId) continue if (kind === 'chunk' && typeof p.offerId === 'string' && typeof p.index === 'number') { const inRec = db?.incoming?.[p.offerId] if (inRec && inRec.status !== 'cancelled' && inRec.status !== 'saved') { if (!inRec.chunks || typeof inRec.chunks !== 'object') inRec.chunks = {} if (typeof p.chunkB64 === 'string' && !inRec.chunks[p.index]) { inRec.chunks[p.index] = p.chunkB64 } const got = Object.keys(inRec.chunks).length inRec.status = got >= inRec.chunksTotal ? 'received-all' : 'receiving' const tr = bareMeshdropEnsureTransfer(db, inRec.transferId) tr.status = inRec.status tr.chunksTotal = inRec.chunksTotal tr.chunksReceived = got tr.updatedAtMs = Date.now() } } if (kind === 'cancel' && id) { const tr = bareMeshdropEnsureTransfer(db, id) tr.status = 'cancelled' tr.updatedAtMs = Date.now() } if (kind === 'progress' && id) { const tr = bareMeshdropEnsureTransfer(db, id) if (typeof p.sentChunks === 'number') tr.sentChunks = p.sentChunks if (typeof p.chunksTotal === 'number') tr.chunksTotal = p.chunksTotal tr.status = 'sending' tr.updatedAtMs = Date.now() } if (kind === 'complete' && id) { const tr = bareMeshdropEnsureTransfer(db, id) tr.status = 'complete' tr.updatedAtMs = Date.now() } } await bareMeshdropDbWrite(ctx, db) const items = Object.values(db.transfers || {}) .filter((x) => !transferId || x.transferId === transferId) .sort((a, b) => (b.updatedAtMs || 0) - (a.updatedAtMs || 0)) if (!items.length) { ctx.console.log('no transfers') return } for (const it of items) { ctx.console.log( (it.transferId || '?') + ' role=' + String(it.role || '?') + ' status=' + String(it.status || '?') + ' chunks=' + String(it.chunksReceived || 0) + '/' + String(it.chunksTotal || 0) ) } return } if (sub === 'cancel') { const transferId = String(args[1] || '').trim() if (!transferId) { ctx.console.error(argv0 + ': cancel requires TRANSFER_ID') ctx.exitCode = 1 return } const db = await bareMeshdropDbRead(ctx) const tr = bareMeshdropEnsureTransfer(db, transferId) tr.status = 'cancelled' tr.updatedAtMs = Date.now() await bareMeshdropDbWrite(ctx, db) bareP2pSend(ctx, 'meshdrop', 'cancel', { transferId }) ctx.console.log('cancelled ' + transferId) return } ctx.console.error(argv0 + ': unsupported subcommand') ctx.exitCode = 1 }