clementine-agent 1.0.67 → 1.0.69

package/dist/agent/assistant.d.ts

@@ -40,6 +40,21 @@ export declare function getLinkedProjects(): ProjectMeta[];
 export declare function addProject(projectPath: string, description?: string, keywords?: string[]): void;
 /** Remove a project from the linked projects list. Returns true if removed. */
 export declare function removeProject(projectPath: string): boolean;
+export interface ProactiveGoalInput {
+    goal: {
+        title: string;
+        priority?: string;
+        owner?: string;
+        nextActions?: string[];
+    };
+}
+/**
+ * Build the compact "active goals" block that gets injected when no goal
+ * keyword matches the user's prompt. Pure so it can be tested without the
+ * full Assistant/vault setup.
+ */
+export declare function buildActiveGoalsBlock(goals: ProactiveGoalInput[], agentSlug?: string | null, maxEntries?: number): string;
+export declare function chunkReferencedInResponse(chunkContent: string, responseLower: string): boolean;
 export declare class PersonalAssistant {
     static readonly MAX_SESSION_EXCHANGES = 40;
     private sessions;
@@ -69,6 +84,14 @@ export declare class PersonalAssistant {
     private _compactedSessions;
     /** Last auto-matched project per session — exposed for CLI display. */
     private _lastMatchedProject;
+    /**
+     * Chunks retrieved on the most recent turn per session, kept so the
+     * post-response outcome scorer can check which actually got referenced.
+     * Cleared after each scoring pass.
+     */
+    private _lastRetrievedChunks;
+    /** Lazy-built SessionStore adapter that mirrors SDK transcripts to SQLite. */
+    private _sessionStore;
     /** Hot correction buffer — explicit behavioral corrections applied before nightly SI. */
     private hotCorrections;
     constructor();
@@ -91,6 +114,12 @@ export declare class PersonalAssistant {
     /** Inject a background work result into the session so the next chat naturally references it. */
     injectPendingContext(sessionKey: string, userPrompt: string, result: string): void;
     private initMemoryStore;
+    /**
+     * Return the cached SessionStore adapter. Null until initMemoryStore
+     * completes, in which case the SDK falls back to local-only sessions —
+     * no crash on cold boot.
+     */
+    private getSessionStore;
     /**
      * Seed the in-memory hotCorrections ring buffer from persisted behavioral
      * patterns (corrections that recurred across ≥2 sessions in the last 30d).
@@ -123,6 +152,13 @@ export declare class PersonalAssistant {
      * or empty string if no goals match.
      */
     private matchGoals;
+    /**
+     * Compact always-on block of active goals. Used when no keyword match
+     * fires so the agent still sees what it's supposed to be working on.
+     * Scoped: for agent sessions, includes that agent's goals plus any
+     * clementine-owned goals it might contribute to.
+     */
+    private formatActiveGoalsBlock;
     chat(text: string, sessionKey?: string | null, options?: {
         onText?: OnTextCallback;
         onToolActivity?: OnToolActivityCallback;
@@ -134,6 +170,12 @@ export declare class PersonalAssistant {
         verboseLevel?: VerboseLevel;
         abortController?: AbortController;
     }): Promise<[string, string]>;
+    /**
+     * Compare retrieved chunks against the response text and record which
+     * were referenced. Uses a distinctive-token overlap heuristic — cheap,
+     * deterministic, no extra LLM calls. Called right after a turn completes.
+     */
+    private scoreRetrievalOutcomes;
     private static readonly RATE_LIMIT_MAX_RETRIES;
     private static readonly RATE_LIMIT_BACKOFF;
     private runQuery;