@evalops/maestro 0.10.8 → 0.10.10

package/dist/server/session-scope.js

@@ -1,7 +1,9 @@
+import { isDatabaseConfigured } from "../db/client.js";
 import { SessionManager } from "../session/manager.js";
 import { decodeScopedSessionId, encodeScopedSessionId, sanitizeSessionScope, } from "../session/scope.js";
 import { getArtifactAccessGrantFromRequest } from "./artifact-access.js";
-import { getAuthSubject } from "./authz.js";
+import { getAuthScopeKey, getAuthSubject } from "./authz.js";
+import { HostedSessionManager } from "./hosted-session-manager.js";
 import { getRequestToken } from "./server-utils.js";
 const SESSION_SCOPE_MODE = (process.env.MAESTRO_SESSION_SCOPE ||
     process.env.MAESTRO_MULTI_USER ||
@@ -20,10 +22,10 @@ export function resolveSessionScope(req) {
     }
     if (!getRequestToken(req))
         return null;
-    const subject = getAuthSubject(req);
-    if (!subject)
+    const scopeKey = getAuthScopeKey(req);
+    if (!scopeKey)
         return null;
-    return sanitizeSessionScope(subject) || null;
+    return sanitizeSessionScope(scopeKey) || null;
 }
 export function createSessionManagerForRequest(req, continueSession = true, customSessionPath) {
     return createSessionManagerForScope(resolveSessionScope(req), continueSession, customSessionPath);
@@ -37,4 +39,42 @@ export function createSessionManagerForScope(scope, continueSession = true, cust
     }
     return new SessionManager(continueSession, customSessionPath);
 }
+function getHostedSessionStorageMode() {
+    return (process.env.MAESTRO_HOSTED_SESSION_STORAGE ??
+        process.env.MAESTRO_SESSION_STORAGE ??
+        "")
+        .trim()
+        .toLowerCase();
+}
+function shouldUseHostedDatabaseSessions(scope) {
+    if (!scope)
+        return false;
+    const mode = getHostedSessionStorageMode();
+    if (mode === "file" || mode === "jsonl" || mode === "filesystem") {
+        return false;
+    }
+    if (mode === "database" || mode === "db" || mode === "postgres") {
+        if (!isDatabaseConfigured()) {
+            throw new Error("MAESTRO_HOSTED_SESSION_STORAGE=database requires MAESTRO_DATABASE_URL or DATABASE_URL");
+        }
+        return true;
+    }
+    return isDatabaseConfigured();
+}
+export function createWebSessionManagerForRequest(req, continueSession = true, customSessionPath) {
+    const scope = resolveSessionScope(req);
+    if (!customSessionPath && shouldUseHostedDatabaseSessions(scope)) {
+        return new HostedSessionManager({
+            scope: scope,
+            subject: getAuthSubject(req) || undefined,
+        });
+    }
+    return createSessionManagerForScope(scope, continueSession, customSessionPath);
+}
+export function createWebSessionManagerForScope(scope, continueSession = true, customSessionPath) {
+    if (!customSessionPath && shouldUseHostedDatabaseSessions(scope)) {
+        return new HostedSessionManager({ scope: scope });
+    }
+    return createSessionManagerForScope(scope, continueSession, customSessionPath);
+}
 //# sourceMappingURL=session-scope.js.map

