taskmeld 0.1.2 → 0.1.41

package/dist/src/services/gateway-read-helpers.js

@@ -4,7 +4,7 @@ exports.ensureGatewayReadyForReadonly = void 0;
 const ensureGatewayReadyForReadonly = async (app) => {
     if (app.gateway.client.getStatus().status === "ready")
         return;
-    // 只读命令一旦命中网关方法，也必须先建好链路，否则 sendReq 会直接失败。
+    // When a read-only command hits a gateway method, the link must be established first, otherwise sendReq would fail immediately.
     await app.gateway.client.connect();
 };
 exports.ensureGatewayReadyForReadonly = ensureGatewayReadyForReadonly;

package/dist/src/services/pipeline-service.js

@@ -21,7 +21,7 @@ const extractKeywordPoolFromUnknown = (value, depth = 0) => {
     if (!value || typeof value !== "object" || Array.isArray(value))
         return [];
     const record = value;
-    // 远端关键词池优先按约定字段提取，兼容现有 list30/list/items 等结构。
+    // Remote keyword pool: prefer extracting from agreed fields first, compatible with existing list30/list/items etc. structures.
     const priorityKeys = ["list30", "list", "keywords", "items", "pool"];
     for (const key of priorityKeys) {
         const candidates = (0, exports.extractKeywordPoolFromUnknown)(record[key], depth + 1);
@@ -84,34 +84,34 @@ const buildBatchRunId = (pipelineId, snapshot) => {
 };
 const markRunningRunStopped = (run) => {
     const now = new Date().toISOString();
-    // 停止是用户主动中止，不应继续让 queued/blocked 节点保持可调度状态。
+    // Stop is a user-initiated abort; queued/blocked nodes should not remain schedulable.
     for (const node of run.nodes) {
         if (node.status === "success" || node.status === "failed" || node.status === "rejected" || node.status === "skipped")
             continue;
         node.status = "stopped";
         node.finishedAt = node.finishedAt ?? now;
-        node.lastError = node.lastError ?? "用户手动停止流水线";
+        node.lastError = node.lastError ?? "Pipeline manually stopped by user";
     }
     for (const item of run.itemRuns ?? []) {
         if (item.status === "success" || item.status === "failed" || item.status === "rejected" || item.status === "skipped")
             continue;
         item.status = "stopped";
         item.finishedAt = item.finishedAt ?? now;
-        item.lastError = item.lastError ?? "用户手动停止流水线";
+        item.lastError = item.lastError ?? "Pipeline manually stopped by user";
     }
     for (const group of run.groups ?? []) {
         if (group.status === "success" || group.status === "failed" || group.status === "rejected" || group.status === "skipped")
             continue;
         group.status = "stopped";
         group.finishedAt = group.finishedAt ?? now;
-        group.lastError = group.lastError ?? "用户手动停止流水线";
+        group.lastError = group.lastError ?? "Pipeline manually stopped by user";
     }
     for (const groupItem of run.groupItemRuns ?? []) {
         if (groupItem.status === "success" || groupItem.status === "failed" || groupItem.status === "rejected" || groupItem.status === "skipped")
             continue;
         groupItem.status = "stopped";
         groupItem.finishedAt = groupItem.finishedAt ?? now;
-        groupItem.lastError = groupItem.lastError ?? "用户手动停止流水线";
+        groupItem.lastError = groupItem.lastError ?? "Pipeline manually stopped by user";
     }
     run.status = "stopped";
     run.updatedAt = now;
@@ -174,7 +174,7 @@ const createPipelineService = (app) => {
         const runtime = app.getPipelineRuntime(pipelineId);
         if (!definition || !runtime)
             return null;
-        // 只读 service 直接透出运行态快照，不承担任何写入行为。
+        // Read-only service directly passes through the runtime snapshot; it carries no write behavior.
         return {
             pipelineId: definition.id,
             title: definition.title,
@@ -218,7 +218,7 @@ const createPipelineService = (app) => {
                     remotePayload = JSON.parse(text);
                 }
                 catch {
-                    // 非 JSON 返回也允许继续尝试解析，兼容逗号/换行文本池。
+                    // Non-JSON responses are also allowed to continue parsing, compatible with comma/newline text pools.
                     remotePayload = text;
                 }
             }
@@ -245,7 +245,7 @@ const createPipelineService = (app) => {
                 const normalizedError = started.error === "batch_run_in_progress" ? "batch_run_in_progress" : "batch_items_empty";
                 return { ok: false, pipelineId, error: normalizedError, state: started.snapshot, remoteUrl };
             }
-            runtime.runtime.pushTimeline(`[${pipelineId}] 远程关键词池批跑已启动: ${items.length} 个关键词, 每批 ${started.snapshot.batchSize} 个`, "info", { remoteUrl });
+            runtime.runtime.pushTimeline(`[${pipelineId}] Remote keyword pool batch started: ${items.length} items, batch size ${started.snapshot.batchSize}`, "info", { remoteUrl });
             return {
                 ok: true,
                 mode: "remote_batch",
@@ -263,9 +263,9 @@ const createPipelineService = (app) => {
         }
         const run = runtime.runtime.seedRun(runtime.workflow.getTemplateNodes());
         runtime.runtime.setRun(run);
-        runtime.runtime.pushTimeline(`[${pipelineId}] 已启动新运行: ${run.id}`);
+        runtime.runtime.pushTimeline(`[${pipelineId}] New run started: ${run.id}`);
         runtime.runtime.emitPipeline();
-        // start 只负责发起运行，不承诺在返回时已执行完成。
+        // start is only responsible for initiating the run; it does not promise completion upon return.
         void runtime.pipeline.drainPipeline(`run:start:${run.id}`).then(() => {
             runtime.runtime.touchRun(runtime.runtime.getRun());
         });
@@ -290,7 +290,7 @@ const createPipelineService = (app) => {
                 error: "run_not_found",
             };
         }
-        // status 命令只表达“当前是否仍在运行”，非运行态改为返回精简联合结构。
+        // The status command only expresses "whether it's currently running"; non-running states return a simplified union structure.
         return attachIdentityToPipelineStatusResult((0, pipeline_status_1.buildPipelineStatusResult)({
             pipelineId,
             run: detail.run,
@@ -326,7 +326,7 @@ const createPipelineService = (app) => {
                     runtime.pipeline.abortRunControllers(runState.id);
                 }
                 markRunningRunStopped(runState);
-                runtime.runtime.pushTimeline(`[${pipelineId}] 已请求停止单次运行: ${runState.id}`, "warn");
+                runtime.runtime.pushTimeline(`[${pipelineId}] Stop requested for run: ${runState.id}`, "warn");
                 runtime.runtime.emitPipeline();
                 const stoppedStatus = (0, execution_status_1.buildPipelineExecutionStatus)({
                     pipelineId,
@@ -356,7 +356,7 @@ const createPipelineService = (app) => {
                 error: "batch_run_not_running",
             };
         }
-        // 中止当前正在执行的节点，同时向远端 agent 发送 /stop 命令
+        // Abort the currently executing node, and also send /stop to the remote agent
         if (runState.id) {
             runtime.pipeline.abortRunControllers(runState.id);
         }
@@ -385,7 +385,7 @@ const createPipelineService = (app) => {
         };
     };
     const runPipeline = async (pipelineId) => {
-        // run 仅作为兼容入口，语义等价到 start。
+        // run exists only as a compatibility entry point; semantically equivalent to start.
         return startPipeline(pipelineId);
     };
     const startBatchRun = (input) => {
@@ -432,7 +432,7 @@ const createPipelineService = (app) => {
                 remotePayload = JSON.parse(text);
             }
             catch {
-                // 非 JSON 文本也允许继续解析，避免上游切到纯文本池时整条批跑入口不可用。
+                // Non-JSON text is also allowed to continue parsing, to prevent the entire batch-run entry from becoming unusable when upstream switches to a plain-text pool.
                 remotePayload = text;
             }
         }
@@ -445,7 +445,7 @@ const createPipelineService = (app) => {
                 detail: error instanceof Error ? error.message : "unknown_error",
             };
         }
-        // sourceField 视为“优先路径”而非严格依赖：路径缺失时退回全量解析以保持兼容。
+        // sourceField is treated as a "preferred path" not a strict dependency: fall back to full parsing when path is missing to maintain compatibility.
         const preferredPayload = remoteBatchPlugin.sourceField
             ? (0, exports.readNestedValueByPath)(remotePayload, remoteBatchPlugin.sourceField)
             : null;
@@ -465,7 +465,7 @@ const createPipelineService = (app) => {
                 remoteUrl,
             };
         }
-        runtime.runtime.pushTimeline(`[${input.pipelineId}] 远程关键词池批跑已启动: ${items.length} 个关键词, 每批 ${started.snapshot.batchSize} 个`, "info", { remoteUrl });
+        runtime.runtime.pushTimeline(`[${input.pipelineId}] Remote keyword pool batch started: ${items.length} items, batch size ${started.snapshot.batchSize}`, "info", { remoteUrl });
         return {
             ok: true,
             pipelineId: input.pipelineId,
@@ -478,7 +478,7 @@ const createPipelineService = (app) => {
         const runtime = getRuntimeByPipelineId(app, input.pipelineId);
         if (!runtime)
             return { ok: false, pipelineId: input.pipelineId, error: "pipeline_not_found" };
-        // 中止当前正在执行的节点，避免旧节点与新重试冲突（同时向远端 agent 发送 /stop 命令）
+        // Abort the currently executing node to avoid old node conflicting with new retry (also send /stop to remote agent)
         const runState = runtime.runtime.getRun();
         if (runState.id) {
             runtime.pipeline.abortRunControllers(runState.id);

package/dist/src/services/pipeline-status.js

@@ -45,7 +45,7 @@ const isBatchTerminal = (batchRun) => {
 };
 const readPipelineLastCompletedAt = (run, batchRun) => {
     const candidates = [];
-    // 只有确认 run 已进入终态后，才允许把 updatedAt 视作完成时间候选。
+    // Only allow updatedAt as a completion time candidate after confirming the run has reached a terminal state.
     if (isRunTerminal(run) && isNonEmptyString(run.updatedAt)) {
         candidates.push(run.updatedAt.trim());
     }
@@ -53,7 +53,7 @@ const readPipelineLastCompletedAt = (run, batchRun) => {
     candidates.push(...collectFinishedAtValues(run.itemRuns));
     candidates.push(...collectFinishedAtValues(run.groups));
     candidates.push(...collectFinishedAtValues(run.groupItemRuns));
-    // 批跑完成时间应来自控制器真实终态，而不是运行中的快照更新时间。
+    // Batch-run completion time should come from the controller's real terminal state, not the running snapshot's update time.
     if (isBatchTerminal(batchRun) && isNonEmptyString(batchRun.finishedAt)) {
         candidates.push(batchRun.finishedAt.trim());
     }
@@ -63,13 +63,13 @@ exports.readPipelineLastCompletedAt = readPipelineLastCompletedAt;
 const buildPipelineStatusResult = (input) => {
     const status = (0, execution_status_1.buildPipelineExecutionStatus)({
         pipelineId: input.pipelineId,
-        // 这里直接复用 execution-status 作为运行态快照构造器，保证 status 字段来源仍然唯一。
+        // Reuse execution-status directly as the runtime snapshot constructor, keeping the status field source unique.
         run: input.run,
         scheduler: input.scheduler,
         batchRun: input.batchRun,
     });
     if (status.running) {
-        // status.running=true 时，mode 只能是 single 或 remote_batch；这里显式收窄给 CLI/API 统一消费。
+        // When status.running=true, mode can only be single or remote_batch; explicitly narrow here for unified CLI/API consumption.
         return {
             ok: true,
             status: {

package/dist/src/services/read-services.js

@@ -18,7 +18,7 @@ const createAllServices = (app) => ({
 const createReadonlyServices = (app) => {
     const services = createAllServices(app);
     return {
-        // 统一工厂用于主线集成，CLI 入口只需传入 registry 即可拿到全部只读 service。
+        // Unified factory for mainline integration; the CLI entry only needs to pass in the registry to get all read-only services.
         system: services.system,
         pipeline: services.pipeline,
         agent: services.agent,

package/dist/src/services/session-service.js

@@ -42,7 +42,7 @@ const createSessionService = (app) => {
                 return toSessionListItems(refreshed.items);
             }
             catch {
-                // 刷新失败时使用缓存，确保 CLI 在网关抖动时仍可读到会话信息。
+                // On refresh failure, use cache so the CLI can still read session info during gateway flapping.
             }
         }
         return toSessionListItems(app.gateway.getSessionCache());
@@ -144,7 +144,7 @@ const createSessionService = (app) => {
                     return;
                 const stream = String(payload.stream ?? "").toLowerCase();
                 const data = (payload.data ?? {});
-                // 流式文本片段（累积+增量混合，用 merge 去重）
+                // Streaming text fragments (mix of accumulation and incremental; deduplicated with merge)
                 if (stream === "assistant") {
                     const text = typeof data.text === "string" ? data.text : "";
                     if (text) {
@@ -161,7 +161,7 @@ const createSessionService = (app) => {
                     }
                     return;
                 }
-                // 兼容非 stream 前缀的直接文本
+                // Compatible with non-stream-prefix direct text
                 const role = String(payload.role ?? data.role ?? "").toLowerCase();
                 if (role === "assistant") {
                     const text = typeof data.text === "string" ? data.text : "";
@@ -178,7 +178,7 @@ const createSessionService = (app) => {
                         emitIncremental(accumulated);
                     }
                 }
-                // 生命周期结束
+                // Lifecycle end
                 if (stream === "lifecycle") {
                     const phase = String(data.phase ?? "").toLowerCase();
                     if (phase === "end" || phase === "done") {
@@ -192,12 +192,12 @@ const createSessionService = (app) => {
                     }
                 }
             });
-            // 超时兜底
+            // Timeout safety net
             timer = setTimeout(() => {
                 if (settled)
                     return;
                 cleanup();
-                // 超时时尝试从 history 补一次
+                // On timeout, try to backfill from history once
                 void getSessionHistory(sessionId).then((history) => {
                     const items = Array.isArray(history) ? history : [];
                     const lastAssistant = [...items].reverse().find((item) => {

package/dist/src/services/system-service.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSystemService = void 0;
 const createSystemService = (app) => {
     const getSnapshot = () => {
-        // 复用 registry 的 bootstrap 聚合结果，保证 CLI 与现有前端看到的是同一份系统快照。
+        // Reuse the registry's aggregated bootstrap result so the CLI sees the same system snapshot as existing frontends.
         const bootstrap = app.getBootstrapPayload();
         return {
             generatedAt: new Date().toISOString(),

package/dist/src/transport/ws-broker.js

@@ -17,7 +17,6 @@ const createWsBroker = (options) => {
         for (const peer of peers) {
             if (peer.readyState !== 1)
                 continue;
-            // 慢消费者保护：高频消息在 buffer 堆积时跳过，避免 Node 进程 OOM
             if (isHighFrequency && peer.bufferedAmount > 64 * 1024)
                 continue;
             peer.send(message);
@@ -25,6 +24,18 @@ const createWsBroker = (options) => {
     };
     wsServer.on("connection", (socket) => {
         peers.add(socket);
+        if (options.handleRequest) {
+            socket.on("message", (raw) => {
+                try {
+                    options.handleRequest(socket, raw.toString());
+                }
+                catch (error) {
+                    // JSON-parsing failures from ws-handler are handled internally;
+                    // unexpected handler bugs surface here so they don't vanish silently.
+                    console.error("ws-message-handler-error", error);
+                }
+            });
+        }
         socket.send(JSON.stringify({ type: "bootstrap", payload: options.getBootstrapPayload() }));
         socket.on("close", () => {
             peers.delete(socket);

package/dist/src/transport/ws-handler.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWsRequestHandler = exports.createWsMethodRegistry = void 0;
+const createWsMethodRegistry = () => {
+    const methods = new Map();
+    return {
+        register(method, handler) {
+            if (methods.has(method)) {
+                throw new Error(`duplicate_ws_method:${method}`);
+            }
+            methods.set(method, handler);
+        },
+        dispatch(method) {
+            return methods.get(method) ?? null;
+        },
+    };
+};
+exports.createWsMethodRegistry = createWsMethodRegistry;
+const createWsRequestHandler = (app, services) => {
+    const registry = (0, exports.createWsMethodRegistry)();
+    const handleMessage = (socket, raw) => {
+        let frame;
+        try {
+            frame = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (frame.type !== "req" || typeof frame.id !== "string" || typeof frame.method !== "string") {
+            return;
+        }
+        const handler = registry.dispatch(frame.method);
+        const sendRes = (ok, payload, error) => {
+            socket.send(JSON.stringify({ type: "res", id: frame.id, ok, payload, error }));
+        };
+        if (!handler) {
+            sendRes(false, undefined, `unknown_method:${frame.method}`);
+            return;
+        }
+        const ctx = {
+            app,
+            params: Object.fromEntries(Object.entries(frame.params ?? {}).filter(([_, v]) => typeof v === "string")),
+            services,
+        };
+        try {
+            const result = handler(frame.params ?? {}, ctx);
+            if (result instanceof Promise) {
+                result.then((r) => sendRes(r.ok, r.payload, r.error), (err) => sendRes(false, undefined, err instanceof Error ? err.message : "internal_error"));
+            }
+            else {
+                sendRes(result.ok, result.payload, result.error);
+            }
+        }
+        catch (err) {
+            sendRes(false, undefined, err instanceof Error ? err.message : "internal_error");
+        }
+    };
+    return { registry, handleMessage };
+};
+exports.createWsRequestHandler = createWsRequestHandler;

package/dist/src/transport/ws-methods/agents.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentWsMethods = void 0;
+const utils_1 = require("./utils");
+const toEpochMs = (value) => {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string" && value.trim()) {
+        const asNum = Number(value);
+        if (Number.isFinite(asNum))
+            return asNum;
+        const asDate = Date.parse(value);
+        if (Number.isFinite(asDate))
+            return asDate;
+    }
+    return null;
+};
+const readSessionActivityMs = (raw) => {
+    const candidates = [raw.updatedAt, raw.endedAt, raw.startedAt, raw.timestamp, raw.ts];
+    let best = null;
+    for (const candidate of candidates) {
+        const ms = toEpochMs(candidate);
+        if (ms === null)
+            continue;
+        if (best === null || ms > best)
+            best = ms;
+    }
+    return best;
+};
+const inferAgentIdsFromSession = (session) => {
+    const out = new Set();
+    const id = session.id.trim();
+    if (id) {
+        const match = id.match(/^agent:([^:]+):/i);
+        if (match?.[1])
+            out.add(match[1]);
+    }
+    const directKeys = [session.raw.agentId, session.raw.agent_id, session.raw.executorAgentId, session.raw.ownerAgentId];
+    for (const value of directKeys) {
+        if (typeof value === "string" && value.trim())
+            out.add(value.trim());
+    }
+    return [...out];
+};
+const registerAgentWsMethods = (registry) => {
+    registry.register("agent.list", async (_params, ctx) => {
+        try {
+            const payload = await ctx.services.client.sendReq("agents.list");
+            const rawItems = ctx.services.pickArray(payload);
+            let sessionItems = ctx.services.getSessionCache();
+            try {
+                const refreshed = await ctx.services.refreshSessionsFromGateway();
+                sessionItems = refreshed.items;
+            }
+            catch { /* silent */ }
+            const lastActiveByAgentId = new Map();
+            for (const session of sessionItems) {
+                const activityMs = readSessionActivityMs(session.raw);
+                if (activityMs === null)
+                    continue;
+                for (const agentId of inferAgentIdsFromSession(session)) {
+                    const prev = lastActiveByAgentId.get(agentId);
+                    if (prev === undefined || activityMs > prev) {
+                        lastActiveByAgentId.set(agentId, activityMs);
+                    }
+                }
+            }
+            const items = rawItems
+                .map((item) => {
+                const obj = (0, utils_1.asRecord)(item);
+                if (!obj)
+                    return item;
+                const agentId = String(obj.id ?? obj.name ?? obj.key ?? "").trim();
+                const activeMs = agentId ? (lastActiveByAgentId.get(agentId) ?? null) : null;
+                return { ...obj, lastActiveAtMs: activeMs, lastActiveAt: activeMs ? new Date(activeMs).toISOString() : null };
+            })
+                .sort((a, b) => {
+                const aObj = (0, utils_1.asRecord)(a);
+                const bObj = (0, utils_1.asRecord)(b);
+                const aMs = toEpochMs(aObj?.lastActiveAtMs ?? aObj?.lastActiveAt) ?? -1;
+                const bMs = toEpochMs(bObj?.lastActiveAtMs ?? bObj?.lastActiveAt) ?? -1;
+                if (aMs !== bMs)
+                    return bMs - aMs;
+                const aId = String(aObj?.id ?? aObj?.name ?? "");
+                const bId = String(bObj?.id ?? bObj?.name ?? "");
+                return aId.localeCompare(bId);
+            });
+            return { ok: true, payload: { items, raw: payload } };
+        }
+        catch (error) {
+            return { ok: false, error: (0, utils_1.formatError)(error) };
+        }
+    });
+    registry.register("agent.files.list", async (params, ctx) => {
+        try {
+            const agentId = typeof params.agentId === "string" ? params.agentId.trim() : "";
+            if (!agentId)
+                return { ok: false, error: "invalid_agent_id" };
+            const payload = await ctx.services.client.sendReq("agents.files.list", { agentId });
+            const obj = (payload ?? {});
+            const files = Array.isArray(obj.files) ? obj.files : ctx.services.pickArray(payload);
+            return { ok: true, payload: { items: files, raw: payload } };
+        }
+        catch (error) {
+            return { ok: false, error: (0, utils_1.formatError)(error) };
+        }
+    });
+    registry.register("agent.files.get", async (params, ctx) => {
+        try {
+            const agentId = typeof params.agentId === "string" ? params.agentId.trim() : "";
+            const name = typeof params.name === "string" ? params.name.trim() : "";
+            if (!agentId)
+                return { ok: false, error: "invalid_agent_id" };
+            if (!name)
+                return { ok: false, error: "invalid_file_name" };
+            const payload = await ctx.services.client.sendReq("agents.files.get", { agentId, name });
+            const obj = (payload ?? {});
+            const file = (obj.file ?? payload);
+            return { ok: true, payload: { item: file ?? null, raw: payload } };
+        }
+        catch (error) {
+            return { ok: false, error: (0, utils_1.formatError)(error) };
+        }
+    });
+    registry.register("agent.files.set", async (params, ctx) => {
+        try {
+            const agentId = typeof params.agentId === "string" ? params.agentId.trim() : "";
+            const name = typeof params.name === "string" ? params.name.trim() : "";
+            const content = typeof params.content === "string" ? params.content : "";
+            if (!agentId)
+                return { ok: false, error: "invalid_agent_id" };
+            if (!name)
+                return { ok: false, error: "invalid_file_name" };
+            const payload = await ctx.services.client.sendReq("agents.files.set", { agentId, name, content }, { sideEffect: true });
+            const obj = (payload ?? {});
+            const file = (obj.file ?? payload);
+            return { ok: true, payload: { item: file ?? null, raw: payload } };
+        }
+        catch (error) {
+            return { ok: false, error: (0, utils_1.formatError)(error) };
+        }
+    });
+};
+exports.registerAgentWsMethods = registerAgentWsMethods;