yepanywhere 0.5.2 → 0.6.0

package/dist/sessions/summary-parser-worker-protocol.d.ts

@@ -0,0 +1,105 @@
+import type { UrlProjectId } from "@yep-anywhere/shared";
+import type { SessionSummary } from "../supervisor/types.js";
+export type SummaryParserWorkerProvider = "claude" | "codex";
+export type SummaryParserWorkerMode = "off" | "on" | "required";
+export type SummaryParserResponseStatus = "ok" | "empty" | "error";
+export type SummaryParserClientStatus = SummaryParserResponseStatus | "fallback" | "timeout" | "crash" | "protocol_error";
+export interface SummaryParserWorkerFileStats {
+    size: number;
+    mtimeMs: number;
+    mtimeIso?: string;
+}
+export interface SummaryParserContextWindowHints {
+    byModelProvider?: Record<string, number>;
+    defaultContextWindow?: number;
+}
+export interface SummaryParserWorkerSourceHints {
+    claude?: {
+        sessionDir?: string;
+    };
+    codex?: {
+        sessionsDir?: string;
+        projectPath?: string;
+        dataDir?: string;
+    };
+}
+export interface SummaryParserWorkerLimits {
+    timeoutMs?: number;
+    recycleAfterBytes?: number;
+    recycleAfterFiles?: number;
+    recycleAfterLineBytes?: number;
+}
+export interface SummaryParserWorkerRequest {
+    type: "parse";
+    requestId: string;
+    provider: SummaryParserWorkerProvider;
+    filePath: string;
+    sessionId: string;
+    projectId: UrlProjectId;
+    stats: SummaryParserWorkerFileStats;
+    sourceHints?: SummaryParserWorkerSourceHints;
+    contextWindowHints?: SummaryParserContextWindowHints;
+    limits?: SummaryParserWorkerLimits;
+}
+export interface SummaryParserWorkerError {
+    name: string;
+    message: string;
+}
+export interface SummaryParserWorkerMetrics {
+    provider: SummaryParserWorkerProvider;
+    sessionId: string;
+    filePath: string;
+    fileSize: number;
+    fileMtimeMs: number;
+    workerPid: number;
+    workerGeneration?: number;
+    nodeVersion: string;
+    durationMs: number;
+    parseMs?: number;
+    lineCount?: number;
+    parsedEntries?: number;
+    malformedLines?: number;
+    nodeCount?: number;
+    dedupedEntries?: number;
+    skippedDuplicateEntries?: number;
+    maxLineLength?: number;
+    heapUsedBefore: number;
+    heapUsedAfter: number;
+    rssBefore: number;
+    rssAfter: number;
+    workerParsedFiles?: number;
+    workerParsedBytes?: number;
+    recycleRecommended?: boolean;
+    recycleReason?: string;
+}
+export interface SummaryParserWorkerResponse {
+    type: "result";
+    requestId: string;
+    status: SummaryParserResponseStatus;
+    summary: SessionSummary | null;
+    metrics: SummaryParserWorkerMetrics;
+    error?: SummaryParserWorkerError;
+}
+export interface SummaryParserWorkerReady {
+    type: "ready";
+    pid: number;
+    nodeVersion: string;
+}
+export type SummaryParserWorkerMessage = SummaryParserWorkerReady | SummaryParserWorkerResponse;
+export interface SummaryParserClientEvent {
+    event: "summary_parser_worker_fallback" | "summary_parser_worker_result";
+    provider: SummaryParserWorkerProvider;
+    sessionId: string;
+    filePath: string;
+    mode: SummaryParserWorkerMode;
+    status: SummaryParserClientStatus;
+    fallbackReason?: string;
+    workerPid?: number;
+    workerGeneration?: number;
+    error?: SummaryParserWorkerError;
+}
+export declare function sanitizeSummaryParserError(error: unknown): SummaryParserWorkerError;
+export declare function parseSummaryParserWorkerMode(value: string | undefined): SummaryParserWorkerMode;
+export declare function isSummaryParserWorkerReady(value: unknown): value is SummaryParserWorkerReady;
+export declare function isSummaryParserWorkerResponse(value: unknown): value is SummaryParserWorkerResponse;
+//# sourceMappingURL=summary-parser-worker-protocol.d.ts.map

