@agent-native/core 0.114.6 → 0.114.7

package/dist/mcp/screen-memory-stdio.d.ts

@@ -1,6 +1,371 @@
+export interface ScreenMemoryChapter {
+    id: string;
+    /** In v2, chapter identity survives later semantic refinements. */
+    revision: number;
+    aliases: string[];
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    label: string;
+    summary: string;
+    keywords: string[];
+    accessibilitySummary: string;
+    accessibilityKeywords: string[];
+    confidence: number;
+    segmentRefs: Array<{
+        id: string;
+        startedAt: string;
+        endedAt: string;
+    }>;
+    sceneRefs: Array<{
+        id: string;
+        startedAt?: string;
+        endedAt?: string;
+    }>;
+    evidenceRefs: Array<{
+        sourceType: string;
+        sourceKind?: string;
+        segmentId?: string;
+        offsetMs?: number;
+        capturedAt?: string;
+        keywords?: string[];
+        confidence?: number;
+    }>;
+    contexts: Array<{
+        appName?: string;
+        windowTitle?: string;
+        bundleId?: string;
+    }>;
+    representativeMoments: Array<{
+        momentId: string;
+        capturedAt: string;
+        segmentId: string;
+        offsetMs: number;
+        reason: string;
+    }>;
+    representativeCoverage?: string | {
+        coveredScenes: number;
+        totalScenes: number;
+        truncated: boolean;
+    };
+    ambiguityReasons: string[];
+    indexState: "pending" | "partial" | "ready";
+}
+export interface ScreenMemoryChaptersDocument {
+    schemaVersion: 1 | 2;
+    generatedAt: string;
+    state: string;
+    coverage: unknown;
+    chapters: ScreenMemoryChapter[];
+}
+export interface ScreenMemoryFrameDecoder {
+    (segmentPath: string, offsetMs: number): Buffer;
+}
 export interface RunScreenMemoryMCPStdioOptions {
     storeDir?: string;
     env?: NodeJS.ProcessEnv;
+    /** Test seam; production uses the local ffmpeg executable. */
+    decodeFrame?: ScreenMemoryFrameDecoder;
 }
+/** Reads only the native, retention-bound chapter manifest; malformed rows never escape. */
+export declare function readScreenMemoryChapters(storeDir: string): ScreenMemoryChaptersDocument | null;
+type MatchProvenance = {
+    sourceType: string;
+    sourceKind?: string;
+    confidence?: number;
+    matchedTerms: string[];
+};
+export declare function searchScreenMemoryChapters(document: ScreenMemoryChaptersDocument, query: string, limit?: number, clientHint?: string): Array<ScreenMemoryChapter & {
+    score: number;
+    matchReasons: string[];
+    matchProvenance: MatchProvenance[];
+}>;
+export declare function projectScreenMemoryChapterCandidate(chapter: ReturnType<typeof searchScreenMemoryChapters>[number]): {
+    id: string;
+    revision: number;
+    aliases: string[];
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    label: string;
+    summary: string;
+    keywords: string[];
+    confidence: number;
+    sceneCount: number;
+    evidenceSources: string[];
+    contexts: {
+        appName?: string;
+        windowTitle?: string;
+        bundleId?: string;
+    }[];
+    representativeMoments: {
+        momentId: string;
+        capturedAt: string;
+        reason: string;
+    }[];
+    representativeCoverage: string | {
+        coveredScenes: number;
+        totalScenes: number;
+        truncated: boolean;
+    };
+    ambiguityReasons: string[];
+    indexState: "partial" | "pending" | "ready";
+    score: number;
+    matchReasons: string[];
+    matchProvenance: MatchProvenance[];
+};
+export declare function readScreenMemoryFrame(storeDir: string, timestamp: string, decoder?: ScreenMemoryFrameDecoder): {
+    timestamp: string;
+    segmentId: string;
+    image: {
+        type: "image";
+        data: string;
+        mimeType: string;
+    };
+};
+export declare function selectContactSheetTimestamps(startAt: string, endAt: string, count: number, representative?: string[]): string[];
+export declare function contactSheetRangeIsValid(durationMs: number, usesChapterMoments: boolean): boolean;
+export declare function redactCredentialText(value: string): string;
+export declare function appendLocalEvidenceReceipt(storeDir: string, operation: string, evidence: Array<{
+    timestamp: string;
+    segmentId: string;
+}>): void;
+export declare function screenMemoryMcpToolDefinitions(): ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query?: undefined;
+            minutes?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            reason?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            minutes: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            reason?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            minutes: {
+                type: string;
+                description: string;
+            };
+            query?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            reason?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            minutes: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            clientHint: {
+                type: string;
+                description: string;
+            };
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            reason?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            query?: undefined;
+            minutes?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query?: undefined;
+            minutes?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId: {
+                type: string;
+            };
+            startAt: {
+                type: string;
+                description?: undefined;
+            };
+            endAt: {
+                type: string;
+                description?: undefined;
+            };
+            count: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description?: undefined;
+            };
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            query?: undefined;
+            minutes?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt: {
+                type: string;
+                description: string;
+            };
+            endAt: {
+                type: string;
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            includeMicrophone: {
+                type: string;
+            };
+            includeSystemAudio: {
+                type: string;
+            };
+            requestId?: undefined;
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            query?: undefined;
+            minutes?: undefined;
+            limit?: undefined;
+            clientHint?: undefined;
+            timestamp?: undefined;
+            chapterId?: undefined;
+            count?: undefined;
+            startAt?: undefined;
+            endAt?: undefined;
+            reason?: undefined;
+            includeMicrophone?: undefined;
+            includeSystemAudio?: undefined;
+            requestId: {
+                type: string;
+            };
+        };
+    };
+})[];
 export declare function runScreenMemoryMCPStdio(opts?: RunScreenMemoryMCPStdioOptions): Promise<void>;
+export {};
 //# sourceMappingURL=screen-memory-stdio.d.ts.map

package/dist/mcp/screen-memory-stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen-memory-stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/screen-memory-stdio.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAgJD,wBAAsB,uBAAuB,CAC3C,IAAI,GAAE,8BAAmC,GACxC,OAAO,CAAC,IAAI,CAAC,CA6Gf"}
+{"version":3,"file":"screen-memory-stdio.d.ts","sourceRoot":"","sources":["../../src/mcp/screen-memory-stdio.ts"],"names":[],"mappings":"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"}