@evalops/maestro 0.10.17 → 0.10.20

package/dist/platform/a2a-task-ledger.js

@@ -0,0 +1,546 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { extractA2AWorkGraphMetadata, normalizeA2AWorkGraphMetadata, } from "./a2a-work-graph.js";
+import { getEnvValue, trimString } from "./client.js";
+const FINAL_STATE_PATTERN = /(COMPLETED|FAILED|CANCELED|CANCELLED|REJECTED)/u;
+const ACTION_REQUIRED_STATE_PATTERN = /(INPUT_REQUIRED|AUTH_REQUIRED)/u;
+const LEDGER_LOCK_RETRY_MS = 25;
+const LEDGER_LOCK_HEARTBEAT_MS = 10_000;
+const LEDGER_LOCK_STALE_MS = 30_000;
+const LEDGER_LOCK_TIMEOUT_MS = LEDGER_LOCK_STALE_MS + LEDGER_LOCK_RETRY_MS;
+const LEDGER_LOCK_OWNER_FILE = "owner";
+const LEDGER_LOCK_HEARTBEAT_FILE = "heartbeat";
+export function getA2ATaskLedgerPath(path) {
+    const configured = trimString(path) ??
+        getEnvValue(["MAESTRO_A2A_TASKS_FILE", "CODEX_A2A_TASKS_FILE"]);
+    if (configured) {
+        return expandHome(configured);
+    }
+    return join(homedir(), ".maestro", "a2a", "tasks.json");
+}
+export async function loadA2ATaskLedger(options = {}) {
+    const path = getA2ATaskLedgerPath(options.path);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (hasNodeCode(error, "ENOENT")) {
+            return { tasks: [] };
+        }
+        throw error;
+    }
+    const parsed = JSON.parse(raw);
+    if (!isRecord(parsed)) {
+        throw new Error(`A2A task ledger at ${path} must be a JSON object`);
+    }
+    const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+    return {
+        tasks: tasks.map((task, index) => normalizeLedgerEntry(task, `tasks[${index}]`)),
+    };
+}
+export async function saveA2ATaskLedger(ledger, options = {}) {
+    return withA2ATaskLedgerLock(options, () => writeA2ATaskLedger(ledger, options));
+}
+async function writeA2ATaskLedger(ledger, options = {}) {
+    const path = getA2ATaskLedgerPath(options.path);
+    const tempPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    try {
+        await writeFile(tempPath, `${JSON.stringify(ledger, null, 2)}\n`, {
+            mode: 0o600,
+        });
+        await rename(tempPath, path);
+    }
+    catch (error) {
+        await rm(tempPath, { force: true }).catch(() => undefined);
+        throw error;
+    }
+    return path;
+}
+async function withA2ATaskLedgerLock(options, fn) {
+    const path = getA2ATaskLedgerPath(options.path);
+    const lockPath = `${path}.lock`;
+    const lockToken = `${process.pid}:${randomUUID()}`;
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const deadline = Date.now() + LEDGER_LOCK_TIMEOUT_MS;
+    for (;;) {
+        try {
+            await mkdir(lockPath, { mode: 0o700 });
+            await writeLedgerLockMetadata(lockPath, lockToken);
+            break;
+        }
+        catch (error) {
+            if (!hasNodeCode(error, "EEXIST")) {
+                throw error;
+            }
+            if (await isStaleLedgerLock(lockPath)) {
+                await rm(lockPath, { force: true, recursive: true });
+                continue;
+            }
+            if (Date.now() >= deadline) {
+                throw error;
+            }
+            await sleep(LEDGER_LOCK_RETRY_MS);
+        }
+    }
+    const stopHeartbeat = startLedgerLockHeartbeat(lockPath, lockToken);
+    try {
+        return await fn();
+    }
+    finally {
+        stopHeartbeat();
+        if (await isOwnedLedgerLock(lockPath, lockToken)) {
+            await rm(lockPath, { force: true, recursive: true });
+        }
+    }
+}
+async function writeLedgerLockMetadata(lockPath, lockToken) {
+    try {
+        await writeFile(join(lockPath, LEDGER_LOCK_OWNER_FILE), `${lockToken}\n`, {
+            mode: 0o600,
+        });
+        await writeLedgerLockHeartbeat(lockPath);
+    }
+    catch (error) {
+        await rm(lockPath, { force: true, recursive: true }).catch(() => undefined);
+        throw error;
+    }
+}
+function startLedgerLockHeartbeat(lockPath, lockToken) {
+    const interval = setInterval(() => {
+        void refreshLedgerLockHeartbeat(lockPath, lockToken);
+    }, LEDGER_LOCK_HEARTBEAT_MS);
+    if (typeof interval === "object" &&
+        "unref" in interval &&
+        typeof interval.unref === "function") {
+        interval.unref();
+    }
+    return () => clearInterval(interval);
+}
+async function refreshLedgerLockHeartbeat(lockPath, lockToken) {
+    try {
+        if (await isOwnedLedgerLock(lockPath, lockToken)) {
+            await writeLedgerLockHeartbeat(lockPath);
+        }
+    }
+    catch {
+        // Best-effort only; ownership is re-checked before lock cleanup.
+    }
+}
+async function writeLedgerLockHeartbeat(lockPath) {
+    await writeFile(join(lockPath, LEDGER_LOCK_HEARTBEAT_FILE), `${Date.now()}\n`, { mode: 0o600 });
+}
+async function isOwnedLedgerLock(lockPath, lockToken) {
+    try {
+        const owner = await readFile(join(lockPath, LEDGER_LOCK_OWNER_FILE), "utf8");
+        return owner.trim() === lockToken;
+    }
+    catch {
+        return false;
+    }
+}
+async function isStaleLedgerLock(lockPath) {
+    try {
+        const lock = await statLedgerLockHeartbeat(lockPath);
+        return Date.now() - lock.mtimeMs > LEDGER_LOCK_STALE_MS;
+    }
+    catch (error) {
+        return hasNodeCode(error, "ENOENT");
+    }
+}
+async function statLedgerLockHeartbeat(lockPath) {
+    for (const path of [
+        join(lockPath, LEDGER_LOCK_HEARTBEAT_FILE),
+        join(lockPath, LEDGER_LOCK_OWNER_FILE),
+        lockPath,
+    ]) {
+        try {
+            return await stat(path);
+        }
+        catch (error) {
+            if (!hasNodeCode(error, "ENOENT")) {
+                throw error;
+            }
+        }
+    }
+    throw Object.assign(new Error(`Ledger lock ${lockPath} does not exist`), {
+        code: "ENOENT",
+    });
+}
+export async function recordA2ATaskStart(input) {
+    return withA2ATaskLedgerLock(input, async () => {
+        const ledger = await loadA2ATaskLedger(input);
+        const now = (input.now ?? new Date()).toISOString();
+        const taskId = trimString(input.task.id) ?? fail("A2A task id is required");
+        const existingIndex = ledger.tasks.findIndex((entry) => entry.peer === input.peer && entry.taskId === taskId);
+        const metadata = cleanMetadata(input.metadata);
+        const workGraph = extractA2AWorkGraphMetadata(input.task);
+        const userText = input.text.trim();
+        const entry = {
+            ...(existingIndex >= 0 ? ledger.tasks[existingIndex] : {}),
+            id: existingIndex >= 0
+                ? ledger.tasks[existingIndex].id
+                : `maestro-a2a-task-${randomUUID()}`,
+            kind: input.kind ?? "delegation",
+            peer: input.peer,
+            ...(input.peerDisplayName
+                ? { peerDisplayName: input.peerDisplayName }
+                : {}),
+            taskId,
+            ...(trimString(input.task.contextId ?? input.contextId)
+                ? { contextId: trimString(input.task.contextId ?? input.contextId) }
+                : {}),
+            ...(trimString(input.messageId)
+                ? { messageId: trimString(input.messageId) }
+                : {}),
+            text: userText,
+            ...(trimString(input.role) ? { role: trimString(input.role) } : {}),
+            ...(trimString(input.cwd) ? { cwd: trimString(input.cwd) } : {}),
+            state: input.task.status.state,
+            ...(metadata ? { metadata } : {}),
+            ...(workGraph ? { workGraph } : {}),
+            transcript: [
+                {
+                    at: now,
+                    role: "user",
+                    text: userText,
+                    ...(trimString(input.messageId)
+                        ? { messageId: trimString(input.messageId) }
+                        : {}),
+                },
+            ],
+            createdAt: existingIndex >= 0 ? ledger.tasks[existingIndex].createdAt : now,
+            updatedAt: now,
+        };
+        const taskResponse = extractA2ATaskResponse(input.task);
+        if (taskResponse) {
+            entry.responseText = taskResponse.text;
+            entry.transcript.push({
+                at: now,
+                role: "agent",
+                text: taskResponse.text,
+                state: input.task.status.state,
+                messageId: taskResponse.messageId,
+            });
+        }
+        if (isFinalA2AState(entry.state)) {
+            entry.completedAt = now;
+        }
+        else {
+            delete entry.completedAt;
+        }
+        if (existingIndex >= 0) {
+            ledger.tasks[existingIndex] = entry;
+        }
+        else {
+            ledger.tasks.push(entry);
+        }
+        const path = await writeA2ATaskLedger(ledger, input);
+        return { entry, path };
+    });
+}
+export async function recordA2ATaskReply(input) {
+    return withA2ATaskLedgerLock(input, async () => {
+        const ledger = await loadA2ATaskLedger(input);
+        const now = (input.now ?? new Date()).toISOString();
+        const taskId = trimString(input.task.id) ?? fail("A2A task id is required");
+        const existingIndex = ledger.tasks.findIndex((entry) => entry.peer === input.peer && entry.taskId === taskId);
+        const previous = existingIndex >= 0 ? ledger.tasks[existingIndex] : undefined;
+        const metadata = cleanMetadata({
+            ...(previous?.metadata ?? {}),
+            ...(input.metadata ?? {}),
+        });
+        const workGraph = extractA2AWorkGraphMetadata(input.task) ?? previous?.workGraph;
+        const userText = input.text.trim();
+        const taskResponse = extractA2ATaskResponse(input.task);
+        const responseText = taskResponse?.text ?? previous?.responseText;
+        const entry = {
+            ...(previous ?? {}),
+            id: previous?.id ?? `maestro-a2a-task-${randomUUID()}`,
+            kind: previous?.kind ?? "message",
+            peer: input.peer,
+            ...((input.peerDisplayName ?? previous?.peerDisplayName)
+                ? {
+                    peerDisplayName: input.peerDisplayName ?? previous?.peerDisplayName,
+                }
+                : {}),
+            taskId,
+            ...(trimString(input.task.contextId ?? previous?.contextId)
+                ? { contextId: trimString(input.task.contextId ?? previous?.contextId) }
+                : {}),
+            messageId: input.messageId,
+            text: previous?.text ?? userText,
+            ...(previous?.role ? { role: previous.role } : {}),
+            ...(previous?.cwd ? { cwd: previous.cwd } : {}),
+            state: input.task.status.state,
+            ...(responseText ? { responseText } : {}),
+            ...(metadata ? { metadata } : {}),
+            ...(workGraph ? { workGraph } : {}),
+            transcript: [
+                ...(previous?.transcript ?? []),
+                {
+                    at: now,
+                    role: "user",
+                    text: userText,
+                    messageId: input.messageId,
+                },
+            ],
+            createdAt: previous?.createdAt ?? now,
+            updatedAt: now,
+            ...(previous?.completedAt ? { completedAt: previous.completedAt } : {}),
+        };
+        if (taskResponse && shouldAppendAgentTranscript(entry, taskResponse)) {
+            entry.transcript = [
+                ...entry.transcript,
+                {
+                    at: now,
+                    role: "agent",
+                    text: taskResponse.text,
+                    state: input.task.status.state,
+                    messageId: taskResponse.messageId,
+                },
+            ];
+        }
+        if (isFinalA2AState(input.task.status.state)) {
+            entry.completedAt = previous?.completedAt ?? now;
+        }
+        else {
+            delete entry.completedAt;
+        }
+        if (existingIndex >= 0) {
+            ledger.tasks[existingIndex] = entry;
+        }
+        else {
+            ledger.tasks.push(entry);
+        }
+        const path = await writeA2ATaskLedger(ledger, input);
+        return { entry, path };
+    });
+}
+export async function updateA2ATaskInLedger(input) {
+    return withA2ATaskLedgerLock(input, async () => {
+        const ledger = await loadA2ATaskLedger(input);
+        const taskId = trimString(input.task.id) ?? fail("A2A task id is required");
+        const index = ledger.tasks.findIndex((entry) => entry.peer === input.peer && entry.taskId === taskId);
+        const path = getA2ATaskLedgerPath(input.path);
+        if (index < 0) {
+            return { entry: null, path };
+        }
+        const now = (input.now ?? new Date()).toISOString();
+        const previous = ledger.tasks[index];
+        const taskResponse = extractA2ATaskResponse(input.task);
+        const responseText = taskResponse?.text ?? previous.responseText;
+        const workGraph = extractA2AWorkGraphMetadata(input.task) ?? previous.workGraph;
+        const entry = {
+            ...previous,
+            state: input.task.status.state,
+            ...(trimString(input.task.contextId)
+                ? { contextId: trimString(input.task.contextId) }
+                : {}),
+            ...(responseText ? { responseText } : {}),
+            ...(workGraph ? { workGraph } : {}),
+            updatedAt: now,
+            ...(isFinalA2AState(input.task.status.state)
+                ? { completedAt: previous.completedAt ?? now }
+                : {}),
+        };
+        if (!isFinalA2AState(input.task.status.state)) {
+            delete entry.completedAt;
+        }
+        if (taskResponse && shouldAppendAgentTranscript(entry, taskResponse)) {
+            entry.transcript = [
+                ...entry.transcript,
+                {
+                    at: now,
+                    role: "agent",
+                    text: taskResponse.text,
+                    state: input.task.status.state,
+                    messageId: taskResponse.messageId,
+                },
+            ];
+        }
+        ledger.tasks[index] = entry;
+        await writeA2ATaskLedger(ledger, input);
+        return { entry, path };
+    });
+}
+export function listA2ATaskEntries(ledger, options = {}) {
+    const peer = trimString(options.peer);
+    return ledger.tasks
+        .filter((entry) => !peer || entry.peer === peer)
+        .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+export function latestA2ATaskForPeer(ledger, peer) {
+    return listA2ATaskEntries(ledger, { peer })[0];
+}
+export function extractA2ATaskText(task) {
+    return extractA2ATaskResponse(task)?.text;
+}
+function extractA2ATaskResponse(task) {
+    const statusText = firstMessageText(task.status.message);
+    if (statusText) {
+        return {
+            text: statusText,
+            messageId: task.status.message?.messageId,
+        };
+    }
+    const artifactText = task.artifacts
+        ?.flatMap((artifact) => artifact.parts)
+        .map((part) => trimString(part.text))
+        .find((text) => Boolean(text));
+    if (artifactText) {
+        return { text: artifactText };
+    }
+    const latestAgentMessage = latestAgentMessageInHistory(task.history);
+    const historyText = firstMessageText(latestAgentMessage);
+    if (historyText) {
+        return {
+            text: historyText,
+            messageId: latestAgentMessage?.messageId,
+        };
+    }
+    return undefined;
+}
+function shouldAppendAgentTranscript(entry, response) {
+    if (response.messageId) {
+        return !entry.transcript.some((item) => item.role === "agent" && item.messageId === response.messageId);
+    }
+    const last = entry.transcript.at(-1);
+    return !last || last.role !== "agent" || last.text !== response.text;
+}
+export function isTerminalA2AState(state) {
+    return isFinalA2AState(state) || isActionRequiredA2AState(state);
+}
+export function isFinalA2AState(state) {
+    return FINAL_STATE_PATTERN.test(state.toUpperCase().replace(/[\s-]+/gu, "_"));
+}
+export function isActionRequiredA2AState(state) {
+    return ACTION_REQUIRED_STATE_PATTERN.test(state.toUpperCase().replace(/[\s-]+/gu, "_"));
+}
+function firstMessageText(message) {
+    return message?.parts.map((part) => trimString(part.text)).find(Boolean);
+}
+function isAgentMessage(message) {
+    const role = message.role.toUpperCase();
+    return role === "ROLE_AGENT" || role === "AGENT";
+}
+function latestAgentMessageInHistory(history) {
+    if (!history) {
+        return undefined;
+    }
+    for (const message of [...history].reverse()) {
+        if (!isAgentMessage(message)) {
+            continue;
+        }
+        if (firstMessageText(message)) {
+            return message;
+        }
+    }
+    return undefined;
+}
+function normalizeLedgerEntry(input, path) {
+    if (!isRecord(input)) {
+        throw new Error(`A2A task ledger ${path} must be a JSON object`);
+    }
+    const id = requiredString(input.id, `${path}.id`);
+    const peer = requiredString(input.peer, `${path}.peer`);
+    const taskId = requiredString(input.taskId, `${path}.taskId`);
+    const text = requiredString(input.text, `${path}.text`);
+    const state = requiredString(input.state, `${path}.state`);
+    const createdAt = requiredString(input.createdAt, `${path}.createdAt`);
+    const updatedAt = requiredString(input.updatedAt, `${path}.updatedAt`);
+    const transcript = Array.isArray(input.transcript)
+        ? input.transcript.map((item, index) => normalizeTranscriptEntry(item, `${path}.transcript[${index}]`))
+        : [];
+    const entry = {
+        id,
+        kind: input.kind === "message" ? "message" : "delegation",
+        peer,
+        taskId,
+        text,
+        state,
+        transcript,
+        createdAt,
+        updatedAt,
+    };
+    for (const key of [
+        "peerDisplayName",
+        "contextId",
+        "messageId",
+        "role",
+        "cwd",
+        "responseText",
+        "completedAt",
+    ]) {
+        const value = stringValue(input[key]);
+        if (value) {
+            entry[key] = value;
+        }
+    }
+    if (isRecord(input.metadata)) {
+        entry.metadata = cleanMetadata(input.metadata);
+    }
+    const workGraph = normalizeA2AWorkGraphMetadata(input.workGraph);
+    if (workGraph) {
+        entry.workGraph = workGraph;
+    }
+    return entry;
+}
+function normalizeTranscriptEntry(input, path) {
+    if (!isRecord(input)) {
+        throw new Error(`A2A task ledger ${path} must be a JSON object`);
+    }
+    const role = input.role === "agent" ? "agent" : "user";
+    const entry = {
+        at: requiredString(input.at, `${path}.at`),
+        role,
+        text: requiredString(input.text, `${path}.text`),
+    };
+    for (const key of ["state", "messageId"]) {
+        const value = stringValue(input[key]);
+        if (value) {
+            entry[key] = value;
+        }
+    }
+    return entry;
+}
+function cleanMetadata(input) {
+    if (!input) {
+        return undefined;
+    }
+    const entries = Object.entries(input).filter((entry) => typeof entry[1] === "string" ||
+        typeof entry[1] === "number" ||
+        typeof entry[1] === "boolean");
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function stringValue(input) {
+    return typeof input === "string" ? trimString(input) : undefined;
+}
+function requiredString(input, path) {
+    const value = stringValue(input);
+    if (!value) {
+        throw new Error(`A2A task ledger ${path} is required`);
+    }
+    return value;
+}
+function expandHome(path) {
+    return path === "~" || path.startsWith("~/")
+        ? join(homedir(), path.slice(2))
+        : path;
+}
+function hasNodeCode(error, code) {
+    return isRecord(error) && error.code === code;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function fail(message) {
+    throw new Error(message);
+}
+//# sourceMappingURL=a2a-task-ledger.js.map

package/dist/platform/a2a-task-ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-task-ledger.js","sourceRoot":"","sources":["../../src/platform/a2a-task-ledger.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport type { A2AMessage, A2ATask } from \"./a2a-client.js\";\nimport {\n\ttype A2AWorkGraphMetadata,\n\textractA2AWorkGraphMetadata,\n\tnormalizeA2AWorkGraphMetadata,\n} from \"./a2a-work-graph.js\";\nimport { getEnvValue, trimString } from \"./client.js\";\n\nexport type A2ATaskKind = \"delegation\" | \"message\";\nexport type A2ATranscriptRole = \"user\" | \"agent\";\n\nexport interface A2ATaskTranscriptEntry {\n\tat: string;\n\trole: A2ATranscriptRole;\n\ttext: string;\n\tstate?: string;\n\tmessageId?: string;\n}\n\nexport interface A2ATaskLedgerEntry {\n\tid: string;\n\tkind: A2ATaskKind;\n\tpeer: string;\n\tpeerDisplayName?: string;\n\ttaskId: string;\n\tcontextId?: string;\n\tmessageId?: string;\n\ttext: string;\n\trole?: string;\n\tcwd?: string;\n\tstate: string;\n\tresponseText?: string;\n\tmetadata?: Record<string, string | number | boolean>;\n\tworkGraph?: A2AWorkGraphMetadata;\n\ttranscript: A2ATaskTranscriptEntry[];\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tcompletedAt?: string;\n}\n\nexport interface A2ATaskLedgerFile {\n\ttasks: A2ATaskLedgerEntry[];\n}\n\nexport interface A2ATaskLedgerOptions {\n\tpath?: string;\n\tnow?: Date;\n}\n\nexport interface RecordA2ATaskStartInput extends A2ATaskLedgerOptions {\n\tpeer: string;\n\tpeerDisplayName?: string;\n\ttask: A2ATask;\n\ttext: string;\n\tmessageId?: string;\n\tcontextId?: string;\n\tkind?: A2ATaskKind;\n\trole?: string;\n\tcwd?: string;\n\tmetadata?: Record<string, string | number | boolean | undefined>;\n}\n\nexport interface UpdateA2ATaskInput extends A2ATaskLedgerOptions {\n\tpeer: string;\n\ttask: A2ATask;\n}\n\nexport interface RecordA2ATaskReplyInput extends A2ATaskLedgerOptions {\n\tpeer: string;\n\tpeerDisplayName?: string;\n\ttask: A2ATask;\n\ttext: string;\n\tmessageId: string;\n\tmetadata?: Record<string, string | number | boolean | undefined>;\n}\n\ninterface A2ATaskResponseText {\n\ttext: string;\n\tmessageId?: string;\n}\n\nconst FINAL_STATE_PATTERN = /(COMPLETED|FAILED|CANCELED|CANCELLED|REJECTED)/u;\nconst ACTION_REQUIRED_STATE_PATTERN = /(INPUT_REQUIRED|AUTH_REQUIRED)/u;\nconst LEDGER_LOCK_RETRY_MS = 25;\nconst LEDGER_LOCK_HEARTBEAT_MS = 10_000;\nconst LEDGER_LOCK_STALE_MS = 30_000;\nconst LEDGER_LOCK_TIMEOUT_MS = LEDGER_LOCK_STALE_MS + LEDGER_LOCK_RETRY_MS;\nconst LEDGER_LOCK_OWNER_FILE = \"owner\";\nconst LEDGER_LOCK_HEARTBEAT_FILE = \"heartbeat\";\n\nexport function getA2ATaskLedgerPath(path?: string): string {\n\tconst configured =\n\t\ttrimString(path) ??\n\t\tgetEnvValue([\"MAESTRO_A2A_TASKS_FILE\", \"CODEX_A2A_TASKS_FILE\"]);\n\tif (configured) {\n\t\treturn expandHome(configured);\n\t}\n\treturn join(homedir(), \".maestro\", \"a2a\", \"tasks.json\");\n}\n\nexport async function loadA2ATaskLedger(\n\toptions: A2ATaskLedgerOptions = {},\n): Promise<A2ATaskLedgerFile> {\n\tconst path = getA2ATaskLedgerPath(options.path);\n\tlet raw: string;\n\ttry {\n\t\traw = await readFile(path, \"utf8\");\n\t} catch (error) {\n\t\tif (hasNodeCode(error, \"ENOENT\")) {\n\t\t\treturn { tasks: [] };\n\t\t}\n\t\tthrow error;\n\t}\n\tconst parsed = JSON.parse(raw) as unknown;\n\tif (!isRecord(parsed)) {\n\t\tthrow new Error(`A2A task ledger at ${path} must be a JSON object`);\n\t}\n\tconst tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];\n\treturn {\n\t\ttasks: tasks.map((task, index) =>\n\t\t\tnormalizeLedgerEntry(task, `tasks[${index}]`),\n\t\t),\n\t};\n}\n\nexport async function saveA2ATaskLedger(\n\tledger: A2ATaskLedgerFile,\n\toptions: A2ATaskLedgerOptions = {},\n): Promise<string> {\n\treturn withA2ATaskLedgerLock(options, () =>\n\t\twriteA2ATaskLedger(ledger, options),\n\t);\n}\n\nasync function writeA2ATaskLedger(\n\tledger: A2ATaskLedgerFile,\n\toptions: A2ATaskLedgerOptions = {},\n): Promise<string> {\n\tconst path = getA2ATaskLedgerPath(options.path);\n\tconst tempPath = `${path}.${process.pid}.${randomUUID()}.tmp`;\n\tawait mkdir(dirname(path), { recursive: true, mode: 0o700 });\n\ttry {\n\t\tawait writeFile(tempPath, `${JSON.stringify(ledger, null, 2)}\\n`, {\n\t\t\tmode: 0o600,\n\t\t});\n\t\tawait rename(tempPath, path);\n\t} catch (error) {\n\t\tawait rm(tempPath, { force: true }).catch(() => undefined);\n\t\tthrow error;\n\t}\n\treturn path;\n}\n\nasync function withA2ATaskLedgerLock<T>(\n\toptions: A2ATaskLedgerOptions,\n\tfn: () => Promise<T>,\n): Promise<T> {\n\tconst path = getA2ATaskLedgerPath(options.path);\n\tconst lockPath = `${path}.lock`;\n\tconst lockToken = `${process.pid}:${randomUUID()}`;\n\tawait mkdir(dirname(path), { recursive: true, mode: 0o700 });\n\tconst deadline = Date.now() + LEDGER_LOCK_TIMEOUT_MS;\n\tfor (;;) {\n\t\ttry {\n\t\t\tawait mkdir(lockPath, { mode: 0o700 });\n\t\t\tawait writeLedgerLockMetadata(lockPath, lockToken);\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tif (!hasNodeCode(error, \"EEXIST\")) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tif (await isStaleLedgerLock(lockPath)) {\n\t\t\t\tawait rm(lockPath, { force: true, recursive: true });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (Date.now() >= deadline) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tawait sleep(LEDGER_LOCK_RETRY_MS);\n\t\t}\n\t}\n\tconst stopHeartbeat = startLedgerLockHeartbeat(lockPath, lockToken);\n\ttry {\n\t\treturn await fn();\n\t} finally {\n\t\tstopHeartbeat();\n\t\tif (await isOwnedLedgerLock(lockPath, lockToken)) {\n\t\t\tawait rm(lockPath, { force: true, recursive: true });\n\t\t}\n\t}\n}\n\nasync function writeLedgerLockMetadata(\n\tlockPath: string,\n\tlockToken: string,\n): Promise<void> {\n\ttry {\n\t\tawait writeFile(join(lockPath, LEDGER_LOCK_OWNER_FILE), `${lockToken}\\n`, {\n\t\t\tmode: 0o600,\n\t\t});\n\t\tawait writeLedgerLockHeartbeat(lockPath);\n\t} catch (error) {\n\t\tawait rm(lockPath, { force: true, recursive: true }).catch(() => undefined);\n\t\tthrow error;\n\t}\n}\n\nfunction startLedgerLockHeartbeat(\n\tlockPath: string,\n\tlockToken: string,\n): () => void {\n\tconst interval: ReturnType<typeof setInterval> = setInterval(() => {\n\t\tvoid refreshLedgerLockHeartbeat(lockPath, lockToken);\n\t}, LEDGER_LOCK_HEARTBEAT_MS);\n\tif (\n\t\ttypeof interval === \"object\" &&\n\t\t\"unref\" in interval &&\n\t\ttypeof interval.unref === \"function\"\n\t) {\n\t\tinterval.unref();\n\t}\n\treturn () => clearInterval(interval);\n}\n\nasync function refreshLedgerLockHeartbeat(\n\tlockPath: string,\n\tlockToken: string,\n): Promise<void> {\n\ttry {\n\t\tif (await isOwnedLedgerLock(lockPath, lockToken)) {\n\t\t\tawait writeLedgerLockHeartbeat(lockPath);\n\t\t}\n\t} catch {\n\t\t// Best-effort only; ownership is re-checked before lock cleanup.\n\t}\n}\n\nasync function writeLedgerLockHeartbeat(lockPath: string): Promise<void> {\n\tawait writeFile(\n\t\tjoin(lockPath, LEDGER_LOCK_HEARTBEAT_FILE),\n\t\t`${Date.now()}\\n`,\n\t\t{ mode: 0o600 },\n\t);\n}\n\nasync function isOwnedLedgerLock(\n\tlockPath: string,\n\tlockToken: string,\n): Promise<boolean> {\n\ttry {\n\t\tconst owner = await readFile(\n\t\t\tjoin(lockPath, LEDGER_LOCK_OWNER_FILE),\n\t\t\t\"utf8\",\n\t\t);\n\t\treturn owner.trim() === lockToken;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function isStaleLedgerLock(lockPath: string): Promise<boolean> {\n\ttry {\n\t\tconst lock = await statLedgerLockHeartbeat(lockPath);\n\t\treturn Date.now() - lock.mtimeMs > LEDGER_LOCK_STALE_MS;\n\t} catch (error) {\n\t\treturn hasNodeCode(error, \"ENOENT\");\n\t}\n}\n\nasync function statLedgerLockHeartbeat(\n\tlockPath: string,\n): Promise<{ mtimeMs: number }> {\n\tfor (const path of [\n\t\tjoin(lockPath, LEDGER_LOCK_HEARTBEAT_FILE),\n\t\tjoin(lockPath, LEDGER_LOCK_OWNER_FILE),\n\t\tlockPath,\n\t]) {\n\t\ttry {\n\t\t\treturn await stat(path);\n\t\t} catch (error) {\n\t\t\tif (!hasNodeCode(error, \"ENOENT\")) {\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\tthrow Object.assign(new Error(`Ledger lock ${lockPath} does not exist`), {\n\t\tcode: \"ENOENT\",\n\t});\n}\n\nexport async function recordA2ATaskStart(\n\tinput: RecordA2ATaskStartInput,\n): Promise<{ entry: A2ATaskLedgerEntry; path: string }> {\n\treturn withA2ATaskLedgerLock(input, async () => {\n\t\tconst ledger = await loadA2ATaskLedger(input);\n\t\tconst now = (input.now ?? new Date()).toISOString();\n\t\tconst taskId = trimString(input.task.id) ?? fail(\"A2A task id is required\");\n\t\tconst existingIndex = ledger.tasks.findIndex(\n\t\t\t(entry) => entry.peer === input.peer && entry.taskId === taskId,\n\t\t);\n\t\tconst metadata = cleanMetadata(input.metadata);\n\t\tconst workGraph = extractA2AWorkGraphMetadata(input.task);\n\t\tconst userText = input.text.trim();\n\t\tconst entry: A2ATaskLedgerEntry = {\n\t\t\t...(existingIndex >= 0 ? ledger.tasks[existingIndex] : {}),\n\t\t\tid:\n\t\t\t\texistingIndex >= 0\n\t\t\t\t\t? ledger.tasks[existingIndex]!.id\n\t\t\t\t\t: `maestro-a2a-task-${randomUUID()}`,\n\t\t\tkind: input.kind ?? \"delegation\",\n\t\t\tpeer: input.peer,\n\t\t\t...(input.peerDisplayName\n\t\t\t\t? { peerDisplayName: input.peerDisplayName }\n\t\t\t\t: {}),\n\t\t\ttaskId,\n\t\t\t...(trimString(input.task.contextId ?? input.contextId)\n\t\t\t\t? { contextId: trimString(input.task.contextId ?? input.contextId) }\n\t\t\t\t: {}),\n\t\t\t...(trimString(input.messageId)\n\t\t\t\t? { messageId: trimString(input.messageId) }\n\t\t\t\t: {}),\n\t\t\ttext: userText,\n\t\t\t...(trimString(input.role) ? { role: trimString(input.role) } : {}),\n\t\t\t...(trimString(input.cwd) ? { cwd: trimString(input.cwd) } : {}),\n\t\t\tstate: input.task.status.state,\n\t\t\t...(metadata ? { metadata } : {}),\n\t\t\t...(workGraph ? { workGraph } : {}),\n\t\t\ttranscript: [\n\t\t\t\t{\n\t\t\t\t\tat: now,\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\ttext: userText,\n\t\t\t\t\t...(trimString(input.messageId)\n\t\t\t\t\t\t? { messageId: trimString(input.messageId) }\n\t\t\t\t\t\t: {}),\n\t\t\t\t},\n\t\t\t],\n\t\t\tcreatedAt:\n\t\t\t\texistingIndex >= 0 ? ledger.tasks[existingIndex]!.createdAt : now,\n\t\t\tupdatedAt: now,\n\t\t};\n\t\tconst taskResponse = extractA2ATaskResponse(input.task);\n\t\tif (taskResponse) {\n\t\t\tentry.responseText = taskResponse.text;\n\t\t\tentry.transcript.push({\n\t\t\t\tat: now,\n\t\t\t\trole: \"agent\",\n\t\t\t\ttext: taskResponse.text,\n\t\t\t\tstate: input.task.status.state,\n\t\t\t\tmessageId: taskResponse.messageId,\n\t\t\t});\n\t\t}\n\t\tif (isFinalA2AState(entry.state)) {\n\t\t\tentry.completedAt = now;\n\t\t} else {\n\t\t\tdelete entry.completedAt;\n\t\t}\n\t\tif (existingIndex >= 0) {\n\t\t\tledger.tasks[existingIndex] = entry;\n\t\t} else {\n\t\t\tledger.tasks.push(entry);\n\t\t}\n\t\tconst path = await writeA2ATaskLedger(ledger, input);\n\t\treturn { entry, path };\n\t});\n}\n\nexport async function recordA2ATaskReply(\n\tinput: RecordA2ATaskReplyInput,\n): Promise<{ entry: A2ATaskLedgerEntry; path: string }> {\n\treturn withA2ATaskLedgerLock(input, async () => {\n\t\tconst ledger = await loadA2ATaskLedger(input);\n\t\tconst now = (input.now ?? new Date()).toISOString();\n\t\tconst taskId = trimString(input.task.id) ?? fail(\"A2A task id is required\");\n\t\tconst existingIndex = ledger.tasks.findIndex(\n\t\t\t(entry) => entry.peer === input.peer && entry.taskId === taskId,\n\t\t);\n\t\tconst previous =\n\t\t\texistingIndex >= 0 ? ledger.tasks[existingIndex] : undefined;\n\t\tconst metadata = cleanMetadata({\n\t\t\t...(previous?.metadata ?? {}),\n\t\t\t...(input.metadata ?? {}),\n\t\t});\n\t\tconst workGraph =\n\t\t\textractA2AWorkGraphMetadata(input.task) ?? previous?.workGraph;\n\t\tconst userText = input.text.trim();\n\t\tconst taskResponse = extractA2ATaskResponse(input.task);\n\t\tconst responseText = taskResponse?.text ?? previous?.responseText;\n\t\tconst entry: A2ATaskLedgerEntry = {\n\t\t\t...(previous ?? {}),\n\t\t\tid: previous?.id ?? `maestro-a2a-task-${randomUUID()}`,\n\t\t\tkind: previous?.kind ?? \"message\",\n\t\t\tpeer: input.peer,\n\t\t\t...((input.peerDisplayName ?? previous?.peerDisplayName)\n\t\t\t\t? {\n\t\t\t\t\t\tpeerDisplayName: input.peerDisplayName ?? previous?.peerDisplayName,\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\ttaskId,\n\t\t\t...(trimString(input.task.contextId ?? previous?.contextId)\n\t\t\t\t? { contextId: trimString(input.task.contextId ?? previous?.contextId) }\n\t\t\t\t: {}),\n\t\t\tmessageId: input.messageId,\n\t\t\ttext: previous?.text ?? userText,\n\t\t\t...(previous?.role ? { role: previous.role } : {}),\n\t\t\t...(previous?.cwd ? { cwd: previous.cwd } : {}),\n\t\t\tstate: input.task.status.state,\n\t\t\t...(responseText ? { responseText } : {}),\n\t\t\t...(metadata ? { metadata } : {}),\n\t\t\t...(workGraph ? { workGraph } : {}),\n\t\t\ttranscript: [\n\t\t\t\t...(previous?.transcript ?? []),\n\t\t\t\t{\n\t\t\t\t\tat: now,\n\t\t\t\t\trole: \"user\",\n\t\t\t\t\ttext: userText,\n\t\t\t\t\tmessageId: input.messageId,\n\t\t\t\t},\n\t\t\t],\n\t\t\tcreatedAt: previous?.createdAt ?? now,\n\t\t\tupdatedAt: now,\n\t\t\t...(previous?.completedAt ? { completedAt: previous.completedAt } : {}),\n\t\t};\n\t\tif (taskResponse && shouldAppendAgentTranscript(entry, taskResponse)) {\n\t\t\tentry.transcript = [\n\t\t\t\t...entry.transcript,\n\t\t\t\t{\n\t\t\t\t\tat: now,\n\t\t\t\t\trole: \"agent\",\n\t\t\t\t\ttext: taskResponse.text,\n\t\t\t\t\tstate: input.task.status.state,\n\t\t\t\t\tmessageId: taskResponse.messageId,\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\t\tif (isFinalA2AState(input.task.status.state)) {\n\t\t\tentry.completedAt = previous?.completedAt ?? now;\n\t\t} else {\n\t\t\tdelete entry.completedAt;\n\t\t}\n\t\tif (existingIndex >= 0) {\n\t\t\tledger.tasks[existingIndex] = entry;\n\t\t} else {\n\t\t\tledger.tasks.push(entry);\n\t\t}\n\t\tconst path = await writeA2ATaskLedger(ledger, input);\n\t\treturn { entry, path };\n\t});\n}\n\nexport async function updateA2ATaskInLedger(\n\tinput: UpdateA2ATaskInput,\n): Promise<{ entry: A2ATaskLedgerEntry | null; path: string }> {\n\treturn withA2ATaskLedgerLock(input, async () => {\n\t\tconst ledger = await loadA2ATaskLedger(input);\n\t\tconst taskId = trimString(input.task.id) ?? fail(\"A2A task id is required\");\n\t\tconst index = ledger.tasks.findIndex(\n\t\t\t(entry) => entry.peer === input.peer && entry.taskId === taskId,\n\t\t);\n\t\tconst path = getA2ATaskLedgerPath(input.path);\n\t\tif (index < 0) {\n\t\t\treturn { entry: null, path };\n\t\t}\n\t\tconst now = (input.now ?? new Date()).toISOString();\n\t\tconst previous = ledger.tasks[index]!;\n\t\tconst taskResponse = extractA2ATaskResponse(input.task);\n\t\tconst responseText = taskResponse?.text ?? previous.responseText;\n\t\tconst workGraph =\n\t\t\textractA2AWorkGraphMetadata(input.task) ?? previous.workGraph;\n\t\tconst entry: A2ATaskLedgerEntry = {\n\t\t\t...previous,\n\t\t\tstate: input.task.status.state,\n\t\t\t...(trimString(input.task.contextId)\n\t\t\t\t? { contextId: trimString(input.task.contextId) }\n\t\t\t\t: {}),\n\t\t\t...(responseText ? { responseText } : {}),\n\t\t\t...(workGraph ? { workGraph } : {}),\n\t\t\tupdatedAt: now,\n\t\t\t...(isFinalA2AState(input.task.status.state)\n\t\t\t\t? { completedAt: previous.completedAt ?? now }\n\t\t\t\t: {}),\n\t\t};\n\t\tif (!isFinalA2AState(input.task.status.state)) {\n\t\t\tdelete entry.completedAt;\n\t\t}\n\t\tif (taskResponse && shouldAppendAgentTranscript(entry, taskResponse)) {\n\t\t\tentry.transcript = [\n\t\t\t\t...entry.transcript,\n\t\t\t\t{\n\t\t\t\t\tat: now,\n\t\t\t\t\trole: \"agent\",\n\t\t\t\t\ttext: taskResponse.text,\n\t\t\t\t\tstate: input.task.status.state,\n\t\t\t\t\tmessageId: taskResponse.messageId,\n\t\t\t\t},\n\t\t\t];\n\t\t}\n\t\tledger.tasks[index] = entry;\n\t\tawait writeA2ATaskLedger(ledger, input);\n\t\treturn { entry, path };\n\t});\n}\n\nexport function listA2ATaskEntries(\n\tledger: A2ATaskLedgerFile,\n\toptions: { peer?: string } = {},\n): A2ATaskLedgerEntry[] {\n\tconst peer = trimString(options.peer);\n\treturn ledger.tasks\n\t\t.filter((entry) => !peer || entry.peer === peer)\n\t\t.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));\n}\n\nexport function latestA2ATaskForPeer(\n\tledger: A2ATaskLedgerFile,\n\tpeer: string,\n): A2ATaskLedgerEntry | undefined {\n\treturn listA2ATaskEntries(ledger, { peer })[0];\n}\n\nexport function extractA2ATaskText(task: A2ATask): string | undefined {\n\treturn extractA2ATaskResponse(task)?.text;\n}\n\nfunction extractA2ATaskResponse(\n\ttask: A2ATask,\n): A2ATaskResponseText | undefined {\n\tconst statusText = firstMessageText(task.status.message);\n\tif (statusText) {\n\t\treturn {\n\t\t\ttext: statusText,\n\t\t\tmessageId: task.status.message?.messageId,\n\t\t};\n\t}\n\tconst artifactText = task.artifacts\n\t\t?.flatMap((artifact) => artifact.parts)\n\t\t.map((part) => trimString(part.text))\n\t\t.find((text): text is string => Boolean(text));\n\tif (artifactText) {\n\t\treturn { text: artifactText };\n\t}\n\tconst latestAgentMessage = latestAgentMessageInHistory(task.history);\n\tconst historyText = firstMessageText(latestAgentMessage);\n\tif (historyText) {\n\t\treturn {\n\t\t\ttext: historyText,\n\t\t\tmessageId: latestAgentMessage?.messageId,\n\t\t};\n\t}\n\treturn undefined;\n}\n\nfunction shouldAppendAgentTranscript(\n\tentry: A2ATaskLedgerEntry,\n\tresponse: A2ATaskResponseText,\n): boolean {\n\tif (response.messageId) {\n\t\treturn !entry.transcript.some(\n\t\t\t(item) => item.role === \"agent\" && item.messageId === response.messageId,\n\t\t);\n\t}\n\tconst last = entry.transcript.at(-1);\n\treturn !last || last.role !== \"agent\" || last.text !== response.text;\n}\n\nexport function isTerminalA2AState(state: string): boolean {\n\treturn isFinalA2AState(state) || isActionRequiredA2AState(state);\n}\n\nexport function isFinalA2AState(state: string): boolean {\n\treturn FINAL_STATE_PATTERN.test(state.toUpperCase().replace(/[\\s-]+/gu, \"_\"));\n}\n\nexport function isActionRequiredA2AState(state: string): boolean {\n\treturn ACTION_REQUIRED_STATE_PATTERN.test(\n\t\tstate.toUpperCase().replace(/[\\s-]+/gu, \"_\"),\n\t);\n}\n\nfunction firstMessageText(message: A2AMessage | undefined): string | undefined {\n\treturn message?.parts.map((part) => trimString(part.text)).find(Boolean);\n}\n\nfunction isAgentMessage(message: A2AMessage): boolean {\n\tconst role = message.role.toUpperCase();\n\treturn role === \"ROLE_AGENT\" || role === \"AGENT\";\n}\n\nfunction latestAgentMessageInHistory(\n\thistory: A2AMessage[] | undefined,\n): A2AMessage | undefined {\n\tif (!history) {\n\t\treturn undefined;\n\t}\n\tfor (const message of [...history].reverse()) {\n\t\tif (!isAgentMessage(message)) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (firstMessageText(message)) {\n\t\t\treturn message;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction normalizeLedgerEntry(\n\tinput: unknown,\n\tpath: string,\n): A2ATaskLedgerEntry {\n\tif (!isRecord(input)) {\n\t\tthrow new Error(`A2A task ledger ${path} must be a JSON object`);\n\t}\n\tconst id = requiredString(input.id, `${path}.id`);\n\tconst peer = requiredString(input.peer, `${path}.peer`);\n\tconst taskId = requiredString(input.taskId, `${path}.taskId`);\n\tconst text = requiredString(input.text, `${path}.text`);\n\tconst state = requiredString(input.state, `${path}.state`);\n\tconst createdAt = requiredString(input.createdAt, `${path}.createdAt`);\n\tconst updatedAt = requiredString(input.updatedAt, `${path}.updatedAt`);\n\tconst transcript = Array.isArray(input.transcript)\n\t\t? input.transcript.map((item, index) =>\n\t\t\t\tnormalizeTranscriptEntry(item, `${path}.transcript[${index}]`),\n\t\t\t)\n\t\t: [];\n\tconst entry: A2ATaskLedgerEntry = {\n\t\tid,\n\t\tkind: input.kind === \"message\" ? \"message\" : \"delegation\",\n\t\tpeer,\n\t\ttaskId,\n\t\ttext,\n\t\tstate,\n\t\ttranscript,\n\t\tcreatedAt,\n\t\tupdatedAt,\n\t};\n\tfor (const key of [\n\t\t\"peerDisplayName\",\n\t\t\"contextId\",\n\t\t\"messageId\",\n\t\t\"role\",\n\t\t\"cwd\",\n\t\t\"responseText\",\n\t\t\"completedAt\",\n\t] as const) {\n\t\tconst value = stringValue(input[key]);\n\t\tif (value) {\n\t\t\tentry[key] = value;\n\t\t}\n\t}\n\tif (isRecord(input.metadata)) {\n\t\tentry.metadata = cleanMetadata(input.metadata);\n\t}\n\tconst workGraph = normalizeA2AWorkGraphMetadata(input.workGraph);\n\tif (workGraph) {\n\t\tentry.workGraph = workGraph;\n\t}\n\treturn entry;\n}\n\nfunction normalizeTranscriptEntry(\n\tinput: unknown,\n\tpath: string,\n): A2ATaskTranscriptEntry {\n\tif (!isRecord(input)) {\n\t\tthrow new Error(`A2A task ledger ${path} must be a JSON object`);\n\t}\n\tconst role = input.role === \"agent\" ? \"agent\" : \"user\";\n\tconst entry: A2ATaskTranscriptEntry = {\n\t\tat: requiredString(input.at, `${path}.at`),\n\t\trole,\n\t\ttext: requiredString(input.text, `${path}.text`),\n\t};\n\tfor (const key of [\"state\", \"messageId\"] as const) {\n\t\tconst value = stringValue(input[key]);\n\t\tif (value) {\n\t\t\tentry[key] = value;\n\t\t}\n\t}\n\treturn entry;\n}\n\nfunction cleanMetadata(\n\tinput: Record<string, unknown> | undefined,\n): Record<string, string | number | boolean> | undefined {\n\tif (!input) {\n\t\treturn undefined;\n\t}\n\tconst entries = Object.entries(input).filter(\n\t\t(entry): entry is [string, string | number | boolean] =>\n\t\t\ttypeof entry[1] === \"string\" ||\n\t\t\ttypeof entry[1] === \"number\" ||\n\t\t\ttypeof entry[1] === \"boolean\",\n\t);\n\treturn entries.length > 0 ? Object.fromEntries(entries) : undefined;\n}\n\nfunction stringValue(input: unknown): string | undefined {\n\treturn typeof input === \"string\" ? trimString(input) : undefined;\n}\n\nfunction requiredString(input: unknown, path: string): string {\n\tconst value = stringValue(input);\n\tif (!value) {\n\t\tthrow new Error(`A2A task ledger ${path} is required`);\n\t}\n\treturn value;\n}\n\nfunction expandHome(path: string): string {\n\treturn path === \"~\" || path.startsWith(\"~/\")\n\t\t? join(homedir(), path.slice(2))\n\t\t: path;\n}\n\nfunction hasNodeCode(error: unknown, code: string): boolean {\n\treturn isRecord(error) && error.code === code;\n}\n\nfunction sleep(ms: number): Promise<void> {\n\treturn new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction fail(message: string): never {\n\tthrow new Error(message);\n}\n"]}