package/dist/sessions/summary-parser-worker-protocol.d.ts.map

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

package/dist/sessions/summary-parser-worker-protocol.js

@@ -0,0 +1,35 @@
+export function sanitizeSummaryParserError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name || "Error",
+            message: error.message || "Unknown error",
+        };
+    }
+    return {
+        name: "Error",
+        message: typeof error === "string" ? error : "Unknown error",
+    };
+}
+export function parseSummaryParserWorkerMode(value) {
+    switch (value?.trim().toLowerCase()) {
+        case "on":
+            return "on";
+        case "required":
+            return "required";
+        default:
+            return "off";
+    }
+}
+export function isSummaryParserWorkerReady(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value.type === "ready" &&
+        typeof value.pid === "number");
+}
+export function isSummaryParserWorkerResponse(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        value.type === "result" &&
+        typeof value.requestId === "string");
+}
+//# sourceMappingURL=summary-parser-worker-protocol.js.map

package/dist/sessions/summary-parser-worker-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-parser-worker-protocol.js","sourceRoot":"","sources":["../../src/sessions/summary-parser-worker-protocol.ts"],"names":[],"mappings":"AA2HA,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO;YAC3B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe;SAC1C,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;KAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,KAAyB;IAEzB,QAAQ,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI;YACP,OAAO,IAAI,CAAC;QACd,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAA4B,CAAC,IAAI,KAAK,OAAO;QAC9C,OAAQ,KAA2B,CAAC,GAAG,KAAK,QAAQ,CACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACxB,KAA4B,CAAC,IAAI,KAAK,QAAQ;QAC/C,OAAQ,KAAiC,CAAC,SAAS,KAAK,QAAQ,CACjE,CAAC;AACJ,CAAC"}

package/dist/sessions/summary-parser-worker-runner.d.ts

@@ -0,0 +1,3 @@
+import { type SummaryParserWorkerRequest, type SummaryParserWorkerResponse } from "./summary-parser-worker-protocol.js";
+export declare function runSummaryParserWorkerRequest(request: SummaryParserWorkerRequest): Promise<SummaryParserWorkerResponse>;
+//# sourceMappingURL=summary-parser-worker-runner.d.ts.map

package/dist/sessions/summary-parser-worker-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-parser-worker-runner.d.ts","sourceRoot":"","sources":["../../src/sessions/summary-parser-worker-runner.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAEjC,MAAM,qCAAqC,CAAC;AAgG7C,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAqFtC"}

package/dist/sessions/summary-parser-worker-runner.js