package/dist/server/session-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-scope.js","sourceRoot":"","sources":["../../src/server/session-scope.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACN,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,kBAAkB,GAAG,CAC1B,OAAO,CAAC,GAAG,CAAC,qBAAqB;IACjC,OAAO,CAAC,GAAG,CAAC,kBAAkB;IAC9B,EAAE,CACF;KACC,IAAI,EAAE;KACN,WAAW,EAAE,CAAC;AAEhB,MAAM,qBAAqB,GAC1B,kBAAkB,KAAK,MAAM;IAC7B,kBAAkB,KAAK,MAAM;IAC7B,kBAAkB,KAAK,GAAG,CAAC;AAE5B,MAAM,UAAU,mBAAmB,CAAC,GAAoB;IACvD,IAAI,CAAC,qBAAqB;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,cAAc,GAAG,iCAAiC,CAAC,GAAG,CAAC,CAAC;IAC9D,IAAI,cAAc,EAAE,CAAC;QACpB,OAAO,cAAc,CAAC,KAAK,IAAI,IAAI,CAAC;IACrC,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,oBAAoB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC7C,GAAoB,EACpB,eAAe,GAAG,IAAI,EACtB,iBAA0B;IAE1B,OAAO,4BAA4B,CAClC,mBAAmB,CAAC,GAAG,CAAC,EACxB,eAAe,EACf,iBAAiB,CACjB,CAAC;AACH,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,CAAC;AAExD,MAAM,UAAU,4BAA4B,CAC3C,KAAoB,EACpB,eAAe,GAAG,IAAI,EACtB,iBAA0B;IAE1B,IAAI,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,iBAAiB,EAAE;YAC7D,YAAY,EAAE,KAAK;SACnB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport { SessionManager } from \"../session/manager.js\";\nimport {\n\tdecodeScopedSessionId,\n\tencodeScopedSessionId,\n\tsanitizeSessionScope,\n} from \"../session/scope.js\";\nimport { getArtifactAccessGrantFromRequest } from \"./artifact-access.js\";\nimport { getAuthSubject } from \"./authz.js\";\nimport { getRequestToken } from \"./server-utils.js\";\n\nconst SESSION_SCOPE_MODE = (\n\tprocess.env.MAESTRO_SESSION_SCOPE ||\n\tprocess.env.MAESTRO_MULTI_USER ||\n\t\"\"\n)\n\t.trim()\n\t.toLowerCase();\n\nconst SESSION_SCOPE_ENABLED =\n\tSESSION_SCOPE_MODE === \"auth\" ||\n\tSESSION_SCOPE_MODE === \"true\" ||\n\tSESSION_SCOPE_MODE === \"1\";\n\nexport function resolveSessionScope(req: IncomingMessage): string | null {\n\tif (!SESSION_SCOPE_ENABLED) return null;\n\tconst artifactAccess = getArtifactAccessGrantFromRequest(req);\n\tif (artifactAccess) {\n\t\treturn artifactAccess.scope ?? null;\n\t}\n\tif (!getRequestToken(req)) return null;\n\tconst subject = getAuthSubject(req);\n\tif (!subject) return null;\n\treturn sanitizeSessionScope(subject) || null;\n}\n\nexport function createSessionManagerForRequest(\n\treq: IncomingMessage,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): SessionManager {\n\treturn createSessionManagerForScope(\n\t\tresolveSessionScope(req),\n\t\tcontinueSession,\n\t\tcustomSessionPath,\n\t);\n}\n\nexport { decodeScopedSessionId, encodeScopedSessionId };\n\nexport function createSessionManagerForScope(\n\tscope: string | null,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): SessionManager {\n\tif (scope) {\n\t\treturn new SessionManager(continueSession, customSessionPath, {\n\t\t\tsessionScope: scope,\n\t\t});\n\t}\n\treturn new SessionManager(continueSession, customSessionPath);\n}\n"]}
+{"version":3,"file":"session-scope.js","sourceRoot":"","sources":["../../src/server/session-scope.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport { isDatabaseConfigured } from \"../db/client.js\";\nimport { SessionManager } from \"../session/manager.js\";\nimport {\n\tdecodeScopedSessionId,\n\tencodeScopedSessionId,\n\tsanitizeSessionScope,\n} from \"../session/scope.js\";\nimport { getArtifactAccessGrantFromRequest } from \"./artifact-access.js\";\nimport { getAuthScopeKey, getAuthSubject } from \"./authz.js\";\nimport { HostedSessionManager } from \"./hosted-session-manager.js\";\nimport { getRequestToken } from \"./server-utils.js\";\n\nconst SESSION_SCOPE_MODE = (\n\tprocess.env.MAESTRO_SESSION_SCOPE ||\n\tprocess.env.MAESTRO_MULTI_USER ||\n\t\"\"\n)\n\t.trim()\n\t.toLowerCase();\n\nconst SESSION_SCOPE_ENABLED =\n\tSESSION_SCOPE_MODE === \"auth\" ||\n\tSESSION_SCOPE_MODE === \"true\" ||\n\tSESSION_SCOPE_MODE === \"1\";\n\nexport function resolveSessionScope(req: IncomingMessage): string | null {\n\tif (!SESSION_SCOPE_ENABLED) return null;\n\tconst artifactAccess = getArtifactAccessGrantFromRequest(req);\n\tif (artifactAccess) {\n\t\treturn artifactAccess.scope ?? null;\n\t}\n\tif (!getRequestToken(req)) return null;\n\tconst scopeKey = getAuthScopeKey(req);\n\tif (!scopeKey) return null;\n\treturn sanitizeSessionScope(scopeKey) || null;\n}\n\nexport function createSessionManagerForRequest(\n\treq: IncomingMessage,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): SessionManager {\n\treturn createSessionManagerForScope(\n\t\tresolveSessionScope(req),\n\t\tcontinueSession,\n\t\tcustomSessionPath,\n\t);\n}\n\nexport { decodeScopedSessionId, encodeScopedSessionId };\n\nexport function createSessionManagerForScope(\n\tscope: string | null,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): SessionManager {\n\tif (scope) {\n\t\treturn new SessionManager(continueSession, customSessionPath, {\n\t\t\tsessionScope: scope,\n\t\t});\n\t}\n\treturn new SessionManager(continueSession, customSessionPath);\n}\n\nexport type WebSessionManager = SessionManager | HostedSessionManager;\n\nfunction getHostedSessionStorageMode(): string {\n\treturn (\n\t\tprocess.env.MAESTRO_HOSTED_SESSION_STORAGE ??\n\t\tprocess.env.MAESTRO_SESSION_STORAGE ??\n\t\t\"\"\n\t)\n\t\t.trim()\n\t\t.toLowerCase();\n}\n\nfunction shouldUseHostedDatabaseSessions(scope: string | null): boolean {\n\tif (!scope) return false;\n\tconst mode = getHostedSessionStorageMode();\n\tif (mode === \"file\" || mode === \"jsonl\" || mode === \"filesystem\") {\n\t\treturn false;\n\t}\n\tif (mode === \"database\" || mode === \"db\" || mode === \"postgres\") {\n\t\tif (!isDatabaseConfigured()) {\n\t\t\tthrow new Error(\n\t\t\t\t\"MAESTRO_HOSTED_SESSION_STORAGE=database requires MAESTRO_DATABASE_URL or DATABASE_URL\",\n\t\t\t);\n\t\t}\n\t\treturn true;\n\t}\n\treturn isDatabaseConfigured();\n}\n\nexport function createWebSessionManagerForRequest(\n\treq: IncomingMessage,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): WebSessionManager {\n\tconst scope = resolveSessionScope(req);\n\tif (!customSessionPath && shouldUseHostedDatabaseSessions(scope)) {\n\t\treturn new HostedSessionManager({\n\t\t\tscope: scope!,\n\t\t\tsubject: getAuthSubject(req) || undefined,\n\t\t});\n\t}\n\treturn createSessionManagerForScope(\n\t\tscope,\n\t\tcontinueSession,\n\t\tcustomSessionPath,\n\t);\n}\n\nexport function createWebSessionManagerForScope(\n\tscope: string | null,\n\tcontinueSession = true,\n\tcustomSessionPath?: string,\n): WebSessionManager {\n\tif (!customSessionPath && shouldUseHostedDatabaseSessions(scope)) {\n\t\treturn new HostedSessionManager({ scope: scope! });\n\t}\n\treturn createSessionManagerForScope(\n\t\tscope,\n\t\tcontinueSession,\n\t\tcustomSessionPath,\n\t);\n}\n"]}

package/dist/server/session-timeline.d.ts

@@ -0,0 +1,13 @@
+import type { ComposerPendingRequest, ComposerRunTimelineResponse } from "@evalops/contracts";
+import type { AppMessage } from "../agent/types.js";
+import type { SessionEntry } from "../session/types.js";
+interface BuildComposerRunTimelineOptions {
+    sessionId: string;
+    entries?: SessionEntry[];
+    messages?: AppMessage[];
+    pendingRequests?: ComposerPendingRequest[];
+    generatedAt?: string;
+}
+export declare function buildComposerRunTimeline(options: BuildComposerRunTimelineOptions): ComposerRunTimelineResponse;
+export {};
+//# sourceMappingURL=session-timeline.d.ts.map

package/dist/server/session-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-timeline.d.ts","sourceRoot":"","sources":["../../src/server/session-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EAGtB,2BAA2B,EAE3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACX,UAAU,EAIV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD,UAAU,+BAA+B;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAioBD,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,+BAA+B,GACtC,2BAA2B,CA+C7B"}

package/dist/server/session-timeline.js

@@ -0,0 +1,566 @@
+import { getDiagnosticDeltaFromToolResult } from "../lsp/diagnostic-repair.js";
+import { getSkillArtifactMetadataFromDetails } from "../skills/artifact-metadata.js";
+import { compactTimelineMetadata, compactTimelineSummary, redactTimelineSecrets, } from "../timeline/redaction.js";
+function normalizeTimestamp(value, fallback) {
+    if (typeof value === "string" || typeof value === "number") {
+        const date = new Date(value);
+        if (!Number.isNaN(date.getTime())) {
+            return date.toISOString();
+        }
+    }
+    return fallback;
+}
+function detailsRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+function redactedString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? redactTimelineSecrets(trimmed) : undefined;
+}
+function finiteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function booleanValue(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function textFromContent(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return undefined;
+    const text = content
+        .map((block) => {
+        if (!block || typeof block !== "object")
+            return "";
+        const typed = block;
+        if (typed.type === "text" && typeof typed.text === "string") {
+            return typed.text;
+        }
+        return "";
+    })
+        .filter(Boolean)
+        .join(" ");
+    return text || undefined;
+}
+function getToolPath(request) {
+    const args = request?.args;
+    return redactedString(args?.path) ?? redactedString(args?.file_path);
+}
+function governedToolMetadata(details) {
+    const record = detailsRecord(details);
+    const outcome = detailsRecord(record?.governedOutcome);
+    if (!outcome)
+        return {};
+    const classification = redactedString(outcome.classification);
+    return {
+        errorCode: redactedString(outcome.code) ?? classification,
+        approvalRequestId: redactedString(outcome.approvalRequestId),
+        governedOutcome: classification,
+    };
+}
+function timelineStatusForGovernedOutcome(outcome) {
+    switch (outcome) {
+        case "denied":
+            return "denied";
+        case "approval_required":
+        case "approval_pending":
+        case "authentication_required":
+        case "rate_limited":
+            return "pending";
+        default:
+            return "info";
+    }
+}
+function addDerivedToolResultItems(items, sessionId, toolResult, options) {
+    const details = detailsRecord(toolResult.details);
+    const normalizedToolName = toolResult.toolName.toLowerCase();
+    if (!toolResult.isError &&
+        (normalizedToolName === "write" || normalizedToolName === "edit")) {
+        const displayPath = getToolPath(options.request);
+        const previousExists = booleanValue(details?.previousExists);
+        const editsApplied = finiteNumber(details?.editsApplied);
+        const bytesWritten = finiteNumber(details?.bytesWritten);
+        const action = normalizedToolName === "write"
+            ? previousExists === false
+                ? "created"
+                : "wrote"
+            : "edited";
+        const summary = compactTimelineSummary([
+            displayPath,
+            bytesWritten !== undefined ? `${bytesWritten} bytes` : undefined,
+            editsApplied !== undefined ? `${editsApplied} edits` : undefined,
+        ]
+            .filter(Boolean)
+            .join(" | "));
+        const hasDiff = typeof details?.diff === "string" && details.diff.length > 0;
+        const metadata = compactTimelineMetadata({
+            path: displayPath,
+            action,
+            previousExists,
+            bytesWritten,
+            editsApplied,
+            hasDiff,
+        });
+        appendItem(items, {
+            id: `file-change:${options.baseId}:${toolResult.toolCallId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "file.changed",
+            title: `File ${action}`,
+            visibility: "user",
+            source: options.source,
+            status: "completed",
+            toolCallId: toolResult.toolCallId,
+            toolName: toolResult.toolName,
+            ...(summary ? { summary } : {}),
+            ...(metadata ? { metadata } : {}),
+        });
+    }
+    const diagnosticDelta = getDiagnosticDeltaFromToolResult(toolResult);
+    if (diagnosticDelta) {
+        const summary = compactTimelineSummary(`Diagnostic delta: ${diagnosticDelta.introducedCount} introduced, ${diagnosticDelta.repairedCount} repaired, ${diagnosticDelta.remainingCount} remaining.`);
+        appendItem(items, {
+            id: `diagnostic-delta:${options.baseId}:${toolResult.toolCallId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "diagnostic.delta",
+            title: `Diagnostics for ${diagnosticDelta.displayPath}`,
+            visibility: "user",
+            source: options.source,
+            status: diagnosticDelta.introducedCount > 0 ? "failed" : "completed",
+            toolCallId: toolResult.toolCallId,
+            toolName: toolResult.toolName,
+            ...(summary ? { summary } : {}),
+            metadata: {
+                displayPath: diagnosticDelta.displayPath,
+                usedDelta: diagnosticDelta.usedDelta,
+                introducedCount: diagnosticDelta.introducedCount,
+                repairedCount: diagnosticDelta.repairedCount,
+                remainingCount: diagnosticDelta.remainingCount,
+                fingerprint: diagnosticDelta.fingerprint,
+                shouldFollowUp: diagnosticDelta.repair.shouldFollowUp,
+                maxAttempts: diagnosticDelta.repair.maxAttempts,
+            },
+        });
+    }
+    const skillMetadata = getSkillArtifactMetadataFromDetails(toolResult.details);
+    if (skillMetadata) {
+        const summary = compactTimelineSummary([
+            skillMetadata.name,
+            skillMetadata.version ? `v${skillMetadata.version}` : undefined,
+            skillMetadata.source,
+            skillMetadata.scope,
+        ]
+            .filter(Boolean)
+            .join(" | "));
+        const metadata = compactTimelineMetadata({
+            name: skillMetadata.name,
+            version: skillMetadata.version,
+            source: skillMetadata.source,
+            scope: skillMetadata.scope,
+            workspaceId: skillMetadata.workspaceId,
+            ownerId: skillMetadata.ownerId,
+            hash: skillMetadata.hash,
+        });
+        appendItem(items, {
+            id: `artifact-linked:${options.baseId}:${toolResult.toolCallId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "artifact.linked",
+            title: `Skill artifact loaded: ${skillMetadata.name}`,
+            visibility: "admin",
+            source: options.source,
+            status: "completed",
+            toolCallId: toolResult.toolCallId,
+            toolName: toolResult.toolName,
+            ...(skillMetadata.artifactId
+                ? { artifactId: skillMetadata.artifactId }
+                : {}),
+            ...(summary ? { summary } : {}),
+            ...(metadata ? { metadata } : {}),
+        });
+    }
+    const governed = governedToolMetadata(toolResult.details);
+    if (governed.governedOutcome || governed.errorCode) {
+        const summary = compactTimelineSummary([
+            governed.governedOutcome
+                ? `Outcome: ${governed.governedOutcome}`
+                : undefined,
+            governed.errorCode ? `Code: ${governed.errorCode}` : undefined,
+        ]
+            .filter(Boolean)
+            .join(" | "));
+        const metadata = compactTimelineMetadata({
+            governedOutcome: governed.governedOutcome,
+            errorCode: governed.errorCode,
+        });
+        appendItem(items, {
+            id: `policy-decision:${options.baseId}:${toolResult.toolCallId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "policy.decision",
+            title: `Policy decision for ${toolResult.toolName}`,
+            visibility: governed.governedOutcome === "denied" ? "user" : "admin",
+            source: options.source,
+            status: timelineStatusForGovernedOutcome(governed.governedOutcome),
+            toolCallId: toolResult.toolCallId,
+            toolName: toolResult.toolName,
+            ...(governed.approvalRequestId
+                ? { approvalRequestId: governed.approvalRequestId }
+                : {}),
+            ...(summary ? { summary } : {}),
+            ...(metadata ? { metadata } : {}),
+        });
+    }
+}
+function appendItem(items, item) {
+    items.push(item);
+}
+function addMessageItems(items, sessionId, message, options) {
+    if (message.role === "user") {
+        const userMessage = message;
+        const summary = compactTimelineSummary(textFromContent(userMessage.content));
+        appendItem(items, {
+            id: `message:${options.baseId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "message.user",
+            title: "User message",
+            visibility: "user",
+            source: options.source,
+            role: "user",
+            status: "completed",
+            ...(summary ? { summary } : {}),
+        });
+        return;
+    }
+    if (message.role === "assistant") {
+        const assistantMessage = message;
+        const summary = compactTimelineSummary(textFromContent(assistantMessage.content));
+        appendItem(items, {
+            id: `message:${options.baseId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: "message.assistant",
+            title: "Assistant response",
+            visibility: "user",
+            source: options.source,
+            role: "assistant",
+            status: assistantMessage.stopReason === "error" ? "failed" : "completed",
+            ...(summary ? { summary } : {}),
+            ...(assistantMessage.model
+                ? { metadata: { model: assistantMessage.model } }
+                : {}),
+        });
+        for (const block of assistantMessage.content) {
+            if (block.type !== "toolCall")
+                continue;
+            options.context?.toolRequests.set(block.id, {
+                name: block.name,
+                args: block.arguments,
+            });
+            appendItem(items, {
+                id: `tool-requested:${options.baseId}:${block.id}`,
+                sessionId,
+                timestamp: options.timestamp,
+                type: "tool.requested",
+                title: `Requested ${block.name}`,
+                visibility: "user",
+                source: options.source,
+                status: "running",
+                toolCallId: block.id,
+                toolName: block.name,
+            });
+        }
+        return;
+    }
+    if (message.role === "toolResult") {
+        const toolResult = message;
+        const details = detailsRecord(toolResult.details);
+        const governed = governedToolMetadata(toolResult.details);
+        const request = options.context?.toolRequests.get(toolResult.toolCallId);
+        const approvalRequestId = governed.approvalRequestId ?? redactedString(details?.approvalRequestId);
+        const toolExecutionId = redactedString(details?.toolExecutionId);
+        const metadata = compactTimelineMetadata({
+            governedOutcome: governed.governedOutcome,
+            errorCode: governed.errorCode,
+        });
+        appendItem(items, {
+            id: `tool-result:${options.baseId}:${toolResult.toolCallId}`,
+            sessionId,
+            timestamp: options.timestamp,
+            type: toolResult.isError ? "tool.failed" : "tool.completed",
+            title: `${toolResult.toolName} ${toolResult.isError ? "failed" : "completed"}`,
+            visibility: "user",
+            source: options.source,
+            role: "tool",
+            status: toolResult.isError ? "failed" : "completed",
+            toolCallId: toolResult.toolCallId,
+            toolName: toolResult.toolName,
+            ...(approvalRequestId ? { approvalRequestId } : {}),
+            ...(toolExecutionId ? { toolExecutionId } : {}),
+            ...(metadata ? { metadata } : {}),
+        });
+        addDerivedToolResultItems(items, sessionId, toolResult, {
+            baseId: options.baseId,
+            timestamp: options.timestamp,
+            source: options.source,
+            request,
+        });
+    }
+}
+function statusForPendingRequest(request) {
+    return request.status === "pending" ? "pending" : "info";
+}
+function platformOperationForPending(request) {
+    if (!request.platform)
+        return undefined;
+    if (request.kind === "approval") {
+        return request.platform.source === "tool_execution"
+            ? "ResumeToolExecution"
+            : "ResolveApproval";
+    }
+    if (request.kind === "client_tool" ||
+        request.kind === "mcp_elicitation" ||
+        request.kind === "user_input") {
+        return "ResumeRun";
+    }
+    return undefined;
+}
+function pendingRequestTitle(request) {
+    const label = request.displayName ||
+        request.summaryLabel ||
+        request.toolName ||
+        "request";
+    switch (request.kind) {
+        case "approval":
+            return `Waiting for approval: ${label}`;
+        case "tool_retry":
+            return `Waiting for retry decision: ${label}`;
+        case "client_tool":
+            return `Waiting for client tool: ${label}`;
+        case "mcp_elicitation":
+            return "Waiting for MCP input";
+        case "user_input":
+            return "Waiting for user input";
+    }
+}
+function addPendingRequestItems(items, sessionId, pendingRequests, generatedAt) {
+    for (const request of pendingRequests) {
+        const summary = compactTimelineSummary(request.actionDescription || request.summaryLabel || request.reason);
+        const platformOperation = platformOperationForPending(request);
+        appendItem(items, {
+            id: `pending:${request.id}`,
+            sessionId,
+            timestamp: normalizeTimestamp(request.createdAt, generatedAt),
+            type: "wait.pending",
+            title: pendingRequestTitle(request),
+            visibility: "user",
+            source: request.source,
+            status: statusForPendingRequest(request),
+            toolCallId: request.toolCallId,
+            toolName: request.toolName,
+            pendingRequestId: request.id,
+            pendingRequestKind: request.kind,
+            ...(summary ? { summary } : {}),
+            ...(request.platform?.approvalRequestId
+                ? { approvalRequestId: request.platform.approvalRequestId }
+                : {}),
+            ...(request.platform?.toolExecutionId
+                ? { toolExecutionId: request.platform.toolExecutionId }
+                : {}),
+            ...(request.platform ? { platform: request.platform } : {}),
+            ...(platformOperation ? { platformOperation } : {}),
+        });
+    }
+}
+function addEntryItems(items, sessionId, entries, generatedAt, context) {
+    let messageEntryCount = 0;
+    for (const [index, entry] of entries.entries()) {
+        const timestamp = normalizeTimestamp(entry.timestamp, generatedAt);
+        switch (entry.type) {
+            case "session": {
+                appendItem(items, {
+                    id: `session-started:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "session.started",
+                    title: "Session started",
+                    visibility: "user",
+                    source: "local",
+                    status: "info",
+                    ...(entry.cwd ? { metadata: { cwd: entry.cwd } } : {}),
+                });
+                break;
+            }
+            case "session_meta": {
+                const summary = compactTimelineSummary(entry.title || entry.resumeSummary || entry.summary);
+                appendItem(items, {
+                    id: `session-updated:${index}`,
+                    sessionId,
+                    timestamp,
+                    type: "session.updated",
+                    title: "Session metadata updated",
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                });
+                break;
+            }
+            case "message": {
+                messageEntryCount += 1;
+                addMessageItems(items, sessionId, entry.message, {
+                    baseId: entry.id,
+                    timestamp,
+                    source: "local",
+                    context,
+                });
+                break;
+            }
+            case "compaction": {
+                const summary = compactTimelineSummary(entry.summary);
+                appendItem(items, {
+                    id: `compaction:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "compaction.created",
+                    title: "Context compacted",
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                    metadata: {
+                        tokensBefore: entry.tokensBefore,
+                        auto: entry.auto === true,
+                        fromHook: entry.fromHook === true,
+                    },
+                });
+                break;
+            }
+            case "branch_summary": {
+                const summary = compactTimelineSummary(entry.summary);
+                appendItem(items, {
+                    id: `branch:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "branch.created",
+                    title: "Branch summary created",
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                    metadata: { fromId: entry.fromId },
+                });
+                break;
+            }
+            case "model_change": {
+                const summary = compactTimelineSummary(entry.model);
+                appendItem(items, {
+                    id: `model-change:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "model.changed",
+                    title: "Model changed",
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                });
+                break;
+            }
+            case "thinking_level_change": {
+                const summary = compactTimelineSummary(entry.thinkingLevel);
+                appendItem(items, {
+                    id: `thinking-change:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "thinking.changed",
+                    title: "Thinking level changed",
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                });
+                break;
+            }
+            case "custom_message": {
+                if (!entry.display)
+                    break;
+                const summary = compactTimelineSummary(textFromContent(entry.content));
+                appendItem(items, {
+                    id: `custom-message:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "custom.event",
+                    title: entry.customType,
+                    visibility: "admin",
+                    source: "local",
+                    status: "info",
+                    ...(summary ? { summary } : {}),
+                });
+                break;
+            }
+            case "custom": {
+                appendItem(items, {
+                    id: `custom:${entry.id}`,
+                    sessionId,
+                    timestamp,
+                    type: "custom.event",
+                    title: entry.customType,
+                    visibility: "audit",
+                    source: "local",
+                    status: "info",
+                });
+                break;
+            }
+        }
+    }
+    return messageEntryCount;
+}
+function sortItems(items) {
+    return [...items].sort((a, b) => {
+        const timestampDelta = new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime();
+        if (timestampDelta !== 0)
+            return timestampDelta;
+        return a.id.localeCompare(b.id);
+    });
+}
+export function buildComposerRunTimeline(options) {
+    const generatedAt = options.generatedAt ?? new Date().toISOString();
+    const items = [];
+    const entries = options.entries ?? [];
+    const messages = options.messages ?? [];
+    const pendingRequests = options.pendingRequests ?? [];
+    const context = {
+        toolRequests: new Map(),
+    };
+    const messageEntryCount = addEntryItems(items, options.sessionId, entries, generatedAt, context);
+    if (messageEntryCount === 0) {
+        for (const [index, message] of messages.entries()) {
+            addMessageItems(items, options.sessionId, message, {
+                baseId: `fallback-${index}`,
+                timestamp: normalizeTimestamp(message.timestamp, generatedAt),
+                source: "local",
+                context,
+            });
+        }
+    }
+    addPendingRequestItems(items, options.sessionId, pendingRequests, generatedAt);
+    return {
+        sessionId: options.sessionId,
+        source: "local",
+        generatedAt,
+        platformBacked: false,
+        pendingRequestCount: pendingRequests.length,
+        items: sortItems(items),
+    };
+}
+//# sourceMappingURL=session-timeline.js.map