@evalops/maestro 0.10.22 → 0.10.24

package/dist/app-server/daemon-lifecycle-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-lifecycle-api.d.ts","sourceRoot":"","sources":["../../src/app-server/daemon-lifecycle-api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,kCAAkC,EAClC,wCAAwC,EAExC,wCAAwC,EACxC,yCAAyC,EACzC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAGN,iBAAiB,EACjB,MAAM,2CAA2C,CAAC;AAOnD,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,KAAK,WAAW,GAAG,OAAO,iBAAiB,CAAC;AAE5C,qBAAa,oCAAqC,SAAQ,KAAK;IAE7D,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKhB;AAED,MAAM,WAAW,2CAA2C;IAC3D,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,+BAA+B;IAC/C,YAAY,IAAI,2CAA2C,CAAC;IAC5D,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kCAAkC,CAAC,CAAC;IAC5E,mBAAmB,CAClB,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,yCAAyC,CAAC,CAAC;IACtD,SAAS,CACR,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,wCAAwC,CAAC,CAAC;IACrD,cAAc,CACb,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CACJ,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,wCAAwC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,sCAAsC;IACtD,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CACjB;AA8MD,wBAAgB,qCAAqC,CACpD,OAAO,GAAE,sCAA2C,GAClD,+BAA+B,CAgGjC"}

package/dist/app-server/daemon-lifecycle-api.js