@@ -0,0 +1,158 @@
+import { stat } from "node:fs/promises";
+import { dirname } from "node:path";
+import { getModelContextWindow } from "../../bundled/@yep-anywhere/shared/dist/index.js";
+import { CodexSessionReader } from "./codex-reader.js";
+import { readClaudeSessionSummaryWithMetrics } from "./claude-summary.js";
+import { sanitizeSummaryParserError, } from "./summary-parser-worker-protocol.js";
+function contextWindowFromHints(request, model, provider) {
+    const hints = request.contextWindowHints;
+    const providerKey = `${provider ?? ""}:${model ?? ""}`;
+    const modelKey = model ?? "";
+    return (hints?.byModelProvider?.[providerKey] ??
+        hints?.byModelProvider?.[modelKey] ??
+        hints?.defaultContextWindow ??
+        getModelContextWindow(model, provider));
+}
+async function parseClaudeSummary(request) {
+    const stats = await stat(request.filePath);
+    const read = await readClaudeSessionSummaryWithMetrics({
+        filePath: request.filePath,
+        stats,
+        sessionId: request.sessionId,
+        projectId: request.projectId,
+        resolveContextWindow: (model, provider) => contextWindowFromHints(request, model, provider),
+    });
+    return {
+        summary: read.summary,
+        metrics: {
+            parseMs: read.metrics.parseMs,
+            fileSize: read.metrics.fileSize,
+            fileMtimeMs: Number(stats.mtimeMs),
+            lineCount: read.metrics.lineCount,
+            parsedEntries: read.metrics.parsedEntries,
+            malformedLines: read.metrics.malformedLines,
+            nodeCount: read.metrics.nodeCount,
+            maxLineLength: read.metrics.maxLineLength,
+        },
+    };
+}
+async function parseCodexSummary(request) {
+    const hints = request.sourceHints?.codex;
+    const reader = new CodexSessionReader({
+        sessionsDir: hints?.sessionsDir ?? dirname(request.filePath),
+        ...(hints?.projectPath ? { projectPath: hints.projectPath } : {}),
+        ...(hints?.dataDir ? { dataDir: hints.dataDir } : {}),
+    });
+    const summary = await reader.getSessionSummaryFromFile(request.sessionId, request.projectId, request.filePath);
+    const streamMetrics = reader.getLastSummaryStreamMetrics();
+    return {
+        summary,
+        metrics: streamMetrics
+            ? {
+                fileSize: streamMetrics.fileSize,
+                fileMtimeMs: streamMetrics.fileMtimeMs,
+                durationMs: streamMetrics.durationMs,
+                parseMs: streamMetrics.parseMs,
+                lineCount: streamMetrics.lineCount,
+                parsedEntries: streamMetrics.parsedEntries,
+                dedupedEntries: streamMetrics.dedupedEntries,
+                skippedDuplicateEntries: streamMetrics.skippedDuplicateEntries,
+                maxLineLength: streamMetrics.maxLineLength,
+            }
+            : undefined,
+    };
+}
+async function parseSummary(request) {
+    switch (request.provider) {
+        case "claude":
+            return parseClaudeSummary(request);
+        case "codex":
+            return parseCodexSummary(request);
+    }
+}
+export async function runSummaryParserWorkerRequest(request) {
+    const startedAt = Date.now();
+    const memoryBefore = process.memoryUsage();
+    try {
+        const result = await parseSummary(request);
+        const memoryAfter = process.memoryUsage();
+        const metrics = {
+            provider: request.provider,
+            sessionId: request.sessionId,
+            filePath: request.filePath,
+            fileSize: result.metrics?.fileSize ?? request.stats.size,
+            fileMtimeMs: result.metrics?.fileMtimeMs ?? request.stats.mtimeMs,
+            workerPid: process.pid,
+            nodeVersion: process.version,
+            durationMs: result.metrics?.durationMs ?? Date.now() - startedAt,
+            ...(result.metrics?.parseMs !== undefined
+                ? { parseMs: result.metrics.parseMs }
+                : {}),
+            ...(result.metrics?.lineCount !== undefined
+                ? { lineCount: result.metrics.lineCount }
+                : {}),
+            ...(result.metrics?.parsedEntries !== undefined
+                ? { parsedEntries: result.metrics.parsedEntries }
+                : {}),
+            ...(result.metrics?.malformedLines !== undefined
+                ? { malformedLines: result.metrics.malformedLines }
+                : {}),
+            ...(result.metrics?.nodeCount !== undefined
+                ? { nodeCount: result.metrics.nodeCount }
+                : {}),
+            ...(result.metrics?.dedupedEntries !== undefined
+                ? { dedupedEntries: result.metrics.dedupedEntries }
+                : {}),
+            ...(result.metrics?.skippedDuplicateEntries !== undefined
+                ? { skippedDuplicateEntries: result.metrics.skippedDuplicateEntries }
+                : {}),
+            ...(result.metrics?.maxLineLength !== undefined
+                ? { maxLineLength: result.metrics.maxLineLength }
+                : {}),
+            heapUsedBefore: memoryBefore.heapUsed,
+            heapUsedAfter: memoryAfter.heapUsed,
+            rssBefore: memoryBefore.rss,
+            rssAfter: memoryAfter.rss,
+            ...(request.limits?.recycleAfterLineBytes !== undefined &&
+                result.metrics?.maxLineLength !== undefined &&
+                result.metrics.maxLineLength >= request.limits.recycleAfterLineBytes
+                ? {
+                    recycleRecommended: true,
+                    recycleReason: "large_line",
+                }
+                : {}),
+        };
+        return {
+            type: "result",
+            requestId: request.requestId,
+            status: result.summary ? "ok" : "empty",
+            summary: result.summary,
+            metrics,
+        };
+    }
+    catch (error) {
+        const memoryAfter = process.memoryUsage();
+        return {
+            type: "result",
+            requestId: request.requestId,
+            status: "error",
+            summary: null,
+            metrics: {
+                provider: request.provider,
+                sessionId: request.sessionId,
+                filePath: request.filePath,
+                fileSize: request.stats.size,
+                fileMtimeMs: request.stats.mtimeMs,
+                workerPid: process.pid,
+                nodeVersion: process.version,
+                durationMs: Date.now() - startedAt,
+                heapUsedBefore: memoryBefore.heapUsed,
+                heapUsedAfter: memoryAfter.heapUsed,
+                rssBefore: memoryBefore.rss,
+                rssAfter: memoryAfter.rss,
+            },
+            error: sanitizeSummaryParserError(error),
+        };
+    }
+}
+//# sourceMappingURL=summary-parser-worker-runner.js.map

