@perkos/perkos-a2a 0.8.35 → 0.9.1

package/dist/runtime-reply.js

@@ -0,0 +1,137 @@
+import { randomUUID } from "crypto";
+function stripTaskMarker(text, marker) {
+    const trimmed = text.trim();
+    if (!trimmed.includes(marker))
+        return trimmed;
+    return trimmed.slice(trimmed.indexOf(marker) + marker.length).trim();
+}
+function requestedFinalMarker(text) {
+    const patterns = [
+        /termina(?:r)?\s+exactamente\s+con\s+([A-Z0-9_\-]+)/i,
+        /end\s+(?:exactly\s+)?with\s+([A-Z0-9_\-]+)/i,
+    ];
+    for (const pattern of patterns) {
+        const match = text.match(pattern);
+        if (match?.[1])
+            return match[1];
+    }
+    return undefined;
+}
+function withRequestedMarker(reply, text) {
+    const marker = requestedFinalMarker(text);
+    if (!marker || reply.trim().endsWith(marker))
+        return reply;
+    return `${reply.trim()} ${marker}`;
+}
+function runtimeOption(config, key) {
+    const value = config.runtime?.[key];
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function agentIdFor(config) {
+    return runtimeOption(config, "agentId") || config.agentName || "perkos-a2a-agent";
+}
+function llmSystemPrompt(config) {
+    const agentName = config.agentName || config.runtime?.kind || "PerkOS A2A agent";
+    return [
+        `You are ${agentName}, a PerkOS A2A agent.`,
+        "Reply concisely and directly.",
+        "If asked to confirm receipt, confirm that you received the task via PerkOS A2A and are using PerkOS LLM.",
+        "Do not mention implementation details unless asked.",
+    ].join(" ");
+}
+/**
+ * Generate a final task reply through PerkOS LLM when the local runtime accepts
+ * a task but does not expose a synchronous final answer API.
+ *
+ * This keeps A2A task state machine semantics intact: delivery/wake still
+ * happens, while the A2A caller receives a terminal task with a useful artifact
+ * instead of being left in `working` indefinitely.
+ */
+export async function generateRuntimeReply(config, text, marker) {
+    const runtimeKind = config.runtime?.kind || "openclaw";
+    const apiKey = runtimeOption(config, "llmApiKey");
+    if (!apiKey) {
+        const agentName = config.agentName || config.runtime?.kind || "PerkOS A2A agent";
+        const lower = text.toLowerCase();
+        if (lower.includes("confirma") || lower.includes("confirm") || lower.includes("ping")) {
+            return withRequestedMarker(`${agentName} recibió este mensaje vía PerkOS A2A.`, text);
+        }
+        return withRequestedMarker([
+            `${agentName} recibió la tarea vía PerkOS A2A.`,
+            "El runtime/LLM local no está configurado para generar una respuesta completa en este momento, pero el transporte A2A y el estado terminal funcionan.",
+        ].join(" "), text);
+    }
+    const headers = {
+        "content-type": "application/json",
+        authorization: `Bearer ${apiKey}`,
+        "x-agent-id": agentIdFor(config),
+    };
+    const system = llmSystemPrompt(config);
+    const user = [
+        text,
+        "",
+        "Return only the useful final answer.",
+        `Do not include ${marker}; the A2A bridge will attach the marker/task result.`,
+    ].join("\n");
+    if (runtimeKind === "hermes") {
+        const base = (runtimeOption(config, "openAiBaseUrl") || "https://api.llm.perkos.xyz/v1").replace(/\/+$/, "");
+        const model = runtimeOption(config, "model") || "kimi-k2.6:cloud";
+        const response = await fetch(`${base}/chat/completions`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                model,
+                messages: [
+                    { role: "system", content: system },
+                    { role: "user", content: user },
+                ],
+                temperature: 0.2,
+            }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`PerkOS LLM OpenAI-compatible call failed (${response.status}): ${body || response.statusText}`);
+        }
+        const data = await response.json();
+        return stripTaskMarker(data.choices?.[0]?.message?.content || "Task completed.", marker);
+    }
+    const base = (runtimeOption(config, "ollamaBaseUrl") || "https://api.llm.perkos.xyz").replace(/\/+$/, "");
+    const model = runtimeOption(config, "model") || "kimi-k2.6:cloud";
+    const response = await fetch(`${base}/api/chat`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+            model,
+            stream: false,
+            messages: [
+                { role: "system", content: system },
+                { role: "user", content: user },
+            ],
+        }),
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new Error(`PerkOS LLM Ollama-compatible call failed (${response.status}): ${body || response.statusText}`);
+    }
+    const data = await response.json();
+    return stripTaskMarker(data.message?.content || data.response || "Task completed.", marker);
+}
+export function completeTaskWithReply(task, finalText) {
+    task.artifacts.push({
+        kind: "artifact",
+        artifactId: randomUUID(),
+        parts: [{ kind: "text", text: finalText }],
+    });
+    task.status = {
+        state: "completed",
+        timestamp: new Date().toISOString(),
+        message: {
+            role: "agent",
+            parts: [{ kind: "text", text: finalText }],
+        },
+    };
+}
+export function isTerminalTaskState(state) {
+    return state === "completed" || state === "failed" || state === "canceled";
+}
+//# sourceMappingURL=runtime-reply.js.map

package/dist/runtime-reply.js.map

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