taskmeld 0.1.1

package/dist/src/server/routes/artifacts.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerArtifactsRoutes = void 0;
+const storage_service_js_1 = require("../../artifacts/storage-service.js");
+const artifact_index_js_1 = require("../../artifacts/artifact-index.js");
+const artifact_cleanup_js_1 = require("../../artifacts/artifact-cleanup.js");
+const storage_service_js_2 = require("../../artifacts/storage-service.js");
+const parseCsvParam = (value) => value
+    ? value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean)
+    : [];
+const registerArtifactsRoutes = (router) => {
+    router.register("GET", "/api/artifacts", async (ctx) => {
+        const services = ctx.services;
+        const pipelineIds = parseCsvParam(ctx.url.searchParams.get("pipelineId"));
+        const nodeIds = parseCsvParam(ctx.url.searchParams.get("nodeId"));
+        const statuses = parseCsvParam(ctx.url.searchParams.get("status"));
+        const kinds = parseCsvParam(ctx.url.searchParams.get("kind"));
+        const dateFrom = String(ctx.url.searchParams.get("dateFrom") ?? "").trim() || null;
+        const dateTo = String(ctx.url.searchParams.get("dateTo") ?? "").trim() || null;
+        const cursor = String(ctx.url.searchParams.get("cursor") ?? "").trim() || undefined;
+        const batchRunId = String(ctx.url.searchParams.get("batchRunId") ?? "").trim() || undefined;
+        const runId = String(ctx.url.searchParams.get("runId") ?? "").trim() || undefined;
+        const limitRaw = Number(ctx.url.searchParams.get("limit") ?? 100);
+        const result = await (0, storage_service_js_1.listStoredArtifacts)(services.listPipelines(), {
+            pipelineIds,
+            nodeIds,
+            dateFrom,
+            dateTo,
+            limit: Number.isFinite(limitRaw) ? limitRaw : 100,
+            cursor,
+            statuses: statuses.length ? statuses : undefined,
+            kinds: kinds.length ? kinds : undefined,
+            batchRunId,
+            runId,
+        });
+        ctx.sendJson(200, {
+            items: result.items,
+            nextCursor: result.nextCursor,
+            source: result.source,
+        });
+    });
+    router.register("GET", "/api/artifacts/content", async (ctx) => {
+        const services = ctx.services;
+        const pipelineId = String(ctx.url.searchParams.get("pipelineId") ?? "").trim();
+        const relativePath = String(ctx.url.searchParams.get("relativePath") ?? "").trim();
+        const artifactId = String(ctx.url.searchParams.get("artifactId") ?? "").trim();
+        if (!pipelineId || (!relativePath && !artifactId)) {
+            ctx.sendJson(400, { error: "invalid_artifact_query" });
+            return;
+        }
+        const definition = services.getPipelineDefinition(pipelineId);
+        if (!definition) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId });
+            return;
+        }
+        // artifactId 查询：从索引/扫描列表中查找对应 relativePath
+        let resolvedPath = relativePath || undefined;
+        if (!resolvedPath && artifactId) {
+            const listResult = await (0, storage_service_js_1.listStoredArtifacts)(services.listPipelines(), {
+                pipelineIds: [pipelineId],
+                limit: 5000,
+            });
+            const match = listResult.items.find((item) => item.artifactId === artifactId);
+            resolvedPath = match?.relativePath ?? undefined;
+        }
+        if (!resolvedPath) {
+            ctx.sendJson(404, { error: "artifact_not_found", pipelineId, artifactId: artifactId || null });
+            return;
+        }
+        const content = await (0, storage_service_js_1.readStoredArtifactContent)(definition, resolvedPath);
+        if (!content) {
+            ctx.sendJson(404, {
+                error: "artifact_not_found",
+                pipelineId,
+                relativePath: resolvedPath,
+            });
+            return;
+        }
+        ctx.sendJson(200, {
+            pipelineId,
+            relativePath: resolvedPath,
+            artifactId: artifactId || null,
+            content,
+        });
+    });
+    router.register("GET", "/api/artifacts/export", async (ctx) => {
+        const services = ctx.services;
+        const pipelineIds = parseCsvParam(ctx.url.searchParams.get("pipelineId"));
+        const nodeIds = parseCsvParam(ctx.url.searchParams.get("nodeId"));
+        const dateFrom = String(ctx.url.searchParams.get("dateFrom") ?? "").trim() || null;
+        const dateTo = String(ctx.url.searchParams.get("dateTo") ?? "").trim() || null;
+        const limitRaw = Number(ctx.url.searchParams.get("limit") ?? 20000);
+        const kinds = parseCsvParam(ctx.url.searchParams.get("kind"));
+        // 默认排除 envelope，避免同一业务内容在 envelope 和 artifact 文件中重复出现
+        const effectiveKinds = kinds.length > 0 ? kinds : ["artifact", "adapter", "group"];
+        const data = await (0, storage_service_js_1.exportStoredArtifactContents)(services.listPipelines(), {
+            pipelineIds,
+            nodeIds,
+            dateFrom,
+            dateTo,
+            limit: Number.isFinite(limitRaw) ? limitRaw : 20000,
+            kinds: effectiveKinds,
+        });
+        ctx.sendJson(200, { data });
+    });
+    router.register("POST", "/api/artifacts/cleanup", async (ctx) => {
+        const services = ctx.services;
+        const pipelineId = String(ctx.url.searchParams.get("pipelineId") ?? "").trim() || undefined;
+        const olderThanDays = parseInt(ctx.url.searchParams.get("olderThanDays") ?? "0", 10) || undefined;
+        const statusParam = ctx.url.searchParams.get("status") ?? "";
+        const statuses = statusParam ? statusParam.split(",").map((s) => s.trim()).filter(Boolean) : undefined;
+        const confirm = ctx.url.searchParams.get("confirm") === "true";
+        const definitions = pipelineId
+            ? [services.getPipelineDefinition(pipelineId)].filter(Boolean)
+            : services.listPipelines();
+        if (definitions.length === 0) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId });
+            return;
+        }
+        let totalFiles = 0;
+        let totalSizeBytes = 0;
+        let deleted = 0;
+        let failed = 0;
+        const allWarnings = [];
+        for (const definition of definitions) {
+            const plan = await (0, artifact_cleanup_js_1.planCleanup)(definition, { olderThanDays, statuses });
+            totalFiles += plan.files.length;
+            totalSizeBytes += plan.totalSizeBytes;
+            if (confirm) {
+                const execResult = await (0, artifact_cleanup_js_1.executeCleanup)(definition, plan);
+                deleted += execResult.deleted;
+                failed += execResult.failed;
+                allWarnings.push(...execResult.warnings);
+            }
+        }
+        ctx.sendJson(200, { totalFiles, totalSizeBytes, deleted, failed, dryRun: !confirm, warnings: allWarnings });
+    });
+    router.register("POST", "/api/artifacts/rebuild-index", async (ctx) => {
+        const services = ctx.services;
+        const pipelineId = String(ctx.url.searchParams.get("pipelineId") ?? "").trim() || undefined;
+        const definitions = pipelineId
+            ? [services.getPipelineDefinition(pipelineId)].filter(Boolean)
+            : services.listPipelines();
+        if (definitions.length === 0) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId });
+            return;
+        }
+        let indexed = 0;
+        let skipped = 0;
+        const warnings = [];
+        for (const definition of definitions) {
+            const result = await (0, artifact_index_js_1.rebuildArtifactIndex)(definition, (d) => (0, storage_service_js_2.scanStoredArtifacts)([d]));
+            indexed += result.indexed;
+            skipped += result.skipped;
+            warnings.push(...result.warnings);
+        }
+        ctx.sendJson(200, { indexed, skipped, warnings });
+    });
+};
+exports.registerArtifactsRoutes = registerArtifactsRoutes;

package/dist/src/server/routes/gateway.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGatewayRoutes = void 0;
+/**
+ * 注册 GET /api/gateway/status 路由。
+ * 返回网关连接状态、最新 hello 消息和最后帧数据。
+ */
+const registerGatewayRoutes = (router) => {
+    router.register("GET", "/api/gateway/status", (ctx) => {
+        const services = ctx.services;
+        ctx.sendJson(200, {
+            status: services.getLatestStatus() ?? services.client.getStatus(),
+            hello: services.getLatestHello(),
+            lastFrame: services.getLastFrame(),
+        });
+    });
+};
+exports.registerGatewayRoutes = registerGatewayRoutes;

package/dist/src/server/routes/health.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerHealthRoutes = void 0;
+/**
+ * 注册 GET /api/health 路由。
+ * 返回服务端存活状态及当前 owner 摘要，供 CLI 校验 runtime metadata 是否仍指向同一实例。
+ */
+const registerHealthRoutes = (router) => {
+    router.register("GET", "/api/health", (ctx) => {
+        ctx.sendJson(200, {
+            ok: true,
+            ...ctx.options.serverRuntimeIdentity,
+        });
+    });
+};
+exports.registerHealthRoutes = registerHealthRoutes;

package/dist/src/server/routes/logs.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogRoutes = void 0;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const registerLogRoutes = (router) => {
+    router.register("GET", "/api/logs/runs", async (ctx) => {
+        const services = ctx.services;
+        const items = await services.runLogService.listRuns();
+        ctx.sendJson(200, { items });
+    });
+    router.register("GET", "/api/logs/runs/:runId/timeline", async (ctx) => {
+        try {
+            const services = ctx.services;
+            const runId = ctx.params.runId;
+            if (!runId) {
+                ctx.sendJson(400, { error: "invalid_run_id" });
+                return;
+            }
+            const levelParam = String(ctx.url.searchParams.get("level") ?? "").trim();
+            const levels = levelParam
+                ? levelParam
+                    .split(",")
+                    .map((item) => item.trim())
+                    .filter((item) => item === "info" || item === "warn" || item === "error")
+                : undefined;
+            const offsetRaw = Number(ctx.url.searchParams.get("offset") ?? 0);
+            const limitParam = ctx.url.searchParams.get("limit");
+            const limitRaw = limitParam === null ? undefined : Number(limitParam);
+            const keyword = String(ctx.url.searchParams.get("keyword") ?? "").trim() || undefined;
+            const order = ctx.url.searchParams.get("order") === "asc" ? "asc" : "desc";
+            const page = await services.runLogService.queryTimeline({
+                runId,
+                offset: Number.isFinite(offsetRaw) ? offsetRaw : 0,
+                limit: typeof limitRaw === "number" && Number.isFinite(limitRaw)
+                    ? limitRaw
+                    : undefined,
+                keyword,
+                levels,
+                order,
+            });
+            ctx.sendJson(200, page);
+        }
+        catch (error) {
+            ctx.sendJson(404, { error: "run_log_not_found", detail: String(error) });
+        }
+    });
+    router.register("GET", "/api/logs/runs/:runId/timeline/raw", async (ctx) => {
+        try {
+            const services = ctx.services;
+            const runId = ctx.params.runId;
+            if (!runId) {
+                ctx.sendJson(400, { error: "invalid_run_id" });
+                return;
+            }
+            const logFile = await services.runLogService.readRawTimeline(runId);
+            const fileStat = await (0, promises_1.stat)(logFile);
+            const stream = (0, node_fs_1.createReadStream)(logFile);
+            ctx.sendRaw(200, {
+                "Content-Type": "application/x-ndjson; charset=utf-8",
+                "Content-Length": String(fileStat.size),
+                "Content-Disposition": `inline; filename="${runId}-timeline.log"`,
+            }, stream);
+        }
+        catch (error) {
+            ctx.sendJson(404, {
+                error: "run_log_not_found",
+                detail: String(error),
+            });
+        }
+    });
+};
+exports.registerLogRoutes = registerLogRoutes;

package/dist/src/server/routes/pipeline-batch.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPipelineBatchRoutes = void 0;
+const pipeline_service_js_1 = require("../../services/pipeline-service.js");
+const item_batch_controller_js_1 = require("../../pipeline/item-batch-controller.js");
+const pipeline_identity_js_1 = require("./pipeline-identity.js");
+/**
+ * 注册 Pipeline Batch Run 路由：
+ *   GET    /api/pipelines/:pipelineId/items                     — Item Run 列表
+ *   GET    /api/pipelines/:pipelineId/batch-run/status          — Batch Run 状态
+ *   POST   /api/pipelines/:pipelineId/batch-run/start           — 启动本地 Batch Run
+ *   POST   /api/pipelines/:pipelineId/batch-run/start-remote    — 启动远程 Batch Run
+ *   POST   /api/pipelines/:pipelineId/batch-run/stop            — 停止 Batch Run
+ */
+const registerPipelineBatchRoutes = (router) => {
+    // GET /api/pipelines/:pipelineId/items
+    router.register("GET", "/api/pipelines/:pipelineId/items", (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        if (!scope.getItemRuns) {
+            ctx.sendJson(501, { error: "item_run_api_not_enabled" });
+            return;
+        }
+        ctx.sendJson(200, { items: scope.getItemRuns(), pipelineId: scope.pipelineId });
+    });
+    // GET /api/pipelines/:pipelineId/batch-run/status
+    router.register("GET", "/api/pipelines/:pipelineId/batch-run/status", (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        if (!scope.getBatchRunState) {
+            ctx.sendJson(501, { error: "batch_run_api_not_enabled" });
+            return;
+        }
+        const batchRunState = scope.getBatchRunState();
+        const identity = (0, pipeline_service_js_1.readPipelineIdentitySnapshot)(scope.pipelineId, scope.getRun(), batchRunState);
+        ctx.sendJson(200, { ok: true, state: batchRunState, ...identity });
+    });
+    // POST /api/pipelines/:pipelineId/batch-run/start
+    router.register("POST", "/api/pipelines/:pipelineId/batch-run/start", async (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        const { pipelineService } = ctx.services;
+        const body = await ctx.readBody();
+        const items = (0, item_batch_controller_js_1.normalizePoolItems)(body.items ?? body.keywords ?? body.pool ?? body);
+        const batchSize = typeof body.batchSize === "number"
+            ? body.batchSize
+            : typeof body.size === "number"
+                ? body.size
+                : typeof body.chunkSize === "number"
+                    ? body.chunkSize
+                    : undefined;
+        const startIndex = typeof body.startIndex === "number" ? body.startIndex : undefined;
+        const startBatch = typeof body.startBatch === "number" ? body.startBatch : undefined;
+        const started = pipelineService.startBatchRun({
+            pipelineId: scope.pipelineId,
+            items,
+            batchSize,
+            startIndex,
+            startBatch,
+        });
+        if (started.ok === false && started.error === "batch_items_empty") {
+            ctx.sendJson(400, { error: started.error });
+            return;
+        }
+        if (!started.ok) {
+            ctx.sendJson(409, { ok: false, error: started.error, state: started.state });
+            return;
+        }
+        ctx.sendJson(200, { ok: true, state: started.state, pipelineId: scope.pipelineId });
+    });
+    // POST /api/pipelines/:pipelineId/batch-run/start-remote
+    router.register("POST", "/api/pipelines/:pipelineId/batch-run/start-remote", async (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        const { pipelineService } = ctx.services;
+        const body = await ctx.readBody();
+        const remoteUrl = typeof body.url === "string" ? body.url : undefined;
+        const batchSize = typeof body.batchSize === "number"
+            ? body.batchSize
+            : typeof body.size === "number"
+                ? body.size
+                : typeof body.chunkSize === "number"
+                    ? body.chunkSize
+                    : undefined;
+        const startIndex = typeof body.startIndex === "number" ? body.startIndex : undefined;
+        const startBatch = typeof body.startBatch === "number" ? body.startBatch : undefined;
+        const started = await pipelineService.startRemoteBatchRun({
+            pipelineId: scope.pipelineId,
+            url: remoteUrl,
+            batchSize,
+            startIndex,
+            startBatch,
+        });
+        // 保持 remote pool 相关错误状态码语义：400 / 403 / 409 / 502
+        if (started.ok === false && started.error === "pipeline_plugin_disabled") {
+            ctx.sendJson(403, { error: started.error, plugin: started.plugin, pipelineId: scope.pipelineId });
+            return;
+        }
+        if (started.ok === false &&
+            (started.error === "remote_pool_url_empty" || started.error === "remote_batch_items_empty")) {
+            ctx.sendJson(400, { error: started.error, remoteUrl: started.remoteUrl });
+            return;
+        }
+        if (started.ok === false &&
+            (started.error === "remote_pool_fetch_failed" || started.error === "remote_pool_fetch_error")) {
+            ctx.sendJson(502, {
+                error: started.error,
+                status: started.status,
+                remoteUrl: started.remoteUrl,
+                detail: started.detail,
+            });
+            return;
+        }
+        if (!started.ok) {
+            ctx.sendJson(409, { ok: false, error: started.error, state: started.state, remoteUrl: started.remoteUrl });
+            return;
+        }
+        ctx.sendJson(200, {
+            ok: true,
+            state: started.state,
+            remoteUrl: started.remoteUrl,
+            totalFetched: started.totalFetched,
+            pipelineId: scope.pipelineId,
+        });
+    });
+    // POST /api/pipelines/:pipelineId/batch-run/stop
+    // 与 /stop 共享同一业务逻辑，通过 pipelineService.stopPipeline 统一处理
+    router.register("POST", "/api/pipelines/:pipelineId/batch-run/stop", async (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        const { pipelineService } = ctx.services;
+        const body = await ctx.readBody();
+        const target = (0, pipeline_identity_js_1.mergeIdentityTargets)((0, pipeline_identity_js_1.readIdentityTargetFromBody)(body), (0, pipeline_identity_js_1.readIdentityTargetFromUrl)(ctx.url));
+        const stopped = pipelineService.stopPipeline(scope.pipelineId, target);
+        if (stopped.ok === false && stopped.error === "run_not_found") {
+            ctx.sendJson(404, stopped);
+            return;
+        }
+        if (stopped.ok === false) {
+            ctx.sendJson(409, stopped);
+            return;
+        }
+        ctx.sendJson(200, {
+            ...stopped,
+        });
+    });
+};
+exports.registerPipelineBatchRoutes = registerPipelineBatchRoutes;

package/dist/src/server/routes/pipeline-diagnostics.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPipelineDiagnosticsRoutes = void 0;
+const index_js_1 = require("../../pipeline/diagnostics/index.js");
+/**
+ * 注册 Pipeline 节点诊断路由：
+ *   GET /api/pipelines/:pipelineId/nodes/:nodeId/diagnostics?itemKey=xxx
+ */
+const registerPipelineDiagnosticsRoutes = (router) => {
+    router.register("GET", "/api/pipelines/:pipelineId/nodes/:nodeId/diagnostics", (ctx) => {
+        const scope = ctx.getPipelineScope();
+        if (!scope) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: ctx.params.pipelineId });
+            return;
+        }
+        const nodeId = ctx.params.nodeId;
+        const itemKey = ctx.url.searchParams.get("itemKey") ?? undefined;
+        const runtime = ctx.options.app.getPipelineRuntime(scope.pipelineId);
+        if (!runtime) {
+            ctx.sendJson(404, { error: "pipeline_not_found", pipelineId: scope.pipelineId });
+            return;
+        }
+        const run = scope.getRun();
+        const workflowNode = runtime.workflow.getWorkflowNodeById(nodeId);
+        if (!workflowNode) {
+            ctx.sendJson(404, { error: "node_not_found", pipelineId: scope.pipelineId, nodeId });
+            return;
+        }
+        const diagnostics = (0, index_js_1.diagnoseNodeDependency)(run, runtime.workflow, nodeId, itemKey);
+        ctx.sendJson(200, { nodeId, itemKey: itemKey ?? null, diagnostics });
+    });
+};
+exports.registerPipelineDiagnosticsRoutes = registerPipelineDiagnosticsRoutes;

package/dist/src/server/routes/pipeline-identity.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeIdentityTargets = exports.readIdentityTargetFromBody = exports.readIdentityTargetFromUrl = void 0;
+// 从 URL 查询参数提取 runId / batchRunId
+const readIdentityTargetFromUrl = (url) => ({
+    runId: String(url.searchParams.get("runId") ?? "").trim() || undefined,
+    batchRunId: String(url.searchParams.get("batchRunId") ?? "").trim() || undefined,
+});
+exports.readIdentityTargetFromUrl = readIdentityTargetFromUrl;
+// 从请求体提取 runId / batchRunId
+const readIdentityTargetFromBody = (body) => ({
+    runId: typeof body.runId === "string" && body.runId.trim() ? body.runId.trim() : undefined,
+    batchRunId: typeof body.batchRunId === "string" && body.batchRunId.trim() ? body.batchRunId.trim() : undefined,
+});
+exports.readIdentityTargetFromBody = readIdentityTargetFromBody;
+// 合并两组 IdentityTarget，primary 优先
+const mergeIdentityTargets = (primary, fallback) => {
+    const runId = primary?.runId ?? fallback?.runId;
+    const batchRunId = primary?.batchRunId ?? fallback?.batchRunId;
+    if (!runId && !batchRunId)
+        return undefined;
+    return { runId, batchRunId };
+};
+exports.mergeIdentityTargets = mergeIdentityTargets;

package/dist/src/server/routes/pipeline-links.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPipelineLinksRoutes = void 0;
+const node_crypto_1 = require("node:crypto");
+const pipeline_link_js_1 = require("../../pipeline/types/pipeline-link.js");
+const registerPipelineLinksRoutes = (router) => {
+    // GET /api/pipeline-links
+    router.register("GET", "/api/pipeline-links", async (ctx) => {
+        const { app } = ctx.options;
+        const links = await app.dispatch.listLinks();
+        ctx.sendJson(200, { ok: true, items: links });
+    });
+    // POST /api/pipeline-links
+    router.register("POST", "/api/pipeline-links", async (ctx) => {
+        const { app } = ctx.options;
+        const body = await ctx.readBody();
+        const id = typeof body.id === "string" ? body.id.trim() : `link:${(0, node_crypto_1.randomUUID)()}`;
+        if (!(0, pipeline_link_js_1.isValidLinkId)(id)) {
+            ctx.sendJson(400, { ok: false, error: "pipeline_link_invalid_id" });
+            return;
+        }
+        const fromPipelineId = typeof body.fromPipelineId === "string" ? body.fromPipelineId.trim() : "";
+        const toPipelineId = typeof body.toPipelineId === "string" ? body.toPipelineId.trim() : "";
+        if (!fromPipelineId || !toPipelineId) {
+            ctx.sendJson(400, { ok: false, error: "pipeline_link_missing_pipelines" });
+            return;
+        }
+        if (!app.getPipelineDefinition(fromPipelineId)) {
+            ctx.sendJson(400, { ok: false, error: "pipeline_not_found", detail: `上游流水线 ${fromPipelineId} 不存在` });
+            return;
+        }
+        if (!app.getPipelineDefinition(toPipelineId)) {
+            ctx.sendJson(400, { ok: false, error: "pipeline_not_found", detail: `下游流水线 ${toPipelineId} 不存在` });
+            return;
+        }
+        const contract = body.inputContract && typeof body.inputContract === "object"
+            ? {
+                requireType: typeof body.inputContract.requireType === "string"
+                    ? body.inputContract.requireType
+                    : undefined,
+                requireSchemaVersion: typeof body.inputContract.requireSchemaVersion === "number"
+                    ? body.inputContract.requireSchemaVersion
+                    : undefined,
+            }
+            : null;
+        const maxPendingJobs = typeof body.maxPendingJobs === "number" && Number.isFinite(body.maxPendingJobs)
+            ? Math.min(10000, Math.max(1, Math.trunc(body.maxPendingJobs)))
+            : 100;
+        const onJobFailed = body.onJobFailed === "pause" ? "pause" : "continue";
+        const now = new Date().toISOString();
+        const link = {
+            schemaVersion: 1,
+            id,
+            enabled: body.enabled !== false,
+            fromPipelineId,
+            toPipelineId,
+            trigger: "on_success",
+            dispatchPolicy: "fifo",
+            inputContract: contract,
+            onJobFailed,
+            maxPendingJobs,
+            createdAt: now,
+            updatedAt: now,
+        };
+        const result = await app.dispatch.createLink(link);
+        if (!result.ok) {
+            const statusCode = result.error === "pipeline_link_duplicate" ? 409 : 400;
+            ctx.sendJson(statusCode, { ok: false, error: result.error });
+            return;
+        }
+        ctx.sendJson(201, { ok: true, link: result.link });
+    });
+    // PATCH /api/pipeline-links/:linkId
+    router.register("PATCH", "/api/pipeline-links/:linkId", async (ctx) => {
+        const { app } = ctx.options;
+        const { linkId } = ctx.params;
+        const body = await ctx.readBody();
+        const patch = {};
+        if (typeof body.enabled === "boolean")
+            patch.enabled = body.enabled;
+        if (body.inputContract !== undefined) {
+            patch.inputContract = body.inputContract && typeof body.inputContract === "object"
+                ? {
+                    requireType: typeof body.inputContract.requireType === "string"
+                        ? body.inputContract.requireType
+                        : undefined,
+                    requireSchemaVersion: typeof body.inputContract.requireSchemaVersion === "number"
+                        ? body.inputContract.requireSchemaVersion
+                        : undefined,
+                }
+                : null;
+        }
+        if (body.onJobFailed === "continue" || body.onJobFailed === "pause")
+            patch.onJobFailed = body.onJobFailed;
+        if (typeof body.maxPendingJobs === "number" && Number.isFinite(body.maxPendingJobs)) {
+            patch.maxPendingJobs = Math.min(10000, Math.max(1, Math.trunc(body.maxPendingJobs)));
+        }
+        const result = await app.dispatch.updateLink(linkId, patch);
+        if (!result.ok) {
+            ctx.sendJson(404, { ok: false, error: result.error });
+            return;
+        }
+        ctx.sendJson(200, { ok: true, link: result.link });
+    });
+    // DELETE /api/pipeline-links/:linkId
+    router.register("DELETE", "/api/pipeline-links/:linkId", async (ctx) => {
+        const { app } = ctx.options;
+        const { linkId } = ctx.params;
+        const result = await app.dispatch.deleteLink(linkId);
+        if (!result.ok) {
+            ctx.sendJson(404, { ok: false, error: result.error });
+            return;
+        }
+        ctx.sendJson(200, { ok: true });
+    });
+};
+exports.registerPipelineLinksRoutes = registerPipelineLinksRoutes;

package/dist/src/server/routes/pipeline-outputs.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPipelineOutputsRoutes = void 0;
+const registerPipelineOutputsRoutes = (router) => {
+    // GET /api/pipelines/:pipelineId/outputs
+    router.register("GET", "/api/pipelines/:pipelineId/outputs", async (ctx) => {
+        const { app } = ctx.options;
+        const { pipelineId } = ctx.params;
+        const runtime = app.getPipelineRuntime(pipelineId);
+        if (!runtime) {
+            ctx.sendJson(404, { ok: false, error: "pipeline_not_found", pipelineId });
+            return;
+        }
+        const runId = ctx.url.searchParams.get("runId")?.trim() || undefined;
+        const batchRunId = ctx.url.searchParams.get("batchRunId")?.trim() || undefined;
+        const outputs = await runtime.output.list();
+        let filtered = outputs;
+        if (runId)
+            filtered = filtered.filter((o) => o.runId === runId);
+        if (batchRunId)
+            filtered = filtered.filter((o) => o.batchRunId === batchRunId);
+        // Sort newest first
+        filtered.sort((a, b) => b.producedAt.localeCompare(a.producedAt));
+        ctx.sendJson(200, { ok: true, pipelineId, items: filtered });
+    });
+};
+exports.registerPipelineOutputsRoutes = registerPipelineOutputsRoutes;