opencode-swarm 7.39.0 → 7.40.0

package/dist/memory/config.d.ts

@@ -25,6 +25,10 @@ export interface MemoryConfig {
     redaction: {
         rejectDurableSecrets: boolean;
     };
+    maintenance: {
+        lowUtilityMaxConfidence: number;
+        lowUtilityMinAgeDays: number;
+    };
     hardDelete: boolean;
 }
 export declare const DEFAULT_MEMORY_CONFIG: MemoryConfig;

package/dist/memory/index.d.ts

@@ -7,8 +7,9 @@ export { createConfiguredMemoryProvider, createMemoryGateway, MemoryGateway, } f
 export { createMemoryLifecycleHooks, type MemoryLifecycleHookOptions, type MemoryLifecycleHooks, } from './injector';
 export { backupLegacyJsonl, getLegacyJsonlFileStatus, type JsonlBackupResult, type JsonlImportPayload, type JsonlInvalidRow, type JsonlMigrationReport, LEGACY_JSONL_MIGRATION_NAME, LEGACY_JSONL_MIGRATION_VERSION, readLegacyJsonl, readMigrationReport, resolveMemoryStorageDir, resolveSqliteDatabasePath, writeJsonlExport, writeMigrationReport, } from './jsonl-migration';
 export { LocalJsonlMemoryProvider } from './local-jsonl-provider';
+export { buildMemoryMaintenanceReport, type MemoryMaintenanceReport, type MemoryMaintenanceReportOptions, type MemoryRecallUsageByMemory, type MemoryRecallUsageByRole, type MemorySupersededChain, shouldCompactMemory, } from './maintenance';
 export { buildRecallPromptBlock } from './prompt-block';
-export type { MemoryProposalStore, MemoryProvider } from './provider';
+export type { MemoryCompactOptions, MemoryCompactResult, MemoryProposalStore, MemoryProvider, MemoryRecallUsageEvent, MemoryRecallUsageFilter, } from './provider';
 export { buildMemoryRecallPlan, type MemoryRecallPlan, type MemoryRecallPlannerInput, } from './recall-planner';
 export { findSecrets, redactSecrets } from './redaction';
 export { MEMORY_RECALL_PROFILES, type MemoryRecallProfile, normalizeMemoryAgentRole, resolveMemoryRecallProfile, } from './role-profiles';

package/dist/memory/local-jsonl-provider.d.ts

@@ -1,5 +1,5 @@
 import { type MemoryConfig } from './config';
-import type { MemoryProposalStore, MemoryProvider, MemoryRecallUsageEvent } from './provider';
+import type { MemoryCompactOptions, MemoryCompactResult, MemoryProposalStore, MemoryProvider, MemoryRecallUsageEvent, MemoryRecallUsageFilter } from './provider';
 import type { RecallScoringDiagnostics } from './scoring';
 import type { AppliedMemoryChange, MemoryListFilter, MemoryProposal, MemoryRecord, RecallRequest, RecallResultItem, ResolvedCuratorMemoryDecision } from './types';
 export declare class LocalJsonlMemoryProvider implements MemoryProvider, MemoryProposalStore {
@@ -21,6 +21,7 @@ export declare class LocalJsonlMemoryProvider implements MemoryProvider, MemoryP
         diagnostics: RecallScoringDiagnostics;
     }>;
     recordRecallUsage(event: MemoryRecallUsageEvent): Promise<void>;
+    listRecallUsage(filter?: MemoryRecallUsageFilter): Promise<MemoryRecallUsageEvent[]>;
     list(filter?: MemoryListFilter): Promise<MemoryRecord[]>;
     createProposal(proposal: MemoryProposal): Promise<MemoryProposal>;
     listProposals(filter?: {
@@ -29,6 +30,7 @@ export declare class LocalJsonlMemoryProvider implements MemoryProvider, MemoryP
     }): Promise<MemoryProposal[]>;
     applyCuratorDecision(decision: ResolvedCuratorMemoryDecision): Promise<AppliedMemoryChange>;
     compact(): Promise<void>;
+    compactMaintenance(options?: MemoryCompactOptions): Promise<MemoryCompactResult>;
     private audit;
     private activeMemory;
     private validateDecisionMemory;

package/dist/memory/maintenance.d.ts

