praana 0.5.0

package/dist/session.d.ts

@@ -0,0 +1,118 @@
+import type { CompileMetrics } from "./compiler.js";
+import type { PraanaConfig, SkillRecord } from "./types.js";
+import { SkillRuntime } from "./skills/index.js";
+import { EventLog } from "./event-log.js";
+import { StateGraph } from "./state-graph.js";
+import { MemoryStore, type SessionEvent } from "./memory/index.js";
+import { buildProjectContext } from "./project-detector.js";
+import { ContextEngine } from "./context-engine/index.js";
+import type { CompileScoreRecord, PressureMode } from "./context-engine/types.js";
+import { type PraanaLogger } from "./logger.js";
+export declare class Session {
+    id: string;
+    cwd: string;
+    config: PraanaConfig;
+    eventLog: EventLog;
+    stateGraph: StateGraph;
+    memoryStore: MemoryStore | null;
+    memoryEnabled: boolean;
+    incognito: boolean;
+    digest: string | null;
+    agentsContext: string | null;
+    projectContext: string | null;
+    skills: SkillRecord[];
+    skillRuntime: SkillRuntime | null;
+    contextEngine: ContextEngine | null;
+    debug: boolean;
+    private ended;
+    private readonly startedAt;
+    private turnCount;
+    private modelOverride;
+    private modelContextWindow;
+    private modelContextWindowFor;
+    private lastCompileMetrics;
+    private lastCompileScoreRecords;
+    private lastPressureMode;
+    private lastPressureRatio;
+    private sessionInputTokens;
+    private sessionOutputTokens;
+    private lastUserInput;
+    private compactionArmed;
+    private sessionLogger;
+    private noticeCapture?;
+    private constructor();
+    static createNew(id: string, cwd: string, config: PraanaConfig): Session;
+    static create(cwd: string, config?: PraanaConfig, opts?: {
+        incognito?: boolean;
+        captureNotice?: (line: string) => void;
+    }): Promise<Session>;
+    static resume(sessionId: string, cwd: string, config?: PraanaConfig, opts?: {
+        captureNotice?: (line: string) => void;
+    }): Promise<Session>;
+    isContextEngineEnabled(): boolean;
+    getTurnCount(): number;
+    incrementTurn(): void;
+    clearState(): void;
+    getStartedAt(): number;
+    getUptimeMs(): number;
+    getActiveModelId(): string;
+    getLogger(): PraanaLogger;
+    initLogger(): Promise<void>;
+    getContextWindowTokens(modelId?: string): number;
+    refreshModelContextWindow(modelId?: string): Promise<number>;
+    ensureModelContextWindow(modelId?: string): Promise<number>;
+    setModelOverride(model: string | null): void;
+    getModelOverride(): string | null;
+    isIncognito(): boolean;
+    recordInputTokens(count: number): void;
+    recordOutputTokens(count: number): void;
+    getInputTokens(): number;
+    getOutputTokens(): number;
+    setIncognito(enabled: boolean): Promise<void>;
+    get promptDir(): string;
+    getMemoryDbPath(): string | null;
+    getRepoRoot(): string;
+    setLastCompileMetrics(metrics: CompileMetrics): void;
+    getLastCompileMetrics(): CompileMetrics | null;
+    setLastCompileScoreRecords(records: CompileScoreRecord[], pressureMode: PressureMode, pressureRatio: number): void;
+    getLastCompileScoreRecords(): CompileScoreRecord[];
+    getCompileScoreRecord(unitId: string): CompileScoreRecord | undefined;
+    getLastPressureMode(): PressureMode;
+    getLastPressureRatio(): number;
+    setLastUserInput(input: string): void;
+    getLastUserInput(): string;
+    isCompactionArmed(): boolean;
+    setCompactionArmed(armed: boolean): void;
+    getMemoryStats(): {
+        total: number;
+        active: number;
+        soft: number;
+        hard: number;
+        byKind: Record<string, number>;
+    };
+    getPersistentMemoryEntryCount(): number | null;
+    getSessionSummary(): {
+        turns: number;
+        stateObjects: number;
+        memoriesStored: number;
+    };
+    /** Build a transcript of user/agent/tool events for the summarizer. */
+    getTranscriptEvents(): SessionEvent[];
+    end(reason: "clean" | "aborted" | "error", events?: SessionEvent[], opts?: {
+        memoryTimeoutMs?: number;
+    }): Promise<void>;
+    private initMemoryStore;
+}
+/**
+ * Load project context from AGENTS.md / CLAUDE.md files.
+ *
+ * Load order (all non-empty results are merged):
+ *   1. ~/.praana/AGENTS.md (or legacy ~/.aria/AGENTS.md) — global personal instructions
+ *   2. <git root>/AGENTS.md    — project-wide context
+ *   3. <cwd>/AGENTS.md         — subdirectory context (if cwd ≠ git root)
+ *   4. CLAUDE.md fallback      — if no AGENTS.md found at project root
+ *
+ * Combined content is capped at ~4000 tokens (16000 chars).
+ */
+export declare function loadAgentsContext(cwd: string): string | null;
+export { buildProjectContext };