@@ -0,0 +1,259 @@
+import { stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { HostedRunnerDrainStatusValue, drainHostedRunner, } from "../server/handlers/hosted-runner-drain.js";
+import { hostedRunnerLeaseSnapshot, refreshHostedRunnerLease, } from "../server/hosted-runner-lease.js";
+import { ApiError } from "../server/server-utils.js";
+export class MaestroAppServerDaemonLifecycleError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "MaestroAppServerDaemonLifecycleError";
+    }
+}
+function optionalString(value, field) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}`);
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function paramsRecord(params) {
+    if (params === undefined) {
+        return {};
+    }
+    if (isRecord(params)) {
+        return params;
+    }
+    throw new MaestroAppServerDaemonLifecycleError(-32602, "Invalid params");
+}
+function optionalStringArray(value, field) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        throw new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}`);
+    }
+    return value.map((entry, index) => {
+        if (typeof entry !== "string" || !entry.trim()) {
+            throw new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}[${index}]`);
+        }
+        if (entry.includes("\0")) {
+            throw new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}[${index}]`);
+        }
+        return entry.trim();
+    });
+}
+function toLease(hostedRunner, now) {
+    const lease = hostedRunnerLeaseSnapshot(hostedRunner, now);
+    return {
+        protocolVersion: lease.protocolVersion,
+        runnerSessionId: lease.runnerSessionId,
+        ownerInstanceId: lease.ownerInstanceId,
+        workspaceId: lease.workspaceId,
+        agentId: lease.agentId,
+        agentRunId: lease.agentRunId,
+        maestroSessionId: lease.maestroSessionId,
+        configuredMaestroSessionId: lease.configuredMaestroSessionId,
+        state: lease.state,
+        generation: lease.generation,
+        heartbeatAt: lease.heartbeatAt,
+        updatedAt: lease.updatedAt,
+        leaseTokenPresent: Boolean(lease.leaseToken),
+    };
+}
+function nowFromOptions(options) {
+    return options.now?.() ?? new Date();
+}
+async function remoteControlStatus(options) {
+    const hostedRunner = options.hostedRunner;
+    if (!hostedRunner?.enabled) {
+        return {
+            available: false,
+            status: "unavailable",
+            lease: null,
+        };
+    }
+    const now = nowFromOptions(options);
+    const maestroSessionId = hostedRunner.activeMaestroSessionId ??
+        hostedRunner.configuredMaestroSessionId;
+    const base = {
+        available: true,
+        runnerSessionId: hostedRunner.runnerSessionId,
+        ownerInstanceId: hostedRunner.ownerInstanceId,
+        workspaceRoot: hostedRunner.workspaceRoot,
+        snapshotRoot: hostedRunner.snapshotRoot,
+        workspaceId: hostedRunner.workspaceId,
+        agentId: hostedRunner.agentId,
+        agentRunId: hostedRunner.agentRunId,
+        a2aMessageId: hostedRunner.a2aMessageId,
+        a2aTaskId: hostedRunner.a2aTaskId,
+        agentRuntimeWorkerQueue: hostedRunner.agentRuntimeWorkerQueue,
+        agentRuntimeCorrelationPath: hostedRunner.agentRuntimeCorrelationPath,
+        maestroSessionId,
+        lastDrain: hostedRunner.lastDrain
+            ? { ...hostedRunner.lastDrain }
+            : undefined,
+        lease: toLease(hostedRunner, now),
+    };
+    if (hostedRunner.draining) {
+        return {
+            ...base,
+            status: "draining",
+        };
+    }
+    try {
+        const stats = await stat(hostedRunner.workspaceRoot);
+        if (!stats.isDirectory()) {
+            return {
+                ...base,
+                status: "unavailable",
+                error: "workspace root is not a directory",
+            };
+        }
+        return {
+            ...base,
+            status: "ready",
+        };
+    }
+    catch (error) {
+        return {
+            ...base,
+            status: "unavailable",
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function requireHostedRunner(options) {
+    if (!options.hostedRunner?.enabled) {
+        throw new MaestroAppServerDaemonLifecycleError(-32601, "Remote control lifecycle is not available");
+    }
+    return options.hostedRunner;
+}
+function drainInputFromParams(params) {
+    return {
+        reason: optionalString(params.reason, "reason") ??
+            optionalString(params.stop_reason, "stop_reason"),
+        requestedBy: optionalString(params.requestedBy, "requestedBy") ??
+            optionalString(params.requested_by, "requested_by"),
+        exportPaths: optionalStringArray(params.exportPaths, "exportPaths") ??
+            optionalStringArray(params.export_paths, "export_paths"),
+    };
+}
+function daemonLifecycleErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function apiStatusToJsonRpcCode(statusCode) {
+    switch (statusCode) {
+        case 400:
+            return -32602;
+        case 404:
+            return -32004;
+        case 503:
+            return -32005;
+        default:
+            return -32000;
+    }
+}
+function toDaemonLifecycleError(error) {
+    if (error instanceof MaestroAppServerDaemonLifecycleError) {
+        return error;
+    }
+    if (error instanceof ApiError) {
+        return new MaestroAppServerDaemonLifecycleError(apiStatusToJsonRpcCode(error.statusCode), error.message);
+    }
+    return new MaestroAppServerDaemonLifecycleError(-32000, daemonLifecycleErrorMessage(error));
+}
+export function createMaestroAppServerDaemonLifecycle(options = {}) {
+    const drainRunner = options.drainRunner ?? drainHostedRunner;
+    return {
+        capabilities() {
+            const remoteControlAvailable = Boolean(options.hostedRunner?.enabled);
+            return {
+                daemonStatus: true,
+                remoteControlStatus: remoteControlAvailable,
+                remoteControlLease: remoteControlAvailable,
+                remoteControlDrain: remoteControlAvailable,
+            };
+        },
+        async status() {
+            return {
+                daemon: {
+                    pid: process.pid,
+                    ppid: process.ppid,
+                    platform: process.platform,
+                    arch: process.arch,
+                    nodeVersion: process.version,
+                    cwd: resolve(process.cwd()),
+                    uptimeMs: Math.round(process.uptime() * 1000),
+                },
+                remoteControl: await remoteControlStatus(options),
+            };
+        },
+        async remoteControlStatus() {
+            requireHostedRunner(options);
+            return remoteControlStatus(options);
+        },
+        async readLease() {
+            const hostedRunner = requireHostedRunner(options);
+            return {
+                available: true,
+                lease: toLease(hostedRunner, nowFromOptions(options)),
+            };
+        },
+        async heartbeatLease() {
+            const hostedRunner = requireHostedRunner(options);
+            const lease = refreshHostedRunnerLease(hostedRunner, nowFromOptions(options));
+            return {
+                available: true,
+                lease: {
+                    protocolVersion: lease.protocolVersion,
+                    runnerSessionId: lease.runnerSessionId,
+                    ownerInstanceId: lease.ownerInstanceId,
+                    workspaceId: lease.workspaceId,
+                    agentId: lease.agentId,
+                    agentRunId: lease.agentRunId,
+                    maestroSessionId: lease.maestroSessionId,
+                    configuredMaestroSessionId: lease.configuredMaestroSessionId,
+                    state: lease.state,
+                    generation: lease.generation,
+                    heartbeatAt: lease.heartbeatAt,
+                    updatedAt: lease.updatedAt,
+                    leaseTokenPresent: Boolean(lease.leaseToken),
+                },
+            };
+        },
+        async drain(params = {}) {
+            const hostedRunner = requireHostedRunner(options);
+            let result;
+            try {
+                result = await drainRunner(drainInputFromParams(paramsRecord(params)), {
+                    hostedRunner,
+                    now: options.now,
+                });
+            }
+            catch (error) {
+                throw toDaemonLifecycleError(error);
+            }
+            if (!result) {
+                throw new MaestroAppServerDaemonLifecycleError(-32601, "Remote control drain is not available");
+            }
+            return {
+                drained: result.status === HostedRunnerDrainStatusValue.Drained,
+                status: result.status,
+                runnerSessionId: result.runner_session_id,
+                reason: result.reason,
+                requestedBy: result.requested_by,
+                manifestPath: result.manifest_path,
+                manifest: result.manifest,
+                remoteControl: await remoteControlStatus(options),
+            };
+        },
+    };
+}
+//# sourceMappingURL=daemon-lifecycle-api.js.map

package/dist/app-server/daemon-lifecycle-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-lifecycle-api.js","sourceRoot":"","sources":["../../src/app-server/daemon-lifecycle-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { stat } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type {\n\tMaestroAppServerDaemonStatusResult,\n\tMaestroAppServerRemoteControlDrainResult,\n\tMaestroAppServerRemoteControlLease,\n\tMaestroAppServerRemoteControlLeaseResult,\n\tMaestroAppServerRemoteControlStatusResult,\n} from \"@evalops/contracts\";\nimport type { HostedRunnerContext } from \"../server/app-context.js\";\nimport {\n\ttype HostedRunnerDrainInput,\n\tHostedRunnerDrainStatusValue,\n\tdrainHostedRunner,\n} from \"../server/handlers/hosted-runner-drain.js\";\nimport {\n\thostedRunnerLeaseSnapshot,\n\trefreshHostedRunnerLease,\n} from \"../server/hosted-runner-lease.js\";\nimport { ApiError } from \"../server/server-utils.js\";\n\ntype UnknownRecord = Record<string, unknown>;\ntype DrainRunner = typeof drainHostedRunner;\n\nexport class MaestroAppServerDaemonLifecycleError extends Error {\n\tconstructor(\n\t\treadonly code: number,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"MaestroAppServerDaemonLifecycleError\";\n\t}\n}\n\nexport interface MaestroAppServerDaemonLifecycleCapabilities {\n\tdaemonStatus: boolean;\n\tremoteControlStatus: boolean;\n\tremoteControlLease: boolean;\n\tremoteControlDrain: boolean;\n}\n\nexport interface MaestroAppServerDaemonLifecycle {\n\tcapabilities(): MaestroAppServerDaemonLifecycleCapabilities;\n\tstatus(params?: UnknownRecord): Promise<MaestroAppServerDaemonStatusResult>;\n\tremoteControlStatus(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerRemoteControlStatusResult>;\n\treadLease(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerRemoteControlLeaseResult>;\n\theartbeatLease(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerRemoteControlLeaseResult>;\n\tdrain(\n\t\tparams?: UnknownRecord,\n\t): Promise<MaestroAppServerRemoteControlDrainResult>;\n}\n\nexport interface MaestroAppServerDaemonLifecycleOptions {\n\thostedRunner?: HostedRunnerContext;\n\tdrainRunner?: DrainRunner;\n\tnow?: () => Date;\n}\n\nfunction optionalString(value: unknown, field: string): string | undefined {\n\tif (value === undefined || value === null) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}`);\n\t}\n\tconst trimmed = value.trim();\n\treturn trimmed || undefined;\n}\n\nfunction isRecord(value: unknown): value is UnknownRecord {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction paramsRecord(params: unknown): UnknownRecord {\n\tif (params === undefined) {\n\t\treturn {};\n\t}\n\tif (isRecord(params)) {\n\t\treturn params;\n\t}\n\tthrow new MaestroAppServerDaemonLifecycleError(-32602, \"Invalid params\");\n}\n\nfunction optionalStringArray(\n\tvalue: unknown,\n\tfield: string,\n): string[] | undefined {\n\tif (value === undefined || value === null) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(value)) {\n\t\tthrow new MaestroAppServerDaemonLifecycleError(-32602, `Invalid ${field}`);\n\t}\n\treturn value.map((entry, index) => {\n\t\tif (typeof entry !== \"string\" || !entry.trim()) {\n\t\t\tthrow new MaestroAppServerDaemonLifecycleError(\n\t\t\t\t-32602,\n\t\t\t\t`Invalid ${field}[${index}]`,\n\t\t\t);\n\t\t}\n\t\tif (entry.includes(\"\\0\")) {\n\t\t\tthrow new MaestroAppServerDaemonLifecycleError(\n\t\t\t\t-32602,\n\t\t\t\t`Invalid ${field}[${index}]`,\n\t\t\t);\n\t\t}\n\t\treturn entry.trim();\n\t});\n}\n\nfunction toLease(\n\thostedRunner: HostedRunnerContext,\n\tnow: Date,\n): MaestroAppServerRemoteControlLease {\n\tconst lease = hostedRunnerLeaseSnapshot(hostedRunner, now);\n\treturn {\n\t\tprotocolVersion: lease.protocolVersion,\n\t\trunnerSessionId: lease.runnerSessionId,\n\t\townerInstanceId: lease.ownerInstanceId,\n\t\tworkspaceId: lease.workspaceId,\n\t\tagentId: lease.agentId,\n\t\tagentRunId: lease.agentRunId,\n\t\tmaestroSessionId: lease.maestroSessionId,\n\t\tconfiguredMaestroSessionId: lease.configuredMaestroSessionId,\n\t\tstate: lease.state,\n\t\tgeneration: lease.generation,\n\t\theartbeatAt: lease.heartbeatAt,\n\t\tupdatedAt: lease.updatedAt,\n\t\tleaseTokenPresent: Boolean(lease.leaseToken),\n\t};\n}\n\nfunction nowFromOptions(options: MaestroAppServerDaemonLifecycleOptions): Date {\n\treturn options.now?.() ?? new Date();\n}\n\nasync function remoteControlStatus(\n\toptions: MaestroAppServerDaemonLifecycleOptions,\n): Promise<MaestroAppServerRemoteControlStatusResult> {\n\tconst hostedRunner = options.hostedRunner;\n\tif (!hostedRunner?.enabled) {\n\t\treturn {\n\t\t\tavailable: false,\n\t\t\tstatus: \"unavailable\",\n\t\t\tlease: null,\n\t\t};\n\t}\n\n\tconst now = nowFromOptions(options);\n\tconst maestroSessionId =\n\t\thostedRunner.activeMaestroSessionId ??\n\t\thostedRunner.configuredMaestroSessionId;\n\tconst base = {\n\t\tavailable: true,\n\t\trunnerSessionId: hostedRunner.runnerSessionId,\n\t\townerInstanceId: hostedRunner.ownerInstanceId,\n\t\tworkspaceRoot: hostedRunner.workspaceRoot,\n\t\tsnapshotRoot: hostedRunner.snapshotRoot,\n\t\tworkspaceId: hostedRunner.workspaceId,\n\t\tagentId: hostedRunner.agentId,\n\t\tagentRunId: hostedRunner.agentRunId,\n\t\ta2aMessageId: hostedRunner.a2aMessageId,\n\t\ta2aTaskId: hostedRunner.a2aTaskId,\n\t\tagentRuntimeWorkerQueue: hostedRunner.agentRuntimeWorkerQueue,\n\t\tagentRuntimeCorrelationPath: hostedRunner.agentRuntimeCorrelationPath,\n\t\tmaestroSessionId,\n\t\tlastDrain: hostedRunner.lastDrain\n\t\t\t? { ...hostedRunner.lastDrain }\n\t\t\t: undefined,\n\t\tlease: toLease(hostedRunner, now),\n\t};\n\n\tif (hostedRunner.draining) {\n\t\treturn {\n\t\t\t...base,\n\t\t\tstatus: \"draining\",\n\t\t};\n\t}\n\n\ttry {\n\t\tconst stats = await stat(hostedRunner.workspaceRoot);\n\t\tif (!stats.isDirectory()) {\n\t\t\treturn {\n\t\t\t\t...base,\n\t\t\t\tstatus: \"unavailable\",\n\t\t\t\terror: \"workspace root is not a directory\",\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\t...base,\n\t\t\tstatus: \"ready\",\n\t\t};\n\t} catch (error) {\n\t\treturn {\n\t\t\t...base,\n\t\t\tstatus: \"unavailable\",\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n}\n\nfunction requireHostedRunner(\n\toptions: MaestroAppServerDaemonLifecycleOptions,\n): HostedRunnerContext {\n\tif (!options.hostedRunner?.enabled) {\n\t\tthrow new MaestroAppServerDaemonLifecycleError(\n\t\t\t-32601,\n\t\t\t\"Remote control lifecycle is not available\",\n\t\t);\n\t}\n\treturn options.hostedRunner;\n}\n\nfunction drainInputFromParams(params: UnknownRecord): HostedRunnerDrainInput {\n\treturn {\n\t\treason:\n\t\t\toptionalString(params.reason, \"reason\") ??\n\t\t\toptionalString(params.stop_reason, \"stop_reason\"),\n\t\trequestedBy:\n\t\t\toptionalString(params.requestedBy, \"requestedBy\") ??\n\t\t\toptionalString(params.requested_by, \"requested_by\"),\n\t\texportPaths:\n\t\t\toptionalStringArray(params.exportPaths, \"exportPaths\") ??\n\t\t\toptionalStringArray(params.export_paths, \"export_paths\"),\n\t};\n}\n\nfunction daemonLifecycleErrorMessage(error: unknown): string {\n\treturn error instanceof Error ? error.message : String(error);\n}\n\nfunction apiStatusToJsonRpcCode(statusCode: number): number {\n\tswitch (statusCode) {\n\t\tcase 400:\n\t\t\treturn -32602;\n\t\tcase 404:\n\t\t\treturn -32004;\n\t\tcase 503:\n\t\t\treturn -32005;\n\t\tdefault:\n\t\t\treturn -32000;\n\t}\n}\n\nfunction toDaemonLifecycleError(\n\terror: unknown,\n): MaestroAppServerDaemonLifecycleError {\n\tif (error instanceof MaestroAppServerDaemonLifecycleError) {\n\t\treturn error;\n\t}\n\tif (error instanceof ApiError) {\n\t\treturn new MaestroAppServerDaemonLifecycleError(\n\t\t\tapiStatusToJsonRpcCode(error.statusCode),\n\t\t\terror.message,\n\t\t);\n\t}\n\treturn new MaestroAppServerDaemonLifecycleError(\n\t\t-32000,\n\t\tdaemonLifecycleErrorMessage(error),\n\t);\n}\n\nexport function createMaestroAppServerDaemonLifecycle(\n\toptions: MaestroAppServerDaemonLifecycleOptions = {},\n): MaestroAppServerDaemonLifecycle {\n\tconst drainRunner = options.drainRunner ?? drainHostedRunner;\n\treturn {\n\t\tcapabilities() {\n\t\t\tconst remoteControlAvailable = Boolean(options.hostedRunner?.enabled);\n\t\t\treturn {\n\t\t\t\tdaemonStatus: true,\n\t\t\t\tremoteControlStatus: remoteControlAvailable,\n\t\t\t\tremoteControlLease: remoteControlAvailable,\n\t\t\t\tremoteControlDrain: remoteControlAvailable,\n\t\t\t};\n\t\t},\n\n\t\tasync status() {\n\t\t\treturn {\n\t\t\t\tdaemon: {\n\t\t\t\t\tpid: process.pid,\n\t\t\t\t\tppid: process.ppid,\n\t\t\t\t\tplatform: process.platform,\n\t\t\t\t\tarch: process.arch,\n\t\t\t\t\tnodeVersion: process.version,\n\t\t\t\t\tcwd: resolve(process.cwd()),\n\t\t\t\t\tuptimeMs: Math.round(process.uptime() * 1000),\n\t\t\t\t},\n\t\t\t\tremoteControl: await remoteControlStatus(options),\n\t\t\t};\n\t\t},\n\n\t\tasync remoteControlStatus() {\n\t\t\trequireHostedRunner(options);\n\t\t\treturn remoteControlStatus(options);\n\t\t},\n\n\t\tasync readLease() {\n\t\t\tconst hostedRunner = requireHostedRunner(options);\n\t\t\treturn {\n\t\t\t\tavailable: true,\n\t\t\t\tlease: toLease(hostedRunner, nowFromOptions(options)),\n\t\t\t};\n\t\t},\n\n\t\tasync heartbeatLease() {\n\t\t\tconst hostedRunner = requireHostedRunner(options);\n\t\t\tconst lease = refreshHostedRunnerLease(\n\t\t\t\thostedRunner,\n\t\t\t\tnowFromOptions(options),\n\t\t\t);\n\t\t\treturn {\n\t\t\t\tavailable: true,\n\t\t\t\tlease: {\n\t\t\t\t\tprotocolVersion: lease.protocolVersion,\n\t\t\t\t\trunnerSessionId: lease.runnerSessionId,\n\t\t\t\t\townerInstanceId: lease.ownerInstanceId,\n\t\t\t\t\tworkspaceId: lease.workspaceId,\n\t\t\t\t\tagentId: lease.agentId,\n\t\t\t\t\tagentRunId: lease.agentRunId,\n\t\t\t\t\tmaestroSessionId: lease.maestroSessionId,\n\t\t\t\t\tconfiguredMaestroSessionId: lease.configuredMaestroSessionId,\n\t\t\t\t\tstate: lease.state,\n\t\t\t\t\tgeneration: lease.generation,\n\t\t\t\t\theartbeatAt: lease.heartbeatAt,\n\t\t\t\t\tupdatedAt: lease.updatedAt,\n\t\t\t\t\tleaseTokenPresent: Boolean(lease.leaseToken),\n\t\t\t\t},\n\t\t\t};\n\t\t},\n\n\t\tasync drain(params = {}) {\n\t\t\tconst hostedRunner = requireHostedRunner(options);\n\t\t\tlet result: Awaited<ReturnType<DrainRunner>>;\n\t\t\ttry {\n\t\t\t\tresult = await drainRunner(drainInputFromParams(paramsRecord(params)), {\n\t\t\t\t\thostedRunner,\n\t\t\t\t\tnow: options.now,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tthrow toDaemonLifecycleError(error);\n\t\t\t}\n\t\t\tif (!result) {\n\t\t\t\tthrow new MaestroAppServerDaemonLifecycleError(\n\t\t\t\t\t-32601,\n\t\t\t\t\t\"Remote control drain is not available\",\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tdrained: result.status === HostedRunnerDrainStatusValue.Drained,\n\t\t\t\tstatus: result.status,\n\t\t\t\trunnerSessionId: result.runner_session_id,\n\t\t\t\treason: result.reason,\n\t\t\t\trequestedBy: result.requested_by,\n\t\t\t\tmanifestPath: result.manifest_path,\n\t\t\t\tmanifest: result.manifest,\n\t\t\t\tremoteControl: await remoteControlStatus(options),\n\t\t\t};\n\t\t},\n\t};\n}\n"]}

package/dist/app-server/external-agent-import-api.d.ts

@@ -0,0 +1,30 @@
+import type { MaestroAppServerExternalAgentImportResult } from "@evalops/contracts";
+import { type SessionEntry } from "../session/types.js";
+type UnknownRecord = Record<string, unknown>;
+export declare class MaestroAppServerExternalAgentImportError extends Error {
+    readonly code: number;
+    constructor(code: number, message: string);
+}
+export interface MaestroAppServerExternalAgentSessionImporter {
+    importSessionEntries?: (entries: SessionEntry[]) => {
+        sessionFile: string;
+        sessionId: string;
+        importedCount: number;
+    };
+    importPortableSession?: (path: string) => {
+        sessionFile: string;
+        sessionId: string;
+        importedCount: number;
+    };
+}
+export interface MaestroAppServerExternalAgentImport {
+    importBundle(params?: UnknownRecord): Promise<MaestroAppServerExternalAgentImportResult>;
+}
+export interface MaestroAppServerExternalAgentImportOptions {
+    store?: MaestroAppServerExternalAgentSessionImporter;
+    projectRoot?: string;
+}
+export declare function normalizeExternalAgentImportParams(value: unknown): UnknownRecord;
+export declare function createMaestroAppServerExternalAgentImport(options?: MaestroAppServerExternalAgentImportOptions): MaestroAppServerExternalAgentImport;
+export {};
+//# sourceMappingURL=external-agent-import-api.d.ts.map

package/dist/app-server/external-agent-import-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-agent-import-api.d.ts","sourceRoot":"","sources":["../../src/app-server/external-agent-import-api.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACX,yCAAyC,EAGzC,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,EACN,KAAK,YAAY,EAGjB,MAAM,qBAAqB,CAAC;AAE7B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAG7C,qBAAa,wCAAyC,SAAQ,KAAK;IAEjE,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKhB;AAED,MAAM,WAAW,4CAA4C;IAC5D,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK;QACnD,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;CACF;AAED,MAAM,WAAW,mCAAmC;IACnD,YAAY,CACX,MAAM,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,yCAAyC,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,0CAA0C;IAC1D,KAAK,CAAC,EAAE,4CAA4C,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,OAAO,GACZ,aAAa,CAWf;AA6pBD,wBAAgB,yCAAyC,CACxD,OAAO,GAAE,0CAA+C,GACtD,mCAAmC,CAwBrC"}