@@ -0,0 +1,47 @@
+import type { MemoryProposalStore, MemoryProvider } from './provider';
+import type { MemoryProposal, MemoryRecord } from './types';
+export interface MemoryRecallUsageByMemory {
+    memoryId: string;
+    count: number;
+    lastRecalledAt: string;
+    agentRoles: Record<string, number>;
+    averageScore: number;
+}
+export interface MemoryRecallUsageByRole {
+    agentRole: string;
+    count: number;
+    memoryIds: Record<string, number>;
+}
+export interface MemorySupersededChain {
+    rootId: string;
+    chain: string[];
+    reason?: string;
+}
+export interface MemoryMaintenanceReport {
+    generatedAt: string;
+    totalMemories: number;
+    activeMemories: number;
+    deletedMemories: MemoryRecord[];
+    expiredScratchMemories: MemoryRecord[];
+    supersededMemories: MemoryRecord[];
+    supersededChains: MemorySupersededChain[];
+    lowUtilityMemories: MemoryRecord[];
+    neverRecalledMemories: MemoryRecord[];
+    mostRecalledMemories: MemoryRecallUsageByMemory[];
+    recallByAgentRole: MemoryRecallUsageByRole[];
+    rejectedProposalReasons: MemoryProposal[];
+    pendingProposals: MemoryProposal[];
+    recallEventCount: number;
+}
+export interface MemoryMaintenanceReportOptions {
+    now?: Date;
+    limit?: number;
+    lowUtilityMaxConfidence?: number;
+    lowUtilityMinAgeDays?: number;
+}
+type ObservableProvider = MemoryProvider & Partial<MemoryProposalStore> & {
+    listRecallUsage?: MemoryProvider['listRecallUsage'];
+};
+export declare function buildMemoryMaintenanceReport(provider: ObservableProvider, options?: MemoryMaintenanceReportOptions): Promise<MemoryMaintenanceReport>;
+export declare function shouldCompactMemory(memory: MemoryRecord, now?: Date): 'deleted' | 'superseded' | 'expired_scratch' | null;
+export {};

package/dist/memory/provider.d.ts

@@ -16,6 +16,20 @@ export interface MemoryRecallUsageEvent {
     runId?: string;
     timestamp: string;
 }
+export interface MemoryRecallUsageFilter {
+    limit?: number;
+}
+export interface MemoryCompactOptions {
+    dryRun?: boolean;
+    now?: string;
+}
+export interface MemoryCompactResult {
+    dryRun: boolean;
+    removedDeleted: number;
+    removedSuperseded: number;
+    removedExpiredScratch: number;
+    remaining: number;
+}
 export interface MemoryProvider {
     readonly name: string;
     initialize?(): Promise<void>;
@@ -26,6 +40,8 @@ export interface MemoryProvider {
     recall(request: RecallRequest): Promise<RecallResultItem[]>;
     recallWithDiagnostics?(request: RecallRequest): Promise<MemoryRecallResult>;
     recordRecallUsage?(event: MemoryRecallUsageEvent): Promise<void>;
+    listRecallUsage?(filter?: MemoryRecallUsageFilter): Promise<MemoryRecallUsageEvent[]>;
+    compactMaintenance?(options?: MemoryCompactOptions): Promise<MemoryCompactResult>;
     list(filter: MemoryListFilter): Promise<MemoryRecord[]>;
 }
 export interface MemoryProposalStore {

package/dist/memory/sqlite-provider.d.ts

@@ -1,6 +1,6 @@
 import { type MemoryConfig } from './config';
 import { type JsonlMigrationReport } from './jsonl-migration';
-import type { MemoryProposalStore, MemoryProvider, MemoryRecallUsageEvent } from './provider';
+import type { MemoryCompactOptions, MemoryCompactResult, MemoryProposalStore, MemoryProvider, MemoryRecallUsageEvent, MemoryRecallUsageFilter } from './provider';
 import type { RecallScoringDiagnostics } from './scoring';
 import type { AppliedMemoryChange, MemoryListFilter, MemoryProposal, MemoryRecord, RecallRequest, RecallResultItem, ResolvedCuratorMemoryDecision } from './types';
 export interface SQLiteJsonlImportResult {
@@ -31,6 +31,7 @@ export declare class SQLiteMemoryProvider implements MemoryProvider, MemoryPropo
         diagnostics: RecallScoringDiagnostics;
     }>;
     recordRecallUsage(event: MemoryRecallUsageEvent): Promise<void>;
+    listRecallUsage(filter?: MemoryRecallUsageFilter): Promise<MemoryRecallUsageEvent[]>;
     list(filter?: MemoryListFilter): Promise<MemoryRecord[]>;
     createProposal(proposal: MemoryProposal): Promise<MemoryProposal>;
     listProposals(filter?: {
@@ -47,6 +48,7 @@ export declare class SQLiteMemoryProvider implements MemoryProvider, MemoryPropo
         memories: number;
         proposals: number;
     }>;
+    compactMaintenance(options?: MemoryCompactOptions): Promise<MemoryCompactResult>;
     hasMigration(name: string): boolean;
     markMigration(version: number, name: string): void;
     private selectRecallCandidates;

package/dist/memory/types.d.ts

@@ -185,5 +185,6 @@ export interface MemoryListFilter {
     scopes?: MemoryScopeRef[];
     kinds?: MemoryKind[];
     includeExpired?: boolean;
+    includeInactive?: boolean;
     limit?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.39.0",
+	"version": "7.40.0",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",