iranti 0.2.51 → 0.3.2

package/dist/src/lib/sessionLedger.d.ts

@@ -0,0 +1,94 @@
+import type { EventLevel, StaffComponent } from './staffEventEmitter';
+export interface SessionLedgerQuery {
+    agentId?: string;
+    sessionId?: string;
+    actionType?: string;
+    actionTypes?: string[];
+    source?: string;
+    host?: string;
+    level?: EventLevel;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+}
+export interface SessionLedgerEvent {
+    eventId: string;
+    timestamp: string;
+    staffComponent: StaffComponent;
+    actionType: string;
+    agentId: string;
+    source: string;
+    entityType: string | null;
+    entityId: string | null;
+    key: string | null;
+    reason: string | null;
+    level: EventLevel;
+    metadata: Record<string, unknown> | null;
+}
+export interface SessionLedgerLearning {
+    actionType: string;
+    summary: string;
+    timestamp: string;
+    source: string;
+    host: string | null;
+    sessionId: string | null;
+    entityKey: string | null;
+    reason: string | null;
+    category?: 'host' | 'recall' | 'persistence' | 'compliance' | 'event';
+    evidenceActionTypes?: string[];
+}
+export interface SessionLedgerLearningQuery {
+    agentId?: string;
+    sessionId?: string;
+    source?: string;
+    host?: string;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+    maxLearnings?: number;
+}
+export interface SessionLedgerLearningProfile {
+    scopesUsed: Array<'host' | 'task' | 'global'>;
+    preferMemoryForAmbiguousTurns: boolean;
+    priorityKeys: string[];
+    summaries: string[];
+    matchedTaskType: string | null;
+    needsCheckpointReminder: boolean;
+    checkpointReminder: string | null;
+    missingWriteCategories: string[];
+}
+export interface MemoryAttributionSummary {
+    injectionId: string;
+    sessionId: string | null;
+    agentId: string;
+    source: string;
+    host: string | null;
+    surfacedAt: string;
+    scoredAt: string | null;
+    surfaced: boolean;
+    used: boolean;
+    helpful: boolean;
+    injectedKeys: string[];
+    injectedEntryIds: number[];
+    evidenceKinds: string[];
+    phase: string | null;
+    reason: string | null;
+}
+export interface SessionLedgerLearningProfileQuery {
+    agentId?: string;
+    source?: string;
+    host?: string;
+    taskType?: string;
+    since?: Date;
+    until?: Date;
+    limit?: number;
+}
+export declare class SessionLedgerUnavailableError extends Error {
+    readonly code = "SESSION_LEDGER_UNAVAILABLE";
+    constructor(message?: string);
+}
+export declare function querySessionLedger(input?: SessionLedgerQuery): Promise<SessionLedgerEvent[]>;
+export declare function summarizeSessionLedgerLearnings(input?: SessionLedgerLearningQuery): Promise<SessionLedgerLearning[]>;
+export declare function summarizeMemoryAttribution(input?: SessionLedgerQuery): Promise<MemoryAttributionSummary[]>;
+export declare function buildSessionLedgerLearningProfile(input?: SessionLedgerLearningProfileQuery): Promise<SessionLedgerLearningProfile | null>;
+//# sourceMappingURL=sessionLedger.d.ts.map

package/dist/src/lib/sessionLedger.d.ts.map

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