@bluelibs/runner-dev 5.1.0 → 6.0.0

package/dist/utils/healthCollectors.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gcTotalDurationMs = exports.gcTotalCollections = void 0;
+exports.getEventLoopMeanNs = getEventLoopMeanNs;
+exports.resetEventLoopHistogram = resetEventLoopHistogram;
+exports.getGcWindow = getGcWindow;
+exports.getCpuEluUtilization = getCpuEluUtilization;
+exports.getHealthSnapshot = getHealthSnapshot;
+exports.latestTimestamp = latestTimestamp;
+/**
+ * Shared system health collectors used by both the GraphQL live resolvers
+ * and the SSE stream handler. Centralises event‐loop delay, GC tracking,
+ * and CPU ELU measurement so only one set of observers exists per process.
+ */
+const os = __importStar(require("node:os"));
+const node_perf_hooks_1 = require("node:perf_hooks");
+// ---------------------------------------------------------------------------
+// Event‐loop delay histogram
+// ---------------------------------------------------------------------------
+let histogram;
+try {
+    histogram = (0, node_perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
+    histogram.enable();
+}
+catch {
+    // Unsupported runtime (e.g. older Node or non‐Node)
+}
+/** Mean event‐loop delay in nanoseconds. */
+function getEventLoopMeanNs() {
+    return histogram?.mean ?? 0;
+}
+/** Reset the event‐loop delay histogram (for the optional `reset` arg). */
+function resetEventLoopHistogram() {
+    try {
+        histogram?.reset();
+    }
+    catch {
+        // ignore
+    }
+}
+// ---------------------------------------------------------------------------
+// GC tracking — both lifetime totals and a windowed ring buffer
+// ---------------------------------------------------------------------------
+/** Total GC collections observed since process start. */
+exports.gcTotalCollections = 0;
+/** Total GC pause duration (ms) since process start. */
+exports.gcTotalDurationMs = 0;
+const gcEvents = [];
+const GC_EVENTS_MAX = 10_000;
+function pushGcEvent(duration) {
+    gcEvents.push({ ts: Date.now(), duration });
+    if (gcEvents.length > GC_EVENTS_MAX) {
+        gcEvents.splice(0, Math.floor(GC_EVENTS_MAX * 0.1));
+    }
+}
+try {
+    const obs = new node_perf_hooks_1.PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) {
+            exports.gcTotalCollections += 1;
+            exports.gcTotalDurationMs += entry.duration;
+            pushGcEvent(entry.duration);
+        }
+    });
+    obs.observe({ entryTypes: ["gc"], buffered: true });
+}
+catch {
+    // noop — GC observation not available
+}
+/** Return GC stats within a sliding time window. */
+function getGcWindow(windowMs) {
+    const since = Date.now() - windowMs;
+    let collections = 0;
+    let duration = 0;
+    for (let i = gcEvents.length - 1; i >= 0; i--) {
+        if (gcEvents[i].ts < since)
+            break;
+        collections += 1;
+        duration += gcEvents[i].duration;
+    }
+    return { collections, duration };
+}
+// ---------------------------------------------------------------------------
+// CPU utilisation via Event Loop Utilisation (ELU)
+// ---------------------------------------------------------------------------
+let prevElu;
+function getCpuEluUtilization() {
+    try {
+        const current = prevElu
+            ? node_perf_hooks_1.performance.eventLoopUtilization(prevElu)
+            : node_perf_hooks_1.performance.eventLoopUtilization();
+        prevElu = current;
+        return Number.isFinite(current.utilization) ? current.utilization : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function getHealthSnapshot(gcWindowMs = 30_000) {
+    const m = process.memoryUsage();
+    const meanNs = getEventLoopMeanNs();
+    const gc = getGcWindow(gcWindowMs);
+    return {
+        memory: { heapUsed: m.heapUsed, heapTotal: m.heapTotal, rss: m.rss },
+        cpu: { usage: getCpuEluUtilization(), loadAverage: os.loadavg()[0] ?? 0 },
+        eventLoop: { lag: Number.isFinite(meanNs) ? meanNs / 1e6 : 0 },
+        gc,
+    };
+}
+// ---------------------------------------------------------------------------
+// Timestamp helpers
+// ---------------------------------------------------------------------------
+/** Extract the latest `timestampMs` from one or more arrays of timestamped entries. */
+function latestTimestamp(...arrays) {
+    let max;
+    for (const arr of arrays) {
+        for (const entry of arr) {
+            if (max === undefined || entry.timestampMs > max) {
+                max = entry.timestampMs;
+            }
+        }
+    }
+    return max;
+}
+//# sourceMappingURL=healthCollectors.js.map

package/dist/utils/healthCollectors.js.map

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

package/dist/utils/lane-resources.d.ts

@@ -0,0 +1,55 @@
+export declare const EVENT_LANE_TAG_ID = "runner.tags.eventLane";
+export declare const RPC_LANE_TAG_ID = "runner.tags.rpcLane";
+export declare const EVENT_LANES_RESOURCE_ID = "runner.node.eventLanes";
+export declare const EVENT_LANES_RESOURCE_TAG_ID = "runner.tags.eventLanes";
+export declare const RPC_LANES_RESOURCE_ID = "platform.node.resources.rpcLanes";
+export declare const RPC_LANES_RESOURCE_TAG_ID = "runner.tags.rpcLanes";
+type TagIds = string[] | null | undefined;
+export type LaneResourceLike = {
+    id: string;
+    tags?: TagIds;
+};
+export type RpcLaneLike = {
+    id?: unknown;
+} | string;
+export type RpcCommunicatorLike = {
+    id?: unknown;
+} | string;
+export type RpcLanesResourceConfigShape = {
+    mode?: string;
+    profile?: string;
+    communicator?: RpcCommunicatorLike;
+    communicators?: RpcCommunicatorLike[];
+    topology?: {
+        bindings?: Array<{
+            lane?: RpcLaneLike;
+            communicator?: RpcCommunicatorLike;
+            communicatorId?: string;
+        }>;
+        profiles?: Record<string, {
+            serve?: RpcLaneLike[];
+            communicator?: RpcCommunicatorLike;
+            communicatorId?: string;
+        }>;
+    };
+};
+export type RpcLaneBindingSummary = {
+    laneId: string;
+    communicatorId: string | null;
+};
+export type RpcLaneProfileSummary = {
+    profileId: string;
+    serveLaneIds: string[];
+    communicatorId: string | null;
+};
+export declare function isEventLanesResource(resource: LaneResourceLike): boolean;
+export declare function isRpcLanesResource(resource: LaneResourceLike): boolean;
+export declare function parseRpcLanesResourceConfig(resourceConfig: string | null | undefined): RpcLanesResourceConfigShape | null;
+export declare function extractLaneId(laneLike: unknown): string | null;
+export declare function extractCommunicatorId(communicatorLike: unknown): string | null;
+export declare function collectRpcLaneIds(config: RpcLanesResourceConfigShape | null | undefined): Set<string>;
+export declare function collectRpcLaneIdsFromResourceConfig(resourceConfig: string | null | undefined): Set<string>;
+export declare function getRpcLaneBindings(config: RpcLanesResourceConfigShape | null | undefined): RpcLaneBindingSummary[];
+export declare function getRpcLaneProfiles(config: RpcLanesResourceConfigShape | null | undefined): RpcLaneProfileSummary[];
+export declare function collectRpcCommunicatorIds(config: RpcLanesResourceConfigShape | null | undefined, bindings?: RpcLaneBindingSummary[], profiles?: RpcLaneProfileSummary[]): string[];
+export {};

package/dist/utils/lane-resources.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPC_LANES_RESOURCE_TAG_ID = exports.RPC_LANES_RESOURCE_ID = exports.EVENT_LANES_RESOURCE_TAG_ID = exports.EVENT_LANES_RESOURCE_ID = exports.RPC_LANE_TAG_ID = exports.EVENT_LANE_TAG_ID = void 0;
+exports.isEventLanesResource = isEventLanesResource;
+exports.isRpcLanesResource = isRpcLanesResource;
+exports.parseRpcLanesResourceConfig = parseRpcLanesResourceConfig;
+exports.extractLaneId = extractLaneId;
+exports.extractCommunicatorId = extractCommunicatorId;
+exports.collectRpcLaneIds = collectRpcLaneIds;
+exports.collectRpcLaneIdsFromResourceConfig = collectRpcLaneIdsFromResourceConfig;
+exports.getRpcLaneBindings = getRpcLaneBindings;
+exports.getRpcLaneProfiles = getRpcLaneProfiles;
+exports.collectRpcCommunicatorIds = collectRpcCommunicatorIds;
+exports.EVENT_LANE_TAG_ID = "runner.tags.eventLane";
+exports.RPC_LANE_TAG_ID = "runner.tags.rpcLane";
+exports.EVENT_LANES_RESOURCE_ID = "runner.node.eventLanes";
+exports.EVENT_LANES_RESOURCE_TAG_ID = "runner.tags.eventLanes";
+exports.RPC_LANES_RESOURCE_ID = "platform.node.resources.rpcLanes";
+exports.RPC_LANES_RESOURCE_TAG_ID = "runner.tags.rpcLanes";
+function hasTag(tags, tagId) {
+    if (!Array.isArray(tags))
+        return false;
+    return tags.some((candidate) => candidate === tagId);
+}
+function isEventLanesResource(resource) {
+    return (resource.id === exports.EVENT_LANES_RESOURCE_ID ||
+        hasTag(resource.tags, exports.EVENT_LANES_RESOURCE_TAG_ID));
+}
+function isRpcLanesResource(resource) {
+    return (resource.id === exports.RPC_LANES_RESOURCE_ID ||
+        hasTag(resource.tags, exports.RPC_LANES_RESOURCE_TAG_ID));
+}
+function parseRpcLanesResourceConfig(resourceConfig) {
+    if (!resourceConfig)
+        return null;
+    try {
+        return JSON.parse(resourceConfig);
+    }
+    catch {
+        return null;
+    }
+}
+function extractLaneId(laneLike) {
+    if (typeof laneLike === "string") {
+        const laneId = laneLike.trim();
+        return laneId.length > 0 ? laneId : null;
+    }
+    if (!laneLike || typeof laneLike !== "object")
+        return null;
+    const candidateId = laneLike.id;
+    if (typeof candidateId !== "string")
+        return null;
+    const laneId = candidateId.trim();
+    return laneId.length > 0 ? laneId : null;
+}
+function extractCommunicatorId(communicatorLike) {
+    if (typeof communicatorLike === "string") {
+        const communicatorId = communicatorLike.trim();
+        return communicatorId.length > 0 ? communicatorId : null;
+    }
+    if (!communicatorLike || typeof communicatorLike !== "object")
+        return null;
+    const candidateId = communicatorLike.id;
+    if (typeof candidateId !== "string")
+        return null;
+    const communicatorId = candidateId.trim();
+    return communicatorId.length > 0 ? communicatorId : null;
+}
+function collectRpcLaneIds(config) {
+    const laneIds = new Set();
+    if (!config)
+        return laneIds;
+    const bindings = config.topology?.bindings;
+    if (Array.isArray(bindings)) {
+        for (const binding of bindings) {
+            const laneId = extractLaneId(binding?.lane);
+            if (laneId)
+                laneIds.add(laneId);
+        }
+    }
+    const profiles = config.topology?.profiles;
+    if (profiles && typeof profiles === "object") {
+        for (const profile of Object.values(profiles)) {
+            const servedLanes = profile?.serve;
+            if (!Array.isArray(servedLanes))
+                continue;
+            for (const servedLane of servedLanes) {
+                const laneId = extractLaneId(servedLane);
+                if (laneId)
+                    laneIds.add(laneId);
+            }
+        }
+    }
+    return laneIds;
+}
+function collectRpcLaneIdsFromResourceConfig(resourceConfig) {
+    const config = parseRpcLanesResourceConfig(resourceConfig);
+    return collectRpcLaneIds(config);
+}
+function getRpcLaneBindings(config) {
+    const bindings = config?.topology?.bindings;
+    if (!Array.isArray(bindings))
+        return [];
+    return bindings.map((binding) => ({
+        laneId: extractLaneId(binding?.lane) ?? "unknown",
+        communicatorId: binding?.communicatorId ?? extractCommunicatorId(binding?.communicator),
+    }));
+}
+function getRpcLaneProfiles(config) {
+    const rawProfiles = config?.topology?.profiles;
+    if (!rawProfiles || typeof rawProfiles !== "object")
+        return [];
+    return Object.entries(rawProfiles).map(([profileId, profile]) => ({
+        profileId,
+        serveLaneIds: Array.isArray(profile?.serve)
+            ? profile.serve.map((lane) => extractLaneId(lane) ?? "unknown")
+            : [],
+        communicatorId: profile?.communicatorId ?? extractCommunicatorId(profile?.communicator),
+    }));
+}
+function collectRpcCommunicatorIds(config, bindings = getRpcLaneBindings(config), profiles = getRpcLaneProfiles(config)) {
+    const communicatorIds = new Set();
+    const topLevelCommunicator = extractCommunicatorId(config?.communicator);
+    if (topLevelCommunicator)
+        communicatorIds.add(topLevelCommunicator);
+    if (Array.isArray(config?.communicators)) {
+        for (const communicator of config.communicators) {
+            const communicatorId = extractCommunicatorId(communicator);
+            if (communicatorId)
+                communicatorIds.add(communicatorId);
+        }
+    }
+    for (const binding of bindings) {
+        if (binding.communicatorId)
+            communicatorIds.add(binding.communicatorId);
+    }
+    for (const profile of profiles) {
+        if (profile.communicatorId)
+            communicatorIds.add(profile.communicatorId);
+    }
+    return Array.from(communicatorIds);
+}
+//# sourceMappingURL=lane-resources.js.map

package/dist/utils/lane-resources.js.map

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

package/dist/utils/zod.js

@@ -17,6 +17,32 @@ function isZodSchema(value) {
 function isZ4(schema) {
     return "transformAsync" in schema;
 }
+function hasToJSONSchema(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.toJSONSchema === "function");
+}
+function isPromiseLike(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        typeof value.then === "function");
+}
+function stringifyJsonSchema(value) {
+    const stringified = JSON.stringify(value, null, 2);
+    return typeof stringified === "string" ? stringified : null;
+}
+function formatSchemaFromToJSONSchema(schema) {
+    try {
+        const jsonSchema = schema.toJSONSchema();
+        if (isPromiseLike(jsonSchema)) {
+            return null;
+        }
+        return stringifyJsonSchema(jsonSchema);
+    }
+    catch {
+        return null;
+    }
+}
 function formatZodSchemaNicely(schema) {
     try {
         const jsonSchema = isZ4(schema)
@@ -31,12 +57,19 @@ function formatZodSchemaNicely(schema) {
 }
 function formatSchemaIfZod(value) {
     try {
+        if (hasToJSONSchema(value)) {
+            const formatted = formatSchemaFromToJSONSchema(value);
+            if (formatted) {
+                return formatted;
+            }
+            // Had toJSONSchema but it failed/returned async — use generic fallback
+            return '{ "type": "object" }';
+        }
         if (isZodSchema(value)) {
             return formatZodSchemaNicely(value);
         }
-        else {
-            return '{ "type": "object" }';
-        }
+        // Not a recognized schema format — return null instead of a misleading fallback
+        return null;
     }
     catch {
         // ignore

package/dist/utils/zod.js.map

@@ -1 +1 @@
-{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":";;AAOA,kCAOC;AAMD,sDAWC;AAED,8CAWC;AAED,kEAMC;AAnDD,+BAAiC;AACjC,2DAAqD;AACrD,uEAAqE;AAIrE,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;IACjD,4DAA4D;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,MAAkB;IAC9B,OAAO,gBAAgB,IAAI,MAAM,CAAC;AACpC,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAkB;IACtD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAC,MAAE,CAAC,YAAY,CAAC,MAAa,CAAC;YAChC,CAAC,CAAC,IAAA,oCAAe,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,sBAAsB,CAAC;QAChC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,2BAA2B,CAC/C,gBAA2C;IAE3C,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO,IAAA,kDAAwB,EAAC,gBAAgB,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/utils/zod.ts"],"names":[],"mappings":";;AAWA,kCAOC;AA2CD,sDAWC;AAED,8CAqBC;AAED,kEAMC;AAtGD,+BAAiC;AACjC,2DAAqD;AACrD,uEAAqE;AAQrE,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;IACjD,4DAA4D;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,MAAkB;IAC9B,OAAO,gBAAgB,IAAI,MAAM,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAa,CAAC,YAAY,KAAK,UAAU,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA0B,CAAC,IAAI,KAAK,UAAU,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,4BAA4B,CACnC,MAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAEzC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAkB;IACtD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAC,MAAE,CAAC,YAAY,CAAC,MAAa,CAAC;YAChC,CAAC,CAAC,IAAA,oCAAe,EAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;QAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC;QACH,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,uEAAuE;YACvE,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAED,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,gFAAgF;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,KAAK,UAAU,2BAA2B,CAC/C,gBAA2C;IAE3C,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,OAAO,IAAA,kDAAwB,EAAC,gBAAgB,CAAC,CAAC;AACpD,CAAC"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const v = "5.1.0";
+declare const v = "6.0.0";
 export default v;

package/dist/version.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // Auto-generated by scripts/sync-version.ts. Do not edit manually.
-const v = "5.1.0";
+const v = "6.0.0";
 exports.default = v;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluelibs/runner-dev",
-  "version": "5.1.0",
+  "version": "6.0.0",
   "description": "BlueLibs Runner DevTools",
   "main": "dist/index.js",
   "repository": {
@@ -13,7 +13,7 @@
     "clean": "rm -rf dist",
     "cli": "ts-node --project config/ts/tsconfig.json src/cli.ts",
     "start": "node dist/main.js",
-    "dev": "npm run build && npm run start",
+    "dev": "ts-node-dev --project config/ts/tsconfig.json --respawn --transpile-only --watch src --watch scripts src/main.ts",
     "build:ui": "cd src/ui && vite build",
     "dev:ui": "cd src/ui && vite",
     "preview:ui": "cd src/ui && vite preview --port 5173",
@@ -38,7 +38,7 @@
     "demo:ping": "ENDPOINT=http://localhost:31337/graphql node dist/cli.js ping",
     "demo:query": "ENDPOINT=http://localhost:31337/graphql node dist/cli.js query 'query { tasks { id } }' --format pretty",
     "demo:overview": "ENDPOINT=http://localhost:31337/graphql node dist/cli.js overview --details 5",
-    "fetch:ai": "node scripts/fetch-runner-ai.js"
+    "sync:docs": "ts-node --project config/ts/tsconfig.json scripts/sync-docs.ts"
   },
   "bin": {
     "runner-dev": "dist/cli.js"
@@ -104,6 +104,7 @@
     "@adobe/jsonschema2md": "^8.0.5",
     "@apollo/server": "^5.0.0",
     "@as-integrations/express5": "^1.1.2",
+    "@bluelibs/runner": "^6.0.0",
     "@bluelibs/smart": "^2.2.1",
     "@modelcontextprotocol/sdk": "^1.17.2",
     "@types/prismjs": "^1.26.5",
@@ -117,9 +118,6 @@
     "zod": "3.25.76",
     "zod-to-json-schema": "^3.24.6"
   },
-  "peerDependencies": {
-    "@bluelibs/runner": "^5.3.0"
-  },
   "overrides": {
     "react": "18.3.1",
     "react-dom": "18.3.1",