Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/** User-triggered and capability-gated cleanup for Persistent Mind-owned state. */
import { randomUUID } from 'crypto';
import {
persistentMindCleanupRequestSchema,
} from '../lib/persistentMindCapabilities.js';
import { PERSISTENT_MIND_ID } from '../lib/persistentMindTrajectory.js';
import {
appendMindEvent,
clearPersistentMindHistory,
} from './agentRunEventLog.js';
import {
archivePersistentMindMemories,
clearPersistentMindRollups,
} from './persistentMindContext.js';
import { clearPersistentMindJournal } from './persistentMindJournal.js';
import { resetPersistentMindRuntimeResidue } from './persistentMindSupervisor.js';
export async function cleanupPersistentMind({
mindId = PERSISTENT_MIND_ID,
scopes,
reason,
requestedBy = 'user',
preserveTurnId = null,
preserveMessageId = null,
} = {}) {
const request = persistentMindCleanupRequestSchema.parse({ scopes, ...(reason ? { reason } : {}) });
const selected = new Set(request.scopes);
const clearHistory = selected.has('history');
const clearContext = clearHistory || selected.has('context');
const results = {
memoriesArchived: 0,
memoriesPreserved: 0,
historyEventsCleared: 0,
historyEventsPreserved: 0,
rollupsCleared: 0,
journalEventsCleared: 0,
runtimeResidueCleared: clearHistory || selected.has('context'),
};
if (selected.has('memories')) {
const memoryResult = await archivePersistentMindMemories(mindId);
results.memoriesArchived = memoryResult.archived;
results.memoriesPreserved = memoryResult.preserved || 0;
}
if (clearContext) {
const rollupResult = await clearPersistentMindRollups(mindId);
results.rollupsCleared = rollupResult.cleared;
}
if (clearHistory) {
// The journal cites message sequences that are about to stop existing, so it
// goes with the history it was drawn from — but NOT with a context-only
// clear, which asks for fresh summaries, not for the mind's outstanding
// commitments to be discharged.
results.journalEventsCleared = (await clearPersistentMindJournal(mindId)).cleared;
const historyResult = await clearPersistentMindHistory({
mindId,
preserveTurnId,
preserveMessageId,
});
results.historyEventsCleared = historyResult.cleared;
results.historyEventsPreserved = historyResult.preserved;
}
if (results.runtimeResidueCleared) await resetPersistentMindRuntimeResidue();
const eventId = `mind-maintenance:${randomUUID()}`;
const auditResult = await appendMindEvent({
kind: 'mind.maintenance.completed',
mindId,
turnId: preserveTurnId,
eventId,
data: {
displayText: 'Mindspace cleanup completed',
requestedBy: requestedBy === 'mind' ? 'mind' : 'user',
reason: request.reason || null,
scopes: request.scopes,
...results,
},
});
return {
ok: true,
success: true,
state: 'completed',
scopes: request.scopes,
reason: request.reason || null,
auditRecorded: auditResult.appended === true || auditResult.duplicate === true,
...results,
eventId: auditResult.appended === true || auditResult.duplicate === true ? eventId : null,
};
}