package/dist/sessions/summary-parser-worker-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-parser-worker-runner.js","sourceRoot":"","sources":["../../src/sessions/summary-parser-worker-runner.ts"],"names":[],"mappings":"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"}

package/dist/sessions/types.d.ts

@@ -13,6 +13,18 @@ export interface GetSessionOptions {
     /** Include orphaned tool use detection (default: true, only applicable for Claude) */
     includeOrphans?: boolean;
 }
+export type SessionSummaryReadMode = "full" | "head";
+/**
+ * Options for reading summary metadata.
+ */
+export interface GetSessionSummaryOptions {
+    /**
+     * `head` permits a provider to stop after stable head metadata. It preserves
+     * the SessionSummary wire shape but may omit tail-derived optional fields
+     * such as contextUsage and may use a minimal compatible messageCount.
+     */
+    readMode?: SessionSummaryReadMode;
+}
 export interface LoadedSession {
     summary: SessionSummary;
     data: UnifiedSession;
@@ -24,14 +36,25 @@ export interface LoadedSession {
  * For example, ClaudeSessionReader has getAgentSession() for subagent support.
  */
 export interface ISessionReader {
+    /**
+     * Release any reader-owned resources such as parser child processes.
+     */
+    close?(): void | Promise<void>;
     /**
      * List all sessions in this reader's session directory.
      */
     listSessions(projectId: UrlProjectId): Promise<SessionSummary[]>;
+    /**
+     * Fast, on-demand recompute of the hover-card recent-activity excerpt
+     * (last regular agent turn) for one session, without a full parse. Optional:
+     * providers that do not populate `SessionSummary.lastAgentText` omit it.
+     * See topics/session-hovercard-recent-activity.md.
+     */
+    getLastAgentExcerpt?(sessionId: string): Promise<string | undefined>;
     /**
      * Get summary metadata for a single session.
      */
-    getSessionSummary(sessionId: string, projectId: UrlProjectId): Promise<SessionSummary | null>;
+    getSessionSummary(sessionId: string, projectId: UrlProjectId, options?: GetSessionSummaryOptions): Promise<SessionSummary | null>;
     /**
      * Get full session with messages.
      * @param sessionId - The session ID
@@ -86,12 +109,18 @@ export interface ISessionReader {
      *
      * When not implemented, the index service falls back to JSONL
      * filename-based enumeration.
+     *
+     * `sharedFilePath: true` marks an entry whose filePath is a container
+     * shared by many sessions (e.g. a provider database). Its stat mtime/size
+     * say nothing about this session, so the index must validate it through
+     * getSessionSummaryIfChanged instead of comparing file stats.
      */
     listSessionFiles?(sessionDir: string, options?: {
         activeAfterMs?: number;
     }): Promise<{
         sessionId: string;
         filePath: string;
+        sharedFilePath?: boolean;
     }[]>;
     /**
      * Return a stable cache/index scope key for this reader.

package/dist/sessions/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEjE;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,0BAA0B,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAEtE;;;;OAIG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,gBAAgB,CAAC,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAEtD;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEjE;;;;;OAKG;IACH,mBAAmB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElC;;;;;;OAMG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,0BAA0B,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,gBAAgB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAEtE;;;;OAIG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/D;;;;;;;;;;;;OAYG;IACH,gBAAgB,CAAC,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CACR;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CACpE,CAAC;IAEF;;;;;;;OAOG;IACH,gBAAgB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C"}

package/dist/startupEnv.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeStartupEnv(env?: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=startupEnv.d.ts.map

package/dist/startupEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupEnv.d.ts","sourceRoot":"","sources":["../src/startupEnv.ts"],"names":[],"mappings":"AAoFA,wBAAgB,mBAAmB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,IAAI,CAkBN"}

package/dist/startupEnv.js

@@ -0,0 +1,97 @@
+import { normalizeYaClientBaseUrlFromShareViewerUrl } from "../bundled/@yep-anywhere/shared/dist/index.js";
+/**
+ * Startup environment migrations. Canonical names always win. Legacy names
+ * are removed even when ignored so the live environment has one spelling.
+ */
+const STARTUP_ENV_COMPAT = [
+    {
+        canonical: "YEP_DATA_DIR",
+        legacy: ["YEP_ANYWHERE_DATA_DIR"],
+    },
+    {
+        canonical: "YEP_PROFILE",
+        legacy: ["YEP_ANYWHERE_PROFILE"],
+    },
+    {
+        canonical: "YEP_VOICE_BACKENDS",
+        legacy: ["YA_VOICE_BACKENDS"],
+    },
+    {
+        canonical: "YEP_DEFERRED_JOIN_WINDOW_S",
+        legacy: ["YA_DEFERRED_JOIN_WINDOW_S"],
+    },
+    {
+        canonical: "YEP_COMPOSE_ANCHORS",
+        legacy: ["YA_COMPOSE_ANCHORS"],
+    },
+    {
+        canonical: "YEP_STT_XAI_API_KEY",
+        legacy: ["YA_stt__XAI_API_KEY"],
+    },
+    {
+        canonical: "YEP_STT_DEEPGRAM_API_KEY",
+        legacy: ["YA_stt__DEEPGRAM_API_KEY"],
+    },
+    {
+        canonical: "YEP_STT_SHARE_XAI_KEY_WITH_CLIENTS",
+        legacy: ["YA_stt__SHARE_XAI_KEY_WITH_CLIENTS"],
+    },
+    {
+        canonical: "YEP_CODEX_DISABLE_LIVE_DELTAS",
+        legacy: ["YA_CODEX_DISABLE_LIVE_DELTAS"],
+    },
+    {
+        canonical: "YEP_CLIENT_BASE_URL",
+        legacy: [
+            "YEP_YA_CLIENT_BASE_URL",
+            "YEP_PUBLIC_SHARE_VIEWER_BASE_URL",
+            "YEP_PUBLIC_SHARE_ORIGIN",
+        ],
+        normalizeLegacy(value, legacyName) {
+            if (legacyName !== "YEP_PUBLIC_SHARE_VIEWER_BASE_URL") {
+                return value;
+            }
+            try {
+                return normalizeYaClientBaseUrlFromShareViewerUrl(value);
+            }
+            catch {
+                // Preserve invalid input for the existing settings/status validation
+                // path instead of turning compatibility normalization into a new
+                // startup failure.
+                return value;
+            }
+        },
+    },
+    {
+        canonical: "YEP_ORIGINAL_BASH_ENV",
+        legacy: ["YEP_ANYWHERE_ORIGINAL_BASH_ENV"],
+    },
+    {
+        canonical: "YEP_ALLOW_SUSPICIOUS_HOME",
+        legacy: ["YEP_ANYWHERE_ALLOW_SUSPICIOUS_HOME"],
+    },
+    {
+        canonical: "PI_EXECUTABLE",
+        legacy: ["PI_PATH"],
+    },
+];
+export function normalizeStartupEnv(env = process.env) {
+    for (const alias of STARTUP_ENV_COMPAT) {
+        if (env[alias.canonical] === undefined) {
+            const legacyName = alias.legacy.find((name) => env[name] !== undefined);
+            if (legacyName) {
+                const value = env[legacyName];
+                if (value !== undefined) {
+                    env[alias.canonical] = alias.normalizeLegacy
+                        ? alias.normalizeLegacy(value, legacyName)
+                        : value;
+                }
+            }
+        }
+        for (const legacyName of alias.legacy) {
+            delete env[legacyName];
+        }
+    }
+}
+normalizeStartupEnv();
+//# sourceMappingURL=startupEnv.js.map

package/dist/startupEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupEnv.js","sourceRoot":"","sources":["../src/startupEnv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0CAA0C,EAAE,MAAM,sBAAsB,CAAC;AAQlF;;;GAGG;AACH,MAAM,kBAAkB,GAAwB;IAC9C;QACE,SAAS,EAAE,cAAc;QACzB,MAAM,EAAE,CAAC,uBAAuB,CAAC;KAClC;IACD;QACE,SAAS,EAAE,aAAa;QACxB,MAAM,EAAE,CAAC,sBAAsB,CAAC;KACjC;IACD;QACE,SAAS,EAAE,oBAAoB;QAC/B,MAAM,EAAE,CAAC,mBAAmB,CAAC;KAC9B;IACD;QACE,SAAS,EAAE,4BAA4B;QACvC,MAAM,EAAE,CAAC,2BAA2B,CAAC;KACtC;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,MAAM,EAAE,CAAC,oBAAoB,CAAC;KAC/B;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,MAAM,EAAE,CAAC,qBAAqB,CAAC;KAChC;IACD;QACE,SAAS,EAAE,0BAA0B;QACrC,MAAM,EAAE,CAAC,0BAA0B,CAAC;KACrC;IACD;QACE,SAAS,EAAE,oCAAoC;QAC/C,MAAM,EAAE,CAAC,oCAAoC,CAAC;KAC/C;IACD;QACE,SAAS,EAAE,+BAA+B;QAC1C,MAAM,EAAE,CAAC,8BAA8B,CAAC;KACzC;IACD;QACE,SAAS,EAAE,qBAAqB;QAChC,MAAM,EAAE;YACN,wBAAwB;YACxB,kCAAkC;YAClC,yBAAyB;SAC1B;QACD,eAAe,CAAC,KAAK,EAAE,UAAU;YAC/B,IAAI,UAAU,KAAK,kCAAkC,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,0CAA0C,CAAC,KAAK,CAAC,CAAC;YAC3D,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,iEAAiE;gBACjE,mBAAmB;gBACnB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF;IACD;QACE,SAAS,EAAE,uBAAuB;QAClC,MAAM,EAAE,CAAC,gCAAgC,CAAC;KAC3C;IACD;QACE,SAAS,EAAE,2BAA2B;QACtC,MAAM,EAAE,CAAC,oCAAoC,CAAC;KAC/C;IACD;QACE,SAAS,EAAE,eAAe;QAC1B,MAAM,EAAE,CAAC,SAAS,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,MAAyB,OAAO,CAAC,GAAG;IAEpC,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;YACxE,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,eAAe;wBAC1C,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC;wBAC1C,CAAC,CAAC,KAAK,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC;AAED,mBAAmB,EAAE,CAAC"}

package/dist/subscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAiCD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAkOzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmCzB"}
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../src/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAiCD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA6OzB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,mBAAmB,GAC5B;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAmCzB"}

package/dist/subscriptions.js

@@ -58,6 +58,12 @@ export function createSessionSubscription(process, emit, options) {
             return augmenter;
         if (!augmenterPromise) {
             augmenterPromise = createStreamAugmenter({
+                safeMarkdownOptions: {
+                    projectFileLinks: {
+                        projectId: process.projectId,
+                        projectPath: process.projectPath,
+                    },
+                },
                 onMarkdownAugment: (data) => {
                     if (!completed)
                         emit("markdown-augment", data);
@@ -75,6 +81,15 @@ export function createSessionSubscription(process, emit, options) {
         augmenter = await augmenterPromise;
         return augmenter;
     };
+    const emitStatus = (state) => {
+        emit("status", {
+            sessionId: process.sessionId,
+            state: state.type,
+            liveness: process.getLivenessSnapshot(),
+            providerRuntimeStatus: process.getProviderRuntimeStatus(),
+            ...(state.type === "waiting-input" ? { request: state.request } : {}),
+        });
+    };
     // Heartbeat
     const heartbeatInterval = setInterval(() => {
         try {
@@ -136,25 +151,14 @@ export function createSessionSubscription(process, emit, options) {
                     break;
                 }
                 case "state-change":
-                    emit("status", {
-                        state: event.state.type,
-                        liveness: process.getLivenessSnapshot(),
-                        ...(event.state.type === "waiting-input"
-                            ? { request: event.state.request }
-                            : {}),
-                    });
+                    emitStatus(event.state);
                     break;
-                case "liveness-update": {
-                    const currentState = process.state;
-                    emit("status", {
-                        state: currentState.type,
-                        liveness: process.getLivenessSnapshot(),
-                        ...(currentState.type === "waiting-input"
-                            ? { request: currentState.request }
-                            : {}),
-                    });
+                // Both refresh the same status payload from current process state;
+                // the changed value is read back off the process at emit time.
+                case "liveness-update":
+                case "provider-runtime-status-change":
+                    emitStatus(process.state);
                     break;
-                }
                 case "mode-change":
                     emit("mode-change", {
                         permissionMode: event.mode,
@@ -181,7 +185,10 @@ export function createSessionSubscription(process, emit, options) {
                     if (augmenter) {
                         await augmenter.flush();
                     }
-                    emit("complete", { timestamp: new Date().toISOString() });
+                    emit("complete", {
+                        sessionId: process.sessionId,
+                        timestamp: new Date().toISOString(),
+                    });
                     completed = true;
                     clearInterval(heartbeatInterval);
                     break;
@@ -200,9 +207,12 @@ export function createSessionSubscription(process, emit, options) {
         state: currentState.type,
         permissionMode: process.permissionMode,
         modeVersion: process.modeVersion,
+        recapAfterSeconds: process.recapAfterSeconds,
+        recapMode: process.recapMode,
         provider: process.provider,
         model: process.resolvedModel,
         liveness: process.getLivenessSnapshot(),
+        providerRuntimeStatus: process.getProviderRuntimeStatus(),
         ...(currentState.type === "waiting-input"
             ? { request: currentState.request }
             : {}),