@prismshadow/mmsp 0.5.0

package/dist/integration/tracer.d.ts

@@ -0,0 +1,188 @@
+import { Express } from "express";
+import { UniConfig, UniMessage } from "../types";
+/**
+ * Tracer for saving conversation history to local files.
+ *
+ * This class handles saving conversation history to files in a cache directory.
+ */
+export declare class Tracer {
+    private cacheDir;
+    /**
+     * Initialize the tracer.
+     *
+     * @param cacheDir - Directory to store conversation history files
+     */
+    constructor(cacheDir?: string);
+    /**
+     * Ensure directory exists, create if it doesn't.
+     *
+     * @param dirPath - Directory path to create
+     */
+    private _ensureDirectoryExists;
+    /**
+     * Recursively serialize objects for JSON, converting Buffer to base64.
+     *
+     * @param obj - Object to serialize
+     * @returns JSON-serializable object
+     */
+    private _serializeForJson;
+    /**
+     * Return whether browsers can usually play this MIME type directly.
+     *
+     * @param mimeType - MIME type to inspect
+     * @returns Whether the browser can typically play the audio type
+     */
+    private _isBrowserPlayableAudioMimeType;
+    /**
+     * Decode an inline_data payload to raw bytes.
+     *
+     * @param item - inline_data content item
+     * @returns Raw payload bytes
+     */
+    private _decodeInlineData;
+    /**
+     * Wrap raw PCM bytes in a WAV header using Gemini TTS defaults.
+     *
+     * @param item - inline_data content item
+     * @returns WAV bytes
+     */
+    private _buildWaveBytesFromPcm;
+    /**
+     * Format inline_data metadata without emitting raw payloads.
+     *
+     * @param item - inline_data content item
+     * @returns Human-readable summary of the inline payload
+     */
+    private _formatInlineDataSummary;
+    private _formatEmbeddingPreview;
+    /**
+     * Build a data URL for inline_data content.
+     *
+     * @param item - inline_data content item
+     * @returns Data URL string
+     */
+    private _inlineDataUrl;
+    /**
+     * Return whether inline_data should be rendered as audio.
+     *
+     * @param item - inline_data content item
+     * @returns Whether the payload is audio
+     */
+    private _inlineDataIsAudio;
+    /**
+     * Return the browser-facing audio MIME type after any WAV fallback.
+     *
+     * @param item - inline_data content item
+     * @returns Playable audio MIME type
+     */
+    private _inlineDataAudioType;
+    /**
+     * Save conversation history to files.
+     *
+     * @param history - List of UniMessage objects representing the conversation
+     * @param fileId - File identifier without extension (e.g., "agent1/00001")
+     * @param config - The UniConfig used for this conversation
+     */
+    saveHistory(model: string, history: UniMessage[], fileId: string, config: UniConfig): void;
+    /**
+     * Format conversation history in a readable text format.
+     *
+     * @param history - List of UniMessage objects
+     * @param config - The UniConfig used for this conversation
+     * @returns Formatted string representation of the conversation
+     */
+    private _formatHistory;
+    /**
+     * Create an Express web application for browsing conversation files.
+     *
+     * @returns Express application instance
+     */
+    createWebApp(options?: {
+        basePath?: string;
+    }): Express;
+    /**
+     * Normalize the base path used when tracer is mounted inside another app.
+     *
+     * @param basePath - Optional URL prefix for tracer routes
+     * @returns Normalized URL prefix without a trailing slash
+     */
+    private _normalizeBasePath;
+    /**
+     * Prefix an internal tracer URL with the mount path.
+     *
+     * @param basePath - Normalized tracer mount path
+     * @param url - Internal URL beginning with /
+     * @returns URL safe to render into tracer links
+     */
+    private _prefixUrl;
+    /**
+     * Format a Unix timestamp in milliseconds as YYYY-MM-DD HH:MM:SS.
+     *
+     * @param ms - Unix timestamp in milliseconds
+     * @returns Formatted date string
+     */
+    private _formatTimestamp;
+    /**
+     * Build the rail that lists the rounds of a trace.
+     *
+     * @param totalRounds - Total number of rounds
+     * @param history - Full message history array
+     * @returns HTML string for the rail
+     */
+    private _buildSidebarHtml;
+    /**
+     * Format milliseconds the way the playground does: 840 ms, 2.41 s, 1 min 5 s.
+     *
+     * @param ms - Duration in milliseconds
+     * @returns Formatted duration
+     */
+    private _formatDuration;
+    /**
+     * Group a count's digits by thousands.
+     *
+     * @param value - Count to format
+     * @returns Formatted count
+     */
+    private _formatCount;
+    /**
+     * Build the path from the cache root to the page, every step but the last a link.
+     *
+     * @param basePath - Normalized tracer mount path
+     * @param parts - Path segments below the cache root
+     * @returns Breadcrumb HTML
+     */
+    private _breadcrumb;
+    /**
+     * Build the bar that opens a page, as in a file explorer: back, forward and up, then the address.
+     *
+     * @param breadcrumb - Breadcrumb HTML
+     * @param upUrl - The parent the up button leads to, if there is one
+     * @param isFile - Whether the page shows a file rather than a folder
+     * @returns Navigation bar HTML
+     */
+    private _nav;
+    /**
+     * Wrap a page body in the head, top bar and script every tracer page shares.
+     *
+     * @param title - Page title
+     * @param rootUrl - URL of the cache root
+     * @param body - Page body HTML
+     * @returns Full HTML page
+     */
+    private _page;
+    /**
+     * Escape HTML special characters.
+     *
+     * @param text - Text to escape
+     * @returns Escaped text
+     */
+    private _escapeHtml;
+    /**
+     * Start the web server for browsing conversation files.
+     *
+     * @param host - Host address to bind to
+     * @param port - Port number to listen on
+     */
+    startWebServer(host?: string, port?: number): void;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/integration/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/integration/tracer.ts"],"names":[],"mappings":"AAuBA,OAAgB,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AA+jCjD;;;;GAIG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;OAIG;gBACS,QAAQ,CAAC,EAAE,MAAM;IAO7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;;;OAKG;IAEH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;OAKG;IACH,OAAO,CAAC,+BAA+B;IAcvC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAmChC,OAAO,CAAC,uBAAuB;IAQ/B;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;;;;OAMG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAChB,IAAI;IAuBP;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAuFtB;;;;OAIG;IACH,YAAY,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO;IAwU1D;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAgBnB;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI;IAgBZ;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAuBb;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IASnB;;;;;OAKG;IACH,cAAc,CAAC,IAAI,GAAE,MAAoB,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI;CAOvE"}