@jingyi0605/codingns 0.1.5 → 0.2.5

package/dist/server/modules/tasks/observability-service.d.ts

@@ -0,0 +1,32 @@
+import type { TaskMetricsSnapshot } from "./task-types.js";
+import type { SchedulerMetricsSnapshot } from "./scheduler-metrics.js";
+import type { EventLoopDelaySnapshot, EventLoopMonitor } from "./event-loop-monitor.js";
+import type { TaskActivityLog, TaskActivityRecord } from "./task-activity-log.js";
+export interface RuntimeObservabilitySessionLease {
+    readonly sessionId: string;
+    readonly expiresAt: string;
+    readonly ttlMs: number;
+}
+export interface RuntimeObservabilitySnapshot {
+    readonly observedAt: string;
+    readonly session: RuntimeObservabilitySessionLease;
+    readonly backgroundTasks: TaskMetricsSnapshot;
+    readonly recentTaskActivities: TaskActivityRecord[];
+    readonly schedulers: SchedulerMetricsSnapshot;
+    readonly eventLoop: EventLoopDelaySnapshot;
+}
+export declare class RuntimeObservabilityService {
+    private readonly getTaskMetrics;
+    private readonly getSchedulerMetrics;
+    private readonly eventLoopMonitor;
+    private readonly taskActivityLog;
+    private readonly sessions;
+    constructor(getTaskMetrics: () => TaskMetricsSnapshot, getSchedulerMetrics: () => SchedulerMetricsSnapshot, eventLoopMonitor: EventLoopMonitor, taskActivityLog: TaskActivityLog);
+    hasActiveSession(): boolean;
+    openSession(ttlMs?: number): RuntimeObservabilitySessionLease;
+    touchSession(sessionId: string, ttlMs?: number): RuntimeObservabilitySessionLease;
+    closeSession(sessionId: string): void;
+    observe(sessionId: string, activityLimit?: number): RuntimeObservabilitySnapshot;
+    private pruneExpiredSessions;
+    private syncCollectors;
+}

package/dist/server/modules/tasks/observability-service.js

@@ -0,0 +1,104 @@
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+import { AppError } from "../../shared/errors/app-error.js";
+const DEFAULT_SESSION_TTL_MS = 20_000;
+const MIN_SESSION_TTL_MS = 5_000;
+const MAX_SESSION_TTL_MS = 120_000;
+export class RuntimeObservabilityService {
+    getTaskMetrics;
+    getSchedulerMetrics;
+    eventLoopMonitor;
+    taskActivityLog;
+    sessions = new Map();
+    constructor(getTaskMetrics, getSchedulerMetrics, eventLoopMonitor, taskActivityLog) {
+        this.getTaskMetrics = getTaskMetrics;
+        this.getSchedulerMetrics = getSchedulerMetrics;
+        this.eventLoopMonitor = eventLoopMonitor;
+        this.taskActivityLog = taskActivityLog;
+    }
+    hasActiveSession() {
+        this.pruneExpiredSessions();
+        return this.sessions.size > 0;
+    }
+    openSession(ttlMs) {
+        this.pruneExpiredSessions();
+        const normalizedTtlMs = normalizeSessionTtlMs(ttlMs);
+        const sessionId = createId();
+        const expiresAtMs = Date.now() + normalizedTtlMs;
+        this.sessions.set(sessionId, {
+            expiresAtMs,
+            ttlMs: normalizedTtlMs
+        });
+        this.syncCollectors();
+        return buildLease(sessionId, expiresAtMs, normalizedTtlMs);
+    }
+    touchSession(sessionId, ttlMs) {
+        this.pruneExpiredSessions();
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "OBSERVABILITY_SESSION_NOT_FOUND",
+                detail: "观测会话不存在或已过期"
+            });
+        }
+        const normalizedTtlMs = normalizeSessionTtlMs(ttlMs ?? session.ttlMs);
+        session.ttlMs = normalizedTtlMs;
+        session.expiresAtMs = Date.now() + normalizedTtlMs;
+        this.sessions.set(sessionId, session);
+        this.syncCollectors();
+        return buildLease(sessionId, session.expiresAtMs, normalizedTtlMs);
+    }
+    closeSession(sessionId) {
+        this.pruneExpiredSessions();
+        this.sessions.delete(sessionId);
+        this.syncCollectors();
+    }
+    observe(sessionId, activityLimit = 100) {
+        const session = this.touchSession(sessionId);
+        return {
+            observedAt: nowIso(),
+            session,
+            backgroundTasks: this.getTaskMetrics(),
+            recentTaskActivities: this.taskActivityLog.list(activityLimit),
+            schedulers: this.getSchedulerMetrics(),
+            eventLoop: this.eventLoopMonitor.observe()
+        };
+    }
+    pruneExpiredSessions() {
+        const now = Date.now();
+        let changed = false;
+        for (const [sessionId, session] of this.sessions.entries()) {
+            if (session.expiresAtMs > now) {
+                continue;
+            }
+            this.sessions.delete(sessionId);
+            changed = true;
+        }
+        if (changed) {
+            this.syncCollectors();
+        }
+    }
+    syncCollectors() {
+        if (this.sessions.size > 0) {
+            this.eventLoopMonitor.start();
+            return;
+        }
+        this.taskActivityLog.clear();
+        this.eventLoopMonitor.stop();
+    }
+}
+function normalizeSessionTtlMs(value) {
+    if (!value || !Number.isFinite(value)) {
+        return DEFAULT_SESSION_TTL_MS;
+    }
+    return Math.min(MAX_SESSION_TTL_MS, Math.max(MIN_SESSION_TTL_MS, Math.floor(value)));
+}
+function buildLease(sessionId, expiresAtMs, ttlMs) {
+    return {
+        sessionId,
+        expiresAt: new Date(expiresAtMs).toISOString(),
+        ttlMs
+    };
+}
+//# sourceMappingURL=observability-service.js.map

