@evalops/maestro 0.10.18 → 0.10.21

package/dist/server/agent-trajectory.d.ts

@@ -0,0 +1,50 @@
+import type { ComposerRunTimelineItem, ComposerRunTimelineResponse, ComposerRunTimelineStatus, ComposerRunTimelineVisibility } from "@evalops/contracts";
+export declare const AGENT_TRAJECTORY_SCHEMA = "evalops.maestro.agent-trajectory.v1";
+export type AgentTrajectoryEventKind = "session" | "message" | "tool" | "evidence" | "governance" | "context" | "wait" | "artifact" | "agent" | "runtime";
+export type AgentTrajectoryPhase = "setup" | "observe" | "think" | "act" | "verify" | "govern" | "wait" | "recover" | "finish";
+export type AgentTrajectoryActor = "user" | "assistant" | "tool" | "agent" | "runtime" | "platform" | "system";
+export interface AgentTrajectoryEvidenceAnchor {
+    kind: "timeline_item" | "tool_call" | "tool_execution" | "approval_request" | "pending_request" | "artifact" | "agent_run" | "parent_agent_run" | "child_agent_run";
+    id: string;
+}
+export interface AgentTrajectoryEvent {
+    id: string;
+    sequence: number;
+    timestamp: string;
+    kind: AgentTrajectoryEventKind;
+    phase: AgentTrajectoryPhase;
+    actor: AgentTrajectoryActor;
+    type: string;
+    status: ComposerRunTimelineStatus;
+    visibility: ComposerRunTimelineVisibility;
+    source: ComposerRunTimelineItem["source"];
+    title: string;
+    summary?: string;
+    toolName?: string;
+    relatedIds?: string[];
+    evidence: AgentTrajectoryEvidenceAnchor[];
+}
+export interface AgentTrajectoryReport {
+    schemaVersion: typeof AGENT_TRAJECTORY_SCHEMA;
+    run: {
+        id: string;
+        sessionId: string;
+        source: ComposerRunTimelineResponse["source"];
+        generatedAt: string;
+        platformBacked: boolean;
+    };
+    counts: {
+        events: number;
+        evidenceAnchors: number;
+        byKind: Record<string, number>;
+        byPhase: Record<string, number>;
+        byStatus: Record<string, number>;
+    };
+    events: AgentTrajectoryEvent[];
+}
+interface BuildAgentTrajectoryOptions {
+    runId?: string;
+}
+export declare function buildAgentTrajectoryReport(timeline: ComposerRunTimelineResponse, options?: BuildAgentTrajectoryOptions): AgentTrajectoryReport;
+export {};
+//# sourceMappingURL=agent-trajectory.d.ts.map

package/dist/server/agent-trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-trajectory.d.ts","sourceRoot":"","sources":["../../src/server/agent-trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,uBAAuB,wCAAwC,CAAC;AAE7E,MAAM,MAAM,wBAAwB,GACjC,SAAS,GACT,SAAS,GACT,MAAM,GACN,UAAU,GACV,YAAY,GACZ,SAAS,GACT,MAAM,GACN,UAAU,GACV,OAAO,GACP,SAAS,CAAC;AAEb,MAAM,MAAM,oBAAoB,GAC7B,OAAO,GACP,SAAS,GACT,OAAO,GACP,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,QAAQ,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAC7B,MAAM,GACN,WAAW,GACX,MAAM,GACN,OAAO,GACP,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEZ,MAAM,WAAW,6BAA6B;IAC7C,IAAI,EACD,eAAe,GACf,WAAW,GACX,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,UAAU,GACV,WAAW,GACX,kBAAkB,GAClB,iBAAiB,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,6BAA6B,CAAC;IAC1C,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACrC,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,GAAG,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;QAC9C,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,MAAM,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,UAAU,2BAA2B;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAqHD,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,2BAA2B,EACrC,OAAO,GAAE,2BAAgC,GACvC,qBAAqB,CAoDvB"}

package/dist/server/agent-trajectory.js

@@ -0,0 +1,159 @@
+export const AGENT_TRAJECTORY_SCHEMA = "evalops.maestro.agent-trajectory.v1";
+function increment(map, key) {
+    map[key] = (map[key] ?? 0) + 1;
+}
+function kindForTimelineItem(item) {
+    if (item.type.startsWith("session."))
+        return "session";
+    if (item.type.startsWith("message."))
+        return "message";
+    if (item.type.startsWith("tool."))
+        return "tool";
+    if (item.type.startsWith("file.") || item.type.startsWith("diagnostic.")) {
+        return "evidence";
+    }
+    if (item.type.startsWith("policy."))
+        return "governance";
+    if (item.type === "wait.pending")
+        return "wait";
+    if (item.type.startsWith("agent.run."))
+        return "agent";
+    if (item.type.startsWith("artifact."))
+        return "artifact";
+    if (item.type.startsWith("compaction.") ||
+        item.type.startsWith("branch.") ||
+        item.type.startsWith("model.") ||
+        item.type.startsWith("thinking.")) {
+        return "context";
+    }
+    return "runtime";
+}
+function phaseForTimelineItem(item) {
+    switch (kindForTimelineItem(item)) {
+        case "session":
+        case "context":
+            return "setup";
+        case "message":
+            return item.role === "assistant" ? "think" : "observe";
+        case "tool":
+            return item.type === "tool.requested" ? "act" : "verify";
+        case "agent":
+            return item.type === "agent.run.started" ? "act" : "verify";
+        case "evidence":
+        case "artifact":
+            return "verify";
+        case "governance":
+            return "govern";
+        case "wait":
+            return "wait";
+        case "runtime":
+            return item.status === "failed" ? "recover" : "finish";
+    }
+}
+function actorForTimelineItem(item) {
+    if (item.role === "user")
+        return "user";
+    if (item.role === "assistant")
+        return "assistant";
+    if (item.role === "tool")
+        return "tool";
+    if (item.type === "tool.requested")
+        return "assistant";
+    if (item.type.startsWith("agent.run."))
+        return "agent";
+    if (item.source === "platform")
+        return "platform";
+    if (item.type.startsWith("session.") ||
+        item.type.startsWith("compaction.") ||
+        item.type.startsWith("branch.") ||
+        item.type.startsWith("model.") ||
+        item.type.startsWith("thinking.")) {
+        return "system";
+    }
+    return "runtime";
+}
+function pushAnchor(anchors, kind, id) {
+    if (!id)
+        return;
+    anchors.push({ kind, id });
+}
+function evidenceForTimelineItem(item) {
+    const anchors = [];
+    pushAnchor(anchors, "timeline_item", item.id);
+    pushAnchor(anchors, "tool_call", item.toolCallId);
+    pushAnchor(anchors, "tool_execution", item.toolExecutionId);
+    pushAnchor(anchors, "approval_request", item.approvalRequestId);
+    pushAnchor(anchors, "pending_request", item.pendingRequestId);
+    pushAnchor(anchors, "artifact", item.artifactId);
+    pushAnchor(anchors, "agent_run", item.agentRunId);
+    pushAnchor(anchors, "parent_agent_run", item.parentAgentRunId);
+    pushAnchor(anchors, "child_agent_run", item.childAgentRunId);
+    return anchors;
+}
+function relatedIdsForTimelineItem(item) {
+    return [
+        item.toolCallId,
+        item.toolExecutionId,
+        item.approvalRequestId,
+        item.pendingRequestId,
+        item.artifactId,
+        item.agentRunId,
+        item.parentAgentRunId,
+        item.childAgentRunId,
+    ]
+        .filter((id) => typeof id === "string" && id.length > 0)
+        .filter((id, index, ids) => ids.indexOf(id) === index)
+        .sort();
+}
+export function buildAgentTrajectoryReport(timeline, options = {}) {
+    const events = timeline.items.map((item, index) => {
+        const relatedIds = relatedIdsForTimelineItem(item);
+        const status = item.status ?? "info";
+        return {
+            id: `trajectory:${item.id}`,
+            sequence: index + 1,
+            timestamp: item.timestamp,
+            kind: kindForTimelineItem(item),
+            phase: phaseForTimelineItem(item),
+            actor: actorForTimelineItem(item),
+            type: item.type,
+            status,
+            visibility: item.visibility,
+            source: item.source,
+            title: item.title,
+            ...(item.summary ? { summary: item.summary } : {}),
+            ...(item.toolName ? { toolName: item.toolName } : {}),
+            ...(relatedIds.length > 0 ? { relatedIds } : {}),
+            evidence: evidenceForTimelineItem(item),
+        };
+    });
+    const byKind = {};
+    const byPhase = {};
+    const byStatus = {};
+    let evidenceAnchors = 0;
+    for (const event of events) {
+        increment(byKind, event.kind);
+        increment(byPhase, event.phase);
+        increment(byStatus, event.status);
+        evidenceAnchors += event.evidence.length;
+    }
+    return {
+        schemaVersion: AGENT_TRAJECTORY_SCHEMA,
+        run: {
+            id: options.runId ?? timeline.sessionId,
+            sessionId: timeline.sessionId,
+            source: timeline.source,
+            generatedAt: timeline.generatedAt,
+            platformBacked: timeline.platformBacked,
+        },
+        counts: {
+            events: events.length,
+            evidenceAnchors,
+            byKind,
+            byPhase,
+            byStatus,
+        },
+        events,
+    };
+}
+//# sourceMappingURL=agent-trajectory.js.map

package/dist/server/agent-trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-trajectory.js","sourceRoot":"","sources":["../../src/server/agent-trajectory.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tComposerRunTimelineItem,\n\tComposerRunTimelineResponse,\n\tComposerRunTimelineStatus,\n\tComposerRunTimelineVisibility,\n} from \"@evalops/contracts\";\n\nexport const AGENT_TRAJECTORY_SCHEMA = \"evalops.maestro.agent-trajectory.v1\";\n\nexport type AgentTrajectoryEventKind =\n\t| \"session\"\n\t| \"message\"\n\t| \"tool\"\n\t| \"evidence\"\n\t| \"governance\"\n\t| \"context\"\n\t| \"wait\"\n\t| \"artifact\"\n\t| \"agent\"\n\t| \"runtime\";\n\nexport type AgentTrajectoryPhase =\n\t| \"setup\"\n\t| \"observe\"\n\t| \"think\"\n\t| \"act\"\n\t| \"verify\"\n\t| \"govern\"\n\t| \"wait\"\n\t| \"recover\"\n\t| \"finish\";\n\nexport type AgentTrajectoryActor =\n\t| \"user\"\n\t| \"assistant\"\n\t| \"tool\"\n\t| \"agent\"\n\t| \"runtime\"\n\t| \"platform\"\n\t| \"system\";\n\nexport interface AgentTrajectoryEvidenceAnchor {\n\tkind:\n\t\t| \"timeline_item\"\n\t\t| \"tool_call\"\n\t\t| \"tool_execution\"\n\t\t| \"approval_request\"\n\t\t| \"pending_request\"\n\t\t| \"artifact\"\n\t\t| \"agent_run\"\n\t\t| \"parent_agent_run\"\n\t\t| \"child_agent_run\";\n\tid: string;\n}\n\nexport interface AgentTrajectoryEvent {\n\tid: string;\n\tsequence: number;\n\ttimestamp: string;\n\tkind: AgentTrajectoryEventKind;\n\tphase: AgentTrajectoryPhase;\n\tactor: AgentTrajectoryActor;\n\ttype: string;\n\tstatus: ComposerRunTimelineStatus;\n\tvisibility: ComposerRunTimelineVisibility;\n\tsource: ComposerRunTimelineItem[\"source\"];\n\ttitle: string;\n\tsummary?: string;\n\ttoolName?: string;\n\trelatedIds?: string[];\n\tevidence: AgentTrajectoryEvidenceAnchor[];\n}\n\nexport interface AgentTrajectoryReport {\n\tschemaVersion: typeof AGENT_TRAJECTORY_SCHEMA;\n\trun: {\n\t\tid: string;\n\t\tsessionId: string;\n\t\tsource: ComposerRunTimelineResponse[\"source\"];\n\t\tgeneratedAt: string;\n\t\tplatformBacked: boolean;\n\t};\n\tcounts: {\n\t\tevents: number;\n\t\tevidenceAnchors: number;\n\t\tbyKind: Record<string, number>;\n\t\tbyPhase: Record<string, number>;\n\t\tbyStatus: Record<string, number>;\n\t};\n\tevents: AgentTrajectoryEvent[];\n}\n\ninterface BuildAgentTrajectoryOptions {\n\trunId?: string;\n}\n\nfunction increment(map: Record<string, number>, key: string): void {\n\tmap[key] = (map[key] ?? 0) + 1;\n}\n\nfunction kindForTimelineItem(\n\titem: ComposerRunTimelineItem,\n): AgentTrajectoryEventKind {\n\tif (item.type.startsWith(\"session.\")) return \"session\";\n\tif (item.type.startsWith(\"message.\")) return \"message\";\n\tif (item.type.startsWith(\"tool.\")) return \"tool\";\n\tif (item.type.startsWith(\"file.\") || item.type.startsWith(\"diagnostic.\")) {\n\t\treturn \"evidence\";\n\t}\n\tif (item.type.startsWith(\"policy.\")) return \"governance\";\n\tif (item.type === \"wait.pending\") return \"wait\";\n\tif (item.type.startsWith(\"agent.run.\")) return \"agent\";\n\tif (item.type.startsWith(\"artifact.\")) return \"artifact\";\n\tif (\n\t\titem.type.startsWith(\"compaction.\") ||\n\t\titem.type.startsWith(\"branch.\") ||\n\t\titem.type.startsWith(\"model.\") ||\n\t\titem.type.startsWith(\"thinking.\")\n\t) {\n\t\treturn \"context\";\n\t}\n\treturn \"runtime\";\n}\n\nfunction phaseForTimelineItem(\n\titem: ComposerRunTimelineItem,\n): AgentTrajectoryPhase {\n\tswitch (kindForTimelineItem(item)) {\n\t\tcase \"session\":\n\t\tcase \"context\":\n\t\t\treturn \"setup\";\n\t\tcase \"message\":\n\t\t\treturn item.role === \"assistant\" ? \"think\" : \"observe\";\n\t\tcase \"tool\":\n\t\t\treturn item.type === \"tool.requested\" ? \"act\" : \"verify\";\n\t\tcase \"agent\":\n\t\t\treturn item.type === \"agent.run.started\" ? \"act\" : \"verify\";\n\t\tcase \"evidence\":\n\t\tcase \"artifact\":\n\t\t\treturn \"verify\";\n\t\tcase \"governance\":\n\t\t\treturn \"govern\";\n\t\tcase \"wait\":\n\t\t\treturn \"wait\";\n\t\tcase \"runtime\":\n\t\t\treturn item.status === \"failed\" ? \"recover\" : \"finish\";\n\t}\n}\n\nfunction actorForTimelineItem(\n\titem: ComposerRunTimelineItem,\n): AgentTrajectoryActor {\n\tif (item.role === \"user\") return \"user\";\n\tif (item.role === \"assistant\") return \"assistant\";\n\tif (item.role === \"tool\") return \"tool\";\n\tif (item.type === \"tool.requested\") return \"assistant\";\n\tif (item.type.startsWith(\"agent.run.\")) return \"agent\";\n\tif (item.source === \"platform\") return \"platform\";\n\tif (\n\t\titem.type.startsWith(\"session.\") ||\n\t\titem.type.startsWith(\"compaction.\") ||\n\t\titem.type.startsWith(\"branch.\") ||\n\t\titem.type.startsWith(\"model.\") ||\n\t\titem.type.startsWith(\"thinking.\")\n\t) {\n\t\treturn \"system\";\n\t}\n\treturn \"runtime\";\n}\n\nfunction pushAnchor(\n\tanchors: AgentTrajectoryEvidenceAnchor[],\n\tkind: AgentTrajectoryEvidenceAnchor[\"kind\"],\n\tid: string | undefined,\n): void {\n\tif (!id) return;\n\tanchors.push({ kind, id });\n}\n\nfunction evidenceForTimelineItem(\n\titem: ComposerRunTimelineItem,\n): AgentTrajectoryEvidenceAnchor[] {\n\tconst anchors: AgentTrajectoryEvidenceAnchor[] = [];\n\tpushAnchor(anchors, \"timeline_item\", item.id);\n\tpushAnchor(anchors, \"tool_call\", item.toolCallId);\n\tpushAnchor(anchors, \"tool_execution\", item.toolExecutionId);\n\tpushAnchor(anchors, \"approval_request\", item.approvalRequestId);\n\tpushAnchor(anchors, \"pending_request\", item.pendingRequestId);\n\tpushAnchor(anchors, \"artifact\", item.artifactId);\n\tpushAnchor(anchors, \"agent_run\", item.agentRunId);\n\tpushAnchor(anchors, \"parent_agent_run\", item.parentAgentRunId);\n\tpushAnchor(anchors, \"child_agent_run\", item.childAgentRunId);\n\treturn anchors;\n}\n\nfunction relatedIdsForTimelineItem(item: ComposerRunTimelineItem): string[] {\n\treturn [\n\t\titem.toolCallId,\n\t\titem.toolExecutionId,\n\t\titem.approvalRequestId,\n\t\titem.pendingRequestId,\n\t\titem.artifactId,\n\t\titem.agentRunId,\n\t\titem.parentAgentRunId,\n\t\titem.childAgentRunId,\n\t]\n\t\t.filter((id): id is string => typeof id === \"string\" && id.length > 0)\n\t\t.filter((id, index, ids) => ids.indexOf(id) === index)\n\t\t.sort();\n}\n\nexport function buildAgentTrajectoryReport(\n\ttimeline: ComposerRunTimelineResponse,\n\toptions: BuildAgentTrajectoryOptions = {},\n): AgentTrajectoryReport {\n\tconst events = timeline.items.map((item, index): AgentTrajectoryEvent => {\n\t\tconst relatedIds = relatedIdsForTimelineItem(item);\n\t\tconst status = item.status ?? \"info\";\n\t\treturn {\n\t\t\tid: `trajectory:${item.id}`,\n\t\t\tsequence: index + 1,\n\t\t\ttimestamp: item.timestamp,\n\t\t\tkind: kindForTimelineItem(item),\n\t\t\tphase: phaseForTimelineItem(item),\n\t\t\tactor: actorForTimelineItem(item),\n\t\t\ttype: item.type,\n\t\t\tstatus,\n\t\t\tvisibility: item.visibility,\n\t\t\tsource: item.source,\n\t\t\ttitle: item.title,\n\t\t\t...(item.summary ? { summary: item.summary } : {}),\n\t\t\t...(item.toolName ? { toolName: item.toolName } : {}),\n\t\t\t...(relatedIds.length > 0 ? { relatedIds } : {}),\n\t\t\tevidence: evidenceForTimelineItem(item),\n\t\t};\n\t});\n\n\tconst byKind: Record<string, number> = {};\n\tconst byPhase: Record<string, number> = {};\n\tconst byStatus: Record<string, number> = {};\n\tlet evidenceAnchors = 0;\n\tfor (const event of events) {\n\t\tincrement(byKind, event.kind);\n\t\tincrement(byPhase, event.phase);\n\t\tincrement(byStatus, event.status);\n\t\tevidenceAnchors += event.evidence.length;\n\t}\n\n\treturn {\n\t\tschemaVersion: AGENT_TRAJECTORY_SCHEMA,\n\t\trun: {\n\t\t\tid: options.runId ?? timeline.sessionId,\n\t\t\tsessionId: timeline.sessionId,\n\t\t\tsource: timeline.source,\n\t\t\tgeneratedAt: timeline.generatedAt,\n\t\t\tplatformBacked: timeline.platformBacked,\n\t\t},\n\t\tcounts: {\n\t\t\tevents: events.length,\n\t\t\tevidenceAnchors,\n\t\t\tbyKind,\n\t\t\tbyPhase,\n\t\t\tbyStatus,\n\t\t},\n\t\tevents,\n\t};\n}\n"]}

package/dist/server/app-context.d.ts

@@ -6,6 +6,7 @@ import type { ThinkingLevel } from "../agent/types.js";
 import type { RegisteredModel } from "../models/registry.js";
 import type { AuthCredential } from "../providers/auth.js";
 import type { HeadlessRuntimeService } from "./headless-runtime-service.js";
+import type { HostedRunnerLeaseSnapshot } from "./hosted-runner-lease.js";
 export interface WebServerConfig {
     corsHeaders: Record<string, string>;
     staticMaxAge: number;
@@ -23,10 +24,27 @@ export interface HostedRunnerContext {
     listenHost?: string;
     listenPort?: number;
     workspaceId?: string;
+    agentId?: string;
     agentRunId?: string;
+    agentRuntimeLeaseToken?: string;
+    a2aMessageId?: string;
+    a2aTaskId?: string;
+    lastPlatformA2APush?: {
+        kind: "statusUpdate" | "artifactUpdate" | "task" | "message";
+        taskId?: string;
+        contextId?: string;
+        state?: string;
+        final?: boolean;
+        receivedAt: string;
+        runtimeEventId?: string;
+        runtimeEventType?: string;
+    };
+    agentRuntimeWorkerQueue?: string;
+    agentRuntimeCorrelationPath?: string;
     attachAudience?: string;
     configuredMaestroSessionId?: string;
     activeMaestroSessionId?: string;
+    runtimeLease?: HostedRunnerLeaseSnapshot;
     draining?: boolean;
     lastDrain?: {
         status: string;

package/dist/server/app-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-context.d.ts","sourceRoot":"","sources":["../../src/server/app-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-context.d.ts","sourceRoot":"","sources":["../../src/server/app-context.ts"],"names":[],"mappings":"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"}

package/dist/server/app-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/server/app-context.ts"],"names":[],"mappings":"","sourcesContent":["import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type {\n\tActionApprovalService,\n\tApprovalMode,\n} from \"../agent/action-approval.js\";\nimport type { Agent } from \"../agent/index.js\";\nimport type { ToolRetryService } from \"../agent/tool-retry.js\";\nimport type { ClientToolExecutionService } from \"../agent/transport.js\";\nimport type { ThinkingLevel } from \"../agent/types.js\";\nimport type { RegisteredModel } from \"../models/registry.js\";\nimport type { AuthCredential } from \"../providers/auth.js\";\nimport type { HeadlessRuntimeService } from \"./headless-runtime-service.js\";\n\nexport interface WebServerConfig {\n\tcorsHeaders: Record<string, string>;\n\tstaticMaxAge: number;\n\tdefaultApprovalMode: ApprovalMode;\n\tdefaultProvider: string;\n\tdefaultModelId: string;\n\thostedRunner?: HostedRunnerContext;\n}\n\nexport interface HostedRunnerContext {\n\tenabled: true;\n\trunnerSessionId: string;\n\townerInstanceId?: string;\n\tworkspaceRoot: string;\n\tsnapshotRoot?: string;\n\tlistenHost?: string;\n\tlistenPort?: number;\n\tworkspaceId?: string;\n\tagentRunId?: string;\n\tattachAudience?: string;\n\tconfiguredMaestroSessionId?: string;\n\tactiveMaestroSessionId?: string;\n\tdraining?: boolean;\n\tlastDrain?: {\n\t\tstatus: string;\n\t\tmanifestPath: string;\n\t\tdrainedAt: string;\n\t\treason?: string;\n\t\trequestedBy?: string;\n\t};\n}\n\nexport interface WebServerServices {\n\tcreateAgent: (\n\t\tmodel: RegisteredModel,\n\t\tthinking: ThinkingLevel,\n\t\tapproval: ApprovalMode,\n\t\toptions?: {\n\t\t\tcwd?: string;\n\t\t\tenableClientTools?: boolean;\n\t\t\tuseClientAskUser?: boolean;\n\t\t\tincludeVscodeTools?: boolean;\n\t\t\tincludeJetBrainsTools?: boolean;\n\t\t\tincludeConductorTools?: boolean;\n\t\t\tapprovalService?: ActionApprovalService;\n\t\t\tclientToolService?: ClientToolExecutionService;\n\t\t\ttoolRetryService?: ToolRetryService;\n\t\t},\n\t) => Promise<Agent>;\n\tcreateBackgroundAgent: (\n\t\tmodel: RegisteredModel,\n\t\toptions?: {\n\t\t\tcwd?: string;\n\t\t\tsystemPrompt?: string;\n\t\t},\n\t) => Promise<Agent>;\n\tgetRegisteredModel: (\n\t\tinput: string | null | undefined,\n\t) => Promise<RegisteredModel>;\n\tgetCurrentSelection: () => { provider: string; modelId: string };\n\tensureCredential: (provider: string) => Promise<AuthCredential>;\n\tsetModelSelection: (model: RegisteredModel) => void;\n\tacquireSse: () => symbol | null;\n\treleaseSse: (token: symbol | null) => void;\n\theadlessRuntimeService: HeadlessRuntimeService;\n}\n\nexport type WebServerContext = WebServerConfig & WebServerServices;\n"]}
+{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/server/app-context.ts"],"names":[],"mappings":"","sourcesContent":["import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type {\n\tActionApprovalService,\n\tApprovalMode,\n} from \"../agent/action-approval.js\";\nimport type { Agent } from \"../agent/index.js\";\nimport type { ToolRetryService } from \"../agent/tool-retry.js\";\nimport type { ClientToolExecutionService } from \"../agent/transport.js\";\nimport type { ThinkingLevel } from \"../agent/types.js\";\nimport type { RegisteredModel } from \"../models/registry.js\";\nimport type { AuthCredential } from \"../providers/auth.js\";\nimport type { HeadlessRuntimeService } from \"./headless-runtime-service.js\";\nimport type { HostedRunnerLeaseSnapshot } from \"./hosted-runner-lease.js\";\n\nexport interface WebServerConfig {\n\tcorsHeaders: Record<string, string>;\n\tstaticMaxAge: number;\n\tdefaultApprovalMode: ApprovalMode;\n\tdefaultProvider: string;\n\tdefaultModelId: string;\n\thostedRunner?: HostedRunnerContext;\n}\n\nexport interface HostedRunnerContext {\n\tenabled: true;\n\trunnerSessionId: string;\n\townerInstanceId?: string;\n\tworkspaceRoot: string;\n\tsnapshotRoot?: string;\n\tlistenHost?: string;\n\tlistenPort?: number;\n\tworkspaceId?: string;\n\tagentId?: string;\n\tagentRunId?: string;\n\tagentRuntimeLeaseToken?: string;\n\ta2aMessageId?: string;\n\ta2aTaskId?: string;\n\tlastPlatformA2APush?: {\n\t\tkind: \"statusUpdate\" | \"artifactUpdate\" | \"task\" | \"message\";\n\t\ttaskId?: string;\n\t\tcontextId?: string;\n\t\tstate?: string;\n\t\tfinal?: boolean;\n\t\treceivedAt: string;\n\t\truntimeEventId?: string;\n\t\truntimeEventType?: string;\n\t};\n\tagentRuntimeWorkerQueue?: string;\n\tagentRuntimeCorrelationPath?: string;\n\tattachAudience?: string;\n\tconfiguredMaestroSessionId?: string;\n\tactiveMaestroSessionId?: string;\n\truntimeLease?: HostedRunnerLeaseSnapshot;\n\tdraining?: boolean;\n\tlastDrain?: {\n\t\tstatus: string;\n\t\tmanifestPath: string;\n\t\tdrainedAt: string;\n\t\treason?: string;\n\t\trequestedBy?: string;\n\t};\n}\n\nexport interface WebServerServices {\n\tcreateAgent: (\n\t\tmodel: RegisteredModel,\n\t\tthinking: ThinkingLevel,\n\t\tapproval: ApprovalMode,\n\t\toptions?: {\n\t\t\tcwd?: string;\n\t\t\tenableClientTools?: boolean;\n\t\t\tuseClientAskUser?: boolean;\n\t\t\tincludeVscodeTools?: boolean;\n\t\t\tincludeJetBrainsTools?: boolean;\n\t\t\tincludeConductorTools?: boolean;\n\t\t\tapprovalService?: ActionApprovalService;\n\t\t\tclientToolService?: ClientToolExecutionService;\n\t\t\ttoolRetryService?: ToolRetryService;\n\t\t},\n\t) => Promise<Agent>;\n\tcreateBackgroundAgent: (\n\t\tmodel: RegisteredModel,\n\t\toptions?: {\n\t\t\tcwd?: string;\n\t\t\tsystemPrompt?: string;\n\t\t},\n\t) => Promise<Agent>;\n\tgetRegisteredModel: (\n\t\tinput: string | null | undefined,\n\t) => Promise<RegisteredModel>;\n\tgetCurrentSelection: () => { provider: string; modelId: string };\n\tensureCredential: (provider: string) => Promise<AuthCredential>;\n\tsetModelSelection: (model: RegisteredModel) => void;\n\tacquireSse: () => symbol | null;\n\treleaseSse: (token: symbol | null) => void;\n\theadlessRuntimeService: HeadlessRuntimeService;\n}\n\nexport type WebServerContext = WebServerConfig & WebServerServices;\n"]}

package/dist/server/handlers/headless-sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headless-sessions.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/headless-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAmBjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAqB1D,oBAAY,qBAAqB;IAChC,eAAe,sBAAsB;IACrC,qBAAqB,4BAA4B;CACjD;AAopBD,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,iBAQzB;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,iBAazB;AAED,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAI/B;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAyD/B;AAED,wBAAsB,gCAAgC,CACrD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAW/B;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAiB/B;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAqB/B;AAED,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAsE/B;AAED,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAsB/B"}
+{"version":3,"file":"headless-sessions.d.ts","sourceRoot":"","sources":["../../../src/server/handlers/headless-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAmBjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AA2B1D,oBAAY,qBAAqB;IAChC,eAAe,sBAAsB;IACrC,qBAAqB,4BAA4B;CACjD;AA8qBD,wBAAsB,2BAA2B,CAChD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,iBAQzB;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,iBAazB;AAED,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAI/B;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAyD/B;AAED,wBAAsB,gCAAgC,CACrD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAW/B;AAED,wBAAsB,8BAA8B,CACnD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAiB/B;AAED,wBAAsB,+BAA+B,CACpD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAqB/B;AAED,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAsE/B;AAED,wBAAsB,4BAA4B,CACjD,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,iBAsB/B"}

package/dist/server/handlers/headless-sessions.js

@@ -4,6 +4,8 @@ import { resolveExistingWorkspaceRoot } from "../../headless/workspace-root.js";
 import { recordMaestroSessionRuntimeTrigger } from "../../platform/agent-runtime-client.js";
 import { normalizeApprovalMode, resolveApprovalModeForRequest, } from "../approval-mode-store.js";
 import { getAuthScopeKey, getAuthSubject } from "../authz.js";
+import { bindHostedRunnerPlatformLease, claimHostedRunnerLease, evaluateHostedRunnerLeaseUse, } from "../hosted-runner-lease.js";
+import { getTraceParentHeader } from "../request-context.js";
 import { ApiError, getRequestHeader, readRequestBody, sendJson, } from "../server-utils.js";
 import { createSessionManagerForRequest } from "../session-scope.js";
 import { parseAndValidateJson, validatePayload } from "../validation.js";
@@ -186,44 +188,45 @@ function ensureHostedRunnerCanUseSession(context, requestedSessionId) {
     if (!hostedRunner) {
         return;
     }
-    const activeSessionId = hostedRunner.activeMaestroSessionId ??
-        hostedRunner.configuredMaestroSessionId;
-    if (hostedRunner.draining) {
-        throw hostedRunnerNotReadyError(context, "Hosted runner is draining and not accepting headless session traffic", {
-            draining: "true",
-            maestro_session_id: activeSessionId,
-            requested_maestro_session_id: requestedSessionId,
-        });
-    }
-    if (!activeSessionId) {
+    const decision = evaluateHostedRunnerLeaseUse(hostedRunner, requestedSessionId);
+    if (decision.ok) {
         return;
     }
-    if (!requestedSessionId) {
-        throw hostedRunnerOwnershipError(context, `Hosted runner is already bound to Maestro session ${activeSessionId}`, {
-            maestro_session_id: activeSessionId,
-        });
-    }
-    if (requestedSessionId !== activeSessionId) {
-        throw hostedRunnerOwnershipError(context, `Hosted runner is bound to Maestro session ${activeSessionId}`, {
-            maestro_session_id: activeSessionId,
+    if (decision.reason === "runtime_draining") {
+        throw hostedRunnerNotReadyError(context, decision.message, {
+            draining: "true",
+            maestro_session_id: decision.activeSessionId,
             requested_maestro_session_id: requestedSessionId,
+            lease_generation: String(decision.snapshot.generation),
         });
     }
+    throw hostedRunnerOwnershipError(context, decision.message, {
+        maestro_session_id: decision.activeSessionId,
+        requested_maestro_session_id: decision.requestedSessionId,
+        lease_generation: String(decision.snapshot.generation),
+    });
 }
 function claimHostedRunnerSession(context, sessionId) {
     const hostedRunner = context.hostedRunner;
     if (!hostedRunner) {
         return;
     }
-    const activeSessionId = hostedRunner.activeMaestroSessionId ??
-        hostedRunner.configuredMaestroSessionId;
-    if (activeSessionId && activeSessionId !== sessionId) {
-        throw hostedRunnerOwnershipError(context, `Hosted runner is bound to Maestro session ${activeSessionId}`, {
-            maestro_session_id: activeSessionId,
-            requested_maestro_session_id: sessionId,
+    const decision = claimHostedRunnerLease(hostedRunner, sessionId);
+    if (!decision.ok) {
+        if (decision.reason === "runtime_draining") {
+            throw hostedRunnerNotReadyError(context, decision.message, {
+                draining: "true",
+                maestro_session_id: decision.activeSessionId,
+                requested_maestro_session_id: decision.requestedSessionId ?? sessionId,
+                lease_generation: String(decision.snapshot.generation),
+            });
+        }
+        throw hostedRunnerOwnershipError(context, decision.message, {
+            maestro_session_id: decision.activeSessionId,
+            requested_maestro_session_id: decision.requestedSessionId ?? sessionId,
+            lease_generation: String(decision.snapshot.generation),
         });
     }
-    hostedRunner.activeMaestroSessionId = sessionId;
 }
 function resolveRuntimeWorkspaceRoot(context, workspaceRoot) {
     const requestedRoot = workspaceRoot?.trim() || undefined;
@@ -366,11 +369,17 @@ async function ensureRuntime(req, context, input) {
 async function recordPlatformAgentRuntimeSessionStart(options) {
     const snapshot = options.runtime.getSnapshot();
     const hostedRunner = options.context.hostedRunner;
+    // This is a projection, not ownership transfer. The local headless runtime
+    // remains authoritative; Platform receives session-start metadata and trace
+    // context so AgentRuntime, A2A, deploy smoke tests, and support endpoints can
+    // all join on the same Maestro session.
     const result = await recordMaestroSessionRuntimeTrigger({
         workspaceId: hostedRunner?.workspaceId,
+        agentId: hostedRunner?.agentId,
         sessionId: snapshot.session_id,
         actorId: options.subject,
         correlationId: `maestro-session:${snapshot.session_id}`,
+        traceparent: getTraceParentHeader(),
         metadata: {
             model: options.registeredModel.id,
             provider: options.registeredModel.provider,
@@ -382,11 +391,39 @@ async function recordPlatformAgentRuntimeSessionStart(options) {
             workspace_root: options.workspaceRoot,
             runner_session_id: hostedRunner?.runnerSessionId,
             owner_instance_id: hostedRunner?.ownerInstanceId,
+            agent_id: hostedRunner?.agentId,
         },
     });
-    if (result?.run.id && hostedRunner && !hostedRunner.agentRunId) {
-        hostedRunner.agentRunId = result.run.id;
+    if (!hostedRunner || !result) {
+        return;
     }
+    const a2aCorrelation = result.events.find((event) => event.type === "maestro.platform_runtime.a2a_correlated")?.attributes;
+    bindHostedRunnerPlatformLease(hostedRunner, {
+        agentRunId: result.run.id,
+        agentId: result.run.linkage?.agentId,
+        leaseToken: result.run.lease?.token,
+    });
+    // Store only support-grade handles on the hosted runner. The full run/task
+    // state stays in Platform; health and identity endpoints expose these ids
+    // for operators without making Platform a session-state dependency.
+    hostedRunner.a2aMessageId = a2aCorrelation
+        ? stringAttribute(a2aCorrelation, "a2a_message_id")
+        : undefined;
+    hostedRunner.a2aTaskId = a2aCorrelation
+        ? stringAttribute(a2aCorrelation, "a2a_task_id")
+        : undefined;
+    hostedRunner.agentRuntimeWorkerQueue = a2aCorrelation
+        ? stringAttribute(a2aCorrelation, "worker_queue")
+        : undefined;
+    hostedRunner.agentRuntimeCorrelationPath = a2aCorrelation
+        ? stringAttribute(a2aCorrelation, "correlation_path")
+        : undefined;
+}
+function stringAttribute(attributes, key) {
+    const value = attributes[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
 }
 async function ensureConnection(req, context, input) {
     const runtime = await ensureRuntime(req, context, {