package/dist/server/modules/tasks/observability-service.js.map

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

package/dist/server/modules/tasks/scheduler-metrics.d.ts

@@ -0,0 +1,41 @@
+export interface SchedulerDurationStatsSnapshot {
+    readonly count: number;
+    readonly total: number;
+    readonly max: number;
+    readonly min: number | null;
+    readonly avg: number;
+}
+export interface SchedulerMetricSnapshot {
+    readonly tickTotal: number;
+    readonly idleTickTotal: number;
+    readonly errorTotal: number;
+    readonly taskCountTotal: number;
+    readonly durationMs: SchedulerDurationStatsSnapshot;
+    readonly lastTickAt: string | null;
+    readonly lastDurationMs: number | null;
+    readonly lastTaskCount: number;
+    readonly lastIdle: boolean;
+    readonly lastErrorCount: number;
+    readonly nextDelayMs: number | null;
+    readonly idleStreak: number;
+}
+export interface SchedulerMetricsSnapshot {
+    readonly schedulers: Readonly<Record<string, SchedulerMetricSnapshot>>;
+}
+export interface SchedulerTickObservation {
+    readonly schedulerName: string;
+    readonly referenceAt: string;
+    readonly durationMs: number;
+    readonly taskCount: number;
+    readonly idle: boolean;
+    readonly errorCount?: number;
+    readonly nextDelayMs?: number | null;
+    readonly idleStreak?: number;
+}
+export declare class SchedulerMetrics {
+    private readonly schedulers;
+    recordTick(observation: SchedulerTickObservation): void;
+    observe(): SchedulerMetricsSnapshot;
+    private getState;
+}
+export declare function resolveAdaptiveSchedulerDelayMs(baseIntervalMs: number, maxIntervalMs: number, idleStreak: number): number;

package/dist/server/modules/tasks/scheduler-metrics.js

@@ -0,0 +1,92 @@
+export class SchedulerMetrics {
+    schedulers = new Map();
+    recordTick(observation) {
+        const state = this.getState(observation.schedulerName);
+        const durationMs = Math.max(0, observation.durationMs);
+        const errorCount = Math.max(0, observation.errorCount ?? 0);
+        state.tickTotal += 1;
+        state.taskCountTotal += Math.max(0, observation.taskCount);
+        state.errorTotal += errorCount;
+        state.lastTickAt = observation.referenceAt;
+        state.lastDurationMs = durationMs;
+        state.lastTaskCount = Math.max(0, observation.taskCount);
+        state.lastIdle = observation.idle;
+        state.lastErrorCount = errorCount;
+        state.nextDelayMs = observation.nextDelayMs ?? null;
+        state.idleStreak = Math.max(0, observation.idleStreak ?? 0);
+        if (observation.idle) {
+            state.idleTickTotal += 1;
+        }
+        state.durationMs.count += 1;
+        state.durationMs.total += durationMs;
+        state.durationMs.max = Math.max(state.durationMs.max, durationMs);
+        state.durationMs.min =
+            state.durationMs.min === null ? durationMs : Math.min(state.durationMs.min, durationMs);
+    }
+    observe() {
+        return {
+            schedulers: Object.fromEntries([...this.schedulers.entries()].map(([name, state]) => [
+                name,
+                {
+                    tickTotal: state.tickTotal,
+                    idleTickTotal: state.idleTickTotal,
+                    errorTotal: state.errorTotal,
+                    taskCountTotal: state.taskCountTotal,
+                    durationMs: snapshotDuration(state.durationMs),
+                    lastTickAt: state.lastTickAt,
+                    lastDurationMs: state.lastDurationMs,
+                    lastTaskCount: state.lastTaskCount,
+                    lastIdle: state.lastIdle,
+                    lastErrorCount: state.lastErrorCount,
+                    nextDelayMs: state.nextDelayMs,
+                    idleStreak: state.idleStreak
+                }
+            ]))
+        };
+    }
+    getState(name) {
+        const existing = this.schedulers.get(name);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            tickTotal: 0,
+            idleTickTotal: 0,
+            errorTotal: 0,
+            taskCountTotal: 0,
+            durationMs: {
+                count: 0,
+                total: 0,
+                max: 0,
+                min: null
+            },
+            lastTickAt: null,
+            lastDurationMs: null,
+            lastTaskCount: 0,
+            lastIdle: false,
+            lastErrorCount: 0,
+            nextDelayMs: null,
+            idleStreak: 0
+        };
+        this.schedulers.set(name, created);
+        return created;
+    }
+}
+export function resolveAdaptiveSchedulerDelayMs(baseIntervalMs, maxIntervalMs, idleStreak) {
+    const normalizedBase = Math.max(1, Math.floor(baseIntervalMs));
+    const normalizedMax = Math.max(normalizedBase, Math.floor(maxIntervalMs));
+    if (idleStreak <= 0) {
+        return normalizedBase;
+    }
+    return Math.min(normalizedMax, normalizedBase * (2 ** Math.max(0, idleStreak - 1)));
+}
+function snapshotDuration(state) {
+    return {
+        count: state.count,
+        total: state.total,
+        max: state.max,
+        min: state.min,
+        avg: state.count > 0 ? state.total / state.count : 0
+    };
+}
+//# sourceMappingURL=scheduler-metrics.js.map

package/dist/server/modules/tasks/scheduler-metrics.js.map

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

package/dist/server/modules/tasks/task-activity-log.d.ts

@@ -0,0 +1,39 @@
+import type { TaskExecutionLane, TaskStatus } from "./task-types.js";
+export type TaskActivityEventType = "enqueued" | "deduped" | "started" | "finished" | "failed" | "cancelled" | "timeout" | "cache_hit";
+export interface TaskActivityRecord {
+    readonly eventId: string;
+    readonly recordedAt: string;
+    readonly eventType: TaskActivityEventType;
+    readonly taskId: string | null;
+    readonly taskType: string;
+    readonly key: string;
+    readonly executionLane: TaskExecutionLane;
+    readonly source: string | null;
+    readonly status: TaskStatus | null;
+    readonly attempt: number | null;
+    readonly waitMs: number | null;
+    readonly runMs: number | null;
+    readonly errorMessage: string | null;
+}
+export interface TaskActivityEventInput {
+    readonly eventType: TaskActivityEventType;
+    readonly taskId?: string | null;
+    readonly taskType: string;
+    readonly key: string;
+    readonly executionLane: TaskExecutionLane;
+    readonly source?: string | null;
+    readonly status?: TaskStatus | null;
+    readonly attempt?: number | null;
+    readonly waitMs?: number | null;
+    readonly runMs?: number | null;
+    readonly errorMessage?: string | null;
+}
+export declare class TaskActivityLog {
+    private readonly isEnabled;
+    private readonly limit;
+    private readonly records;
+    constructor(isEnabled: () => boolean, limit?: number);
+    record(input: TaskActivityEventInput): void;
+    list(limit?: number): TaskActivityRecord[];
+    clear(): void;
+}

package/dist/server/modules/tasks/task-activity-log.js

@@ -0,0 +1,43 @@
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class TaskActivityLog {
+    isEnabled;
+    limit;
+    records = [];
+    constructor(isEnabled, limit = 200) {
+        this.isEnabled = isEnabled;
+        this.limit = limit;
+    }
+    record(input) {
+        if (!this.isEnabled()) {
+            return;
+        }
+        this.records.unshift({
+            eventId: createId(),
+            recordedAt: nowIso(),
+            eventType: input.eventType,
+            taskId: input.taskId ?? null,
+            taskType: input.taskType,
+            key: input.key,
+            executionLane: input.executionLane,
+            source: input.source ?? null,
+            status: input.status ?? null,
+            attempt: input.attempt ?? null,
+            waitMs: input.waitMs ?? null,
+            runMs: input.runMs ?? null,
+            errorMessage: input.errorMessage ?? null
+        });
+        if (this.records.length > this.limit) {
+            this.records.length = this.limit;
+        }
+    }
+    list(limit = 100) {
+        return this.records.slice(0, Math.max(1, limit)).map((record) => ({
+            ...record
+        }));
+    }
+    clear() {
+        this.records.length = 0;
+    }
+}
+//# sourceMappingURL=task-activity-log.js.map

package/dist/server/modules/tasks/task-activity-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-activity-log.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-activity-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AA2CpD,MAAM,OAAO,eAAe;IAIP;IACA;IAJF,OAAO,GAAyB,EAAE,CAAC;IAEpD,YACmB,SAAwB,EACxB,QAAQ,GAAG;QADX,cAAS,GAAT,SAAS,CAAe;QACxB,UAAK,GAAL,KAAK,CAAM;IAC3B,CAAC;IAEJ,MAAM,CAAC,KAA6B;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,QAAQ,EAAE;YACnB,UAAU,EAAE,MAAM,EAAE;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;SACzC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,GAAG,GAAG;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChE,GAAG,MAAM;SACV,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/server/modules/tasks/task-helper-client.d.ts

@@ -0,0 +1,11 @@
+import type { TaskHelperProcessHandlerName } from "./task-helper-process-handlers.js";
+export declare class TaskHelperProcessClient {
+    private readonly child;
+    private readonly stdoutReader;
+    private readonly pendingRequests;
+    private nextRequestId;
+    constructor();
+    execute<TResult>(handler: TaskHelperProcessHandlerName, input: unknown, signal?: AbortSignal): Promise<TResult>;
+    private handleResponseLine;
+    private rejectAll;
+}

package/dist/server/modules/tasks/task-helper-client.js

@@ -0,0 +1,132 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import readline from "node:readline";
+import { fileURLToPath } from "node:url";
+export class TaskHelperProcessClient {
+    child;
+    stdoutReader;
+    pendingRequests = new Map();
+    nextRequestId = 1;
+    constructor() {
+        const launch = resolveHelperLaunch();
+        this.child = spawn(launch.command, launch.args, {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        this.stdoutReader = readline.createInterface({
+            input: this.child.stdout
+        });
+        this.stdoutReader.on("line", (line) => {
+            this.handleResponseLine(line);
+        });
+        this.child.stderr.on("data", (chunk) => {
+            const content = String(chunk).trim();
+            if (content) {
+                console.warn(`[task-helper] ${content}`);
+            }
+        });
+        this.child.on("error", (error) => {
+            this.rejectAll(error);
+        });
+        this.child.on("exit", (code, signal) => {
+            this.rejectAll(new Error(`task helper 已退出：code=${code ?? "null"} signal=${signal ?? "null"}`));
+        });
+    }
+    async execute(handler, input, signal) {
+        const id = String(this.nextRequestId++);
+        return await new Promise((resolve, reject) => {
+            let aborted = false;
+            let onAbort = null;
+            if (signal) {
+                onAbort = () => {
+                    aborted = true;
+                    this.pendingRequests.delete(id);
+                    reject(signal.reason ?? new Error("helper task aborted"));
+                };
+                if (signal.aborted) {
+                    onAbort();
+                    return;
+                }
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+            this.pendingRequests.set(id, {
+                resolve: (value) => {
+                    if (onAbort && signal) {
+                        signal.removeEventListener("abort", onAbort);
+                    }
+                    if (!aborted) {
+                        resolve(value);
+                    }
+                },
+                reject: (error) => {
+                    if (onAbort && signal) {
+                        signal.removeEventListener("abort", onAbort);
+                    }
+                    if (!aborted) {
+                        reject(error);
+                    }
+                }
+            });
+            this.child.stdin.write(`${JSON.stringify({
+                id,
+                handler,
+                input
+            })}\n`, (error) => {
+                if (!error) {
+                    return;
+                }
+                if (onAbort && signal) {
+                    signal.removeEventListener("abort", onAbort);
+                }
+                this.pendingRequests.delete(id);
+                reject(error);
+            });
+        });
+    }
+    handleResponseLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{")) {
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        const pending = this.pendingRequests.get(payload.id);
+        if (!pending) {
+            return;
+        }
+        this.pendingRequests.delete(payload.id);
+        if (payload.ok) {
+            pending.resolve(payload.result);
+            return;
+        }
+        pending.reject(new Error(payload.error));
+    }
+    rejectAll(error) {
+        for (const pending of this.pendingRequests.values()) {
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+    }
+}
+function resolveHelperLaunch() {
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const extension = path.extname(currentFilePath);
+    const helperPath = currentFilePath.replace(/task-helper-client\.(ts|js)$/, `task-helper-process${extension}`);
+    if (extension === ".ts") {
+        return {
+            command: process.execPath,
+            args: ["--import", "tsx", helperPath]
+        };
+    }
+    return {
+        command: process.execPath,
+        args: [helperPath]
+    };
+}
+//# sourceMappingURL=task-helper-client.js.map

package/dist/server/modules/tasks/task-helper-client.js.map

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

package/dist/server/modules/tasks/task-helper-process-handlers.d.ts

@@ -0,0 +1,16 @@
+import type { TerminalTemplateRuntimeStatus } from "../../types/domain.js";
+import type { WorkspaceCodeCompositionSummary } from "../workspace/workspace-service.js";
+interface TaskHelperProcessHandlerMap {
+    "workspace.code_composition_scan": (input: {
+        workspacePath: string;
+    }) => WorkspaceCodeCompositionSummary | Promise<WorkspaceCodeCompositionSummary>;
+    "terminal.template_runtime_status_discovery": (input: {
+        items: Array<{
+            templateId: string;
+            port: number;
+        }>;
+    }) => TerminalTemplateRuntimeStatus[] | Promise<TerminalTemplateRuntimeStatus[]>;
+}
+export type TaskHelperProcessHandlerName = keyof TaskHelperProcessHandlerMap;
+export declare function runTaskHelperProcessHandler(handler: TaskHelperProcessHandlerName, input: unknown): Promise<unknown>;
+export {};

package/dist/server/modules/tasks/task-helper-process-handlers.js

@@ -0,0 +1,14 @@
+import { discoverTemplateRuntimeStatuses } from "../terminal/template-port-runtime.js";
+import { readWorkspaceCodeComposition } from "../workspace/workspace-code-composition.js";
+const TASK_HELPER_PROCESS_HANDLERS = {
+    "workspace.code_composition_scan": ({ workspacePath }) => readWorkspaceCodeComposition(workspacePath),
+    "terminal.template_runtime_status_discovery": ({ items }) => discoverTemplateRuntimeStatuses(items)
+};
+export async function runTaskHelperProcessHandler(handler, input) {
+    const handlerFn = TASK_HELPER_PROCESS_HANDLERS[handler];
+    if (!handlerFn) {
+        throw new Error(`未知 helper_process 处理器: ${handler}`);
+    }
+    return await handlerFn(input);
+}
+//# sourceMappingURL=task-helper-process-handlers.js.map

package/dist/server/modules/tasks/task-helper-process-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-helper-process-handlers.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-helper-process-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EACL,4BAA4B,EAC7B,MAAM,4CAA4C,CAAC;AAYpD,MAAM,4BAA4B,GAAgC;IAChE,iCAAiC,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CACvD,4BAA4B,CAAC,aAAa,CAAC;IAC7C,4CAA4C,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAC1D,+BAA+B,CAAC,KAAK,CAAC;CACzC,CAAC;AAIF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqC,EACrC,KAAc;IAEd,MAAM,SAAS,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAExD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,SAAS,CAAC,KAAc,CAAC,CAAC;AACzC,CAAC"}

package/dist/server/modules/tasks/task-helper-process.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/modules/tasks/task-helper-process.js

@@ -0,0 +1,49 @@
+import readline from "node:readline";
+import { runTaskHelperProcessHandler } from "./task-helper-process-handlers.js";
+const reader = readline.createInterface({
+    input: process.stdin,
+    crlfDelay: Number.POSITIVE_INFINITY
+});
+reader.on("line", (line) => {
+    void handleLine(line);
+});
+async function handleLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(trimmed);
+    }
+    catch (error) {
+        writeResponse({
+            type: "result",
+            id: "unknown",
+            ok: false,
+            error: error instanceof Error ? error.message : "helper request parse failed"
+        });
+        return;
+    }
+    try {
+        const result = await runTaskHelperProcessHandler(payload.handler, payload.input);
+        writeResponse({
+            type: "result",
+            id: payload.id,
+            ok: true,
+            result
+        });
+    }
+    catch (error) {
+        writeResponse({
+            type: "result",
+            id: payload.id,
+            ok: false,
+            error: error instanceof Error ? error.message : "helper task failed"
+        });
+    }
+}
+function writeResponse(payload) {
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+}
+//# sourceMappingURL=task-helper-process.js.map

package/dist/server/modules/tasks/task-helper-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-helper-process.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-helper-process.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EACL,2BAA2B,EAE5B,MAAM,mCAAmC,CAAC;AAsB3C,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC;IACtC,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC,iBAAiB;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;IACzB,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,SAAS;YACb,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B;SAC9E,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjF,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,EAAE,EAAE,IAAI;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB;SACrE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAA2B;IAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/server/modules/tasks/task-lane-executors.d.ts

@@ -0,0 +1,2 @@
+import type { TaskExecutionLane, TaskLaneExecutor } from "./task-types.js";
+export declare function createHostTaskLaneExecutors(): Partial<Record<TaskExecutionLane, TaskLaneExecutor>>;

package/dist/server/modules/tasks/task-lane-executors.js

@@ -0,0 +1,15 @@
+import { TaskHelperProcessClient } from "./task-helper-client.js";
+export function createHostTaskLaneExecutors() {
+    const helperProcessClient = new TaskHelperProcessClient();
+    return {
+        helper_process: {
+            execute: async (definition, input, context) => {
+                if (!definition.helperProcessHandler) {
+                    return await definition.run(input, context);
+                }
+                return await helperProcessClient.execute(definition.helperProcessHandler, input, context.signal);
+            }
+        }
+    };
+}
+//# sourceMappingURL=task-lane-executors.js.map

package/dist/server/modules/tasks/task-lane-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lane-executors.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-lane-executors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,MAAM,UAAU,2BAA2B;IACzC,MAAM,mBAAmB,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE1D,OAAO;QACL,cAAc,EAAE;YACd,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC5C,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;oBACrC,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC9C,CAAC;gBAED,OAAO,MAAM,mBAAmB,CAAC,OAAO,CACtC,UAAU,CAAC,oBAA6B,EACxC,KAAK,EACL,OAAO,CAAC,MAAM,CACf,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}