@cyanautomation/kaseki-agent 1.4.1

package/dist/utils/response-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/response-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAiB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,cAAc,CAqBjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/dist/utils/response-helpers.js

@@ -0,0 +1,78 @@
+import * as fs from 'fs';
+/**
+ * Send a standardized error response.
+ * Consolidates error response generation across all endpoints.
+ */
+export function sendErrorResponse(res, status, title, detail) {
+    const response = {
+        type: 'https://api.kaseki.local/errors#' + title.toLowerCase().replace(/\s+/g, '-'),
+        title,
+        status,
+        detail,
+    };
+    res.status(status).json(response);
+}
+/**
+ * Build a StatusResponse from job metadata.
+ * Consolidates StatusResponse construction logic used in multiple routes.
+ */
+export function buildStatusResponse(jobData) {
+    const response = {
+        id: jobData.id,
+        status: jobData.status,
+        correlationId: jobData.correlationId,
+        requestId: jobData.requestId,
+        resultDir: jobData.resultDir,
+    };
+    // Only include optional fields if they are not null
+    if (jobData.exitCode !== null && jobData.exitCode !== undefined) {
+        response.exitCode = jobData.exitCode;
+    }
+    if (jobData.failureClass !== null && jobData.failureClass !== undefined) {
+        response.failureClass = jobData.failureClass;
+    }
+    if (jobData.error !== null && jobData.error !== undefined) {
+        response.error = jobData.error;
+    }
+    return response;
+}
+/**
+ * Send a file response with appropriate headers for artifact delivery.
+ * Handles Content-Type detection and streaming.
+ */
+export function sendFileResponse(res, filePath, fileName, options) {
+    try {
+        const stat = fs.statSync(filePath);
+        const contentType = detectContentType(fileName);
+        res.setHeader('Content-Type', contentType);
+        res.setHeader('Content-Length', stat.size);
+        res.setHeader('Content-Disposition', `inline; filename="${fileName}"`);
+        if (options?.stream) {
+            const stream = fs.createReadStream(filePath);
+            stream.pipe(res);
+        }
+        else {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            res.send(content);
+        }
+    }
+    catch (error) {
+        sendErrorResponse(res, 500, 'Internal Server Error', `Failed to read file: ${fileName}`);
+    }
+}
+/**
+ * Detect Content-Type based on file extension.
+ * Used for artifact responses.
+ */
+export function detectContentType(fileName) {
+    if (fileName.endsWith('.json'))
+        return 'application/json';
+    if (fileName.endsWith('.md'))
+        return 'text/markdown';
+    if (fileName.endsWith('.jsonl'))
+        return 'application/x-jsonl';
+    if (fileName.endsWith('.diff'))
+        return 'text/plain';
+    return 'text/plain';
+}
+//# sourceMappingURL=response-helpers.js.map

package/dist/utils/response-helpers.js.map

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

package/dist/utils/route-helpers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Route helper utilities for common patterns across API routes.
+ */
+import { Response } from 'express';
+import { JobScheduler } from '../job-scheduler';
+import { Job } from '../kaseki-api-types';
+/**
+ * Extract and validate a job ID from a request, sending an error response if not found.
+ * Consolidates the pattern used across artifact, log, and status routes.
+ *
+ * @param scheduler Job scheduler instance
+ * @param jobId Job ID to look up
+ * @param res Express response object (for error responses)
+ * @returns Job object if found, null if error response already sent
+ */
+export declare function getJobOrRespond(scheduler: JobScheduler, jobId: string, res: Response): Job | null;
+//# sourceMappingURL=route-helpers.d.ts.map

package/dist/utils/route-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/route-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAG1C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,QAAQ,GACZ,GAAG,GAAG,IAAI,CAOZ"}

package/dist/utils/route-helpers.js

@@ -0,0 +1,22 @@
+/**
+ * Route helper utilities for common patterns across API routes.
+ */
+import { sendErrorResponse } from './response-helpers.js';
+/**
+ * Extract and validate a job ID from a request, sending an error response if not found.
+ * Consolidates the pattern used across artifact, log, and status routes.
+ *
+ * @param scheduler Job scheduler instance
+ * @param jobId Job ID to look up
+ * @param res Express response object (for error responses)
+ * @returns Job object if found, null if error response already sent
+ */
+export function getJobOrRespond(scheduler, jobId, res) {
+    const job = scheduler.getJob(jobId);
+    if (!job) {
+        sendErrorResponse(res, 404, 'Not Found', `Run not found: ${jobId}`);
+        return null;
+    }
+    return job;
+}
+//# sourceMappingURL=route-helpers.js.map

package/dist/utils/route-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-helpers.js","sourceRoot":"","sources":["../../src/utils/route-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAuB,EACvB,KAAa,EACb,GAAa;IAEb,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,kBAAkB,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/status-response-builder.d.ts

@@ -0,0 +1,23 @@
+import { Job } from '../kaseki-api-types';
+import { StatusResponse } from '../kaseki-api-types';
+import { KasekiApiConfig } from '../kaseki-api-config';
+import { JobScheduler } from '../job-scheduler';
+/**
+ * Builds StatusResponse objects with timing, progress, and artifact information.
+ * Encapsulates complex response building logic from status routes.
+ */
+export declare class StatusResponseBuilder {
+    private scheduler;
+    private config;
+    constructor(scheduler: JobScheduler, config: KasekiApiConfig);
+    /**
+     * Build a complete StatusResponse for a job.
+     */
+    buildStatus(job: Job): StatusResponse;
+    private addTimingInfo;
+    private addProgressInfo;
+    private addArtifactInfo;
+    private readMetadata;
+    private resolveExitCode;
+}
+//# sourceMappingURL=status-response-builder.d.ts.map

package/dist/utils/status-response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-response-builder.d.ts","sourceRoot":"","sources":["../../src/utils/status-response-builder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQhD;;;GAGG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;gBADN,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,eAAe;IAGjC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc;IA0BrC,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/utils/status-response-builder.js

@@ -0,0 +1,144 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { getRunArtifactMetadata } from '../run-artifact-metadata-cache.js';
+import { resolveInstanceExitCode, extractValidationFailureReason, extractQualityFailureReason } from '../instance-state-derivation.js';
+import { toStructuredProgress } from './progress-normalizer.js';
+import { readLastJsonlEvent } from './file-helpers.js';
+const STATUS_KEY_FILES = ['metadata.json', 'analysis.md', 'result-summary.md', 'failure.json', 'stderr.log'];
+/**
+ * Builds StatusResponse objects with timing, progress, and artifact information.
+ * Encapsulates complex response building logic from status routes.
+ */
+export class StatusResponseBuilder {
+    scheduler;
+    config;
+    constructor(scheduler, config) {
+        this.scheduler = scheduler;
+        this.config = config;
+    }
+    /**
+     * Build a complete StatusResponse for a job.
+     */
+    buildStatus(job) {
+        const runDir = job.resultDir || path.join(this.config.resultsDir, job.id);
+        const exitCode = this.resolveExitCode(job, runDir);
+        const metadata = this.readMetadata(runDir);
+        const validationReason = extractValidationFailureReason(metadata);
+        const qualityReason = extractQualityFailureReason(metadata);
+        const response = {
+            id: job.id,
+            status: job.status,
+            exitCode: exitCode ?? undefined,
+            failureClass: job.failureClass,
+            validationFailureReason: validationReason ?? undefined,
+            qualityFailureReason: qualityReason ?? undefined,
+            correlationId: job.correlationId,
+            requestId: job.requestId,
+            error: job.error,
+            resultDir: job.resultDir,
+        };
+        this.addTimingInfo(response, job);
+        this.addProgressInfo(response, job);
+        this.addArtifactInfo(response, job);
+        return response;
+    }
+    addTimingInfo(response, job) {
+        if (job.startedAt) {
+            const elapsed = (job.completedAt || new Date()).getTime() - job.startedAt.getTime();
+            response.elapsedSeconds = Math.round(elapsed / 1000);
+            const timeoutSeconds = job.effectiveTimeoutSeconds ?? this.config.agentTimeoutSeconds;
+            const timeoutMs = timeoutSeconds * 1000;
+            response.timeoutRiskPercent = Math.round((elapsed / timeoutMs) * 100);
+        }
+    }
+    addProgressInfo(response, job) {
+        if (job.status !== 'running') {
+            return;
+        }
+        try {
+            const progressFile = path.join(this.config.resultsDir, job.id, 'progress.jsonl');
+            const lastFileEvent = readLastJsonlEvent(progressFile);
+            if (lastFileEvent) {
+                const structuredProgress = toStructuredProgress(lastFileEvent);
+                if (structuredProgress) {
+                    response.progress = structuredProgress;
+                }
+                return;
+            }
+            if (typeof this.scheduler.getLiveProgressEvents === 'function') {
+                const liveEvents = this.scheduler.getLiveProgressEvents(job.id, 1);
+                const lastEvent = liveEvents[liveEvents.length - 1];
+                if (lastEvent) {
+                    const structuredProgress = toStructuredProgress(lastEvent, 'running');
+                    if (structuredProgress) {
+                        response.progress = structuredProgress;
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore progress file errors; status remains resilient
+        }
+    }
+    addArtifactInfo(response, job) {
+        if (!(job.status === 'completed' || job.status === 'failed')) {
+            return;
+        }
+        const runDir = job.resultDir || path.join(this.config.resultsDir, job.id);
+        const metadata = getRunArtifactMetadata(job.id, runDir, STATUS_KEY_FILES, true);
+        const keyFileAvailability = STATUS_KEY_FILES.reduce((acc, fileName) => {
+            acc[fileName] = metadata[fileName]?.exists === true && metadata[fileName].size > 0;
+            return acc;
+        }, {});
+        response.artifacts = {
+            metadataJson: keyFileAvailability['metadata.json'],
+            analysisMd: keyFileAvailability['analysis.md'],
+            resultSummaryMd: keyFileAvailability['result-summary.md'],
+            failureJson: keyFileAvailability['failure.json'],
+            stderrLog: keyFileAvailability['stderr.log'],
+            availableFiles: STATUS_KEY_FILES.filter((fileName) => keyFileAvailability[fileName]),
+        };
+        if (job.status === 'failed') {
+            if (keyFileAvailability['failure.json']) {
+                response.diagnosticEntryPoint = 'failure.json';
+            }
+            else if (keyFileAvailability['analysis.md']) {
+                response.diagnosticEntryPoint = 'analysis.md';
+            }
+            else if (keyFileAvailability['result-summary.md']) {
+                response.diagnosticEntryPoint = 'result-summary.md';
+            }
+        }
+    }
+    readMetadata(runDir) {
+        try {
+            const metadataPath = path.join(runDir, 'metadata.json');
+            if (fs.existsSync(metadataPath)) {
+                return JSON.parse(fs.readFileSync(metadataPath, 'utf-8'));
+            }
+        }
+        catch {
+            // Ignore metadata read errors
+        }
+        return {};
+    }
+    resolveExitCode(job, runDir) {
+        if (job.exitCode !== undefined && job.exitCode !== null) {
+            return job.exitCode;
+        }
+        if (!(job.status === 'completed' || job.status === 'failed')) {
+            return null;
+        }
+        try {
+            const metadataPath = path.join(runDir, 'metadata.json');
+            const metadata = fs.existsSync(metadataPath)
+                ? JSON.parse(fs.readFileSync(metadataPath, 'utf-8'))
+                : {};
+            return resolveInstanceExitCode(runDir, metadata);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=status-response-builder.js.map

package/dist/utils/status-response-builder.js.map

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

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Type guard utilities for common type checks.
+ * Reduces verbosity and provides reusable predicates across the codebase.
+ */
+/**
+ * Check if value is a string.
+ */
+export declare const isString: (value: unknown) => value is string;
+/**
+ * Check if value is a number.
+ */
+export declare const isNumber: (value: unknown) => value is number;
+/**
+ * Check if value is a boolean.
+ */
+export declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Check if value is a record (plain object).
+ */
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Check if value is an array.
+ */
+export declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * Check if value is an array of strings.
+ */
+export declare const isStringArray: (value: unknown) => value is string[];
+/**
+ * Check if value is an array of objects (records).
+ */
+export declare const isRecordArray: (value: unknown) => value is Record<string, unknown>[];
+/**
+ * Check if value is an object with specific keys (shallow validation).
+ */
+export declare const hasKeys: (value: unknown, ...keys: string[]) => value is Record<string, unknown>;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAmC,CAAC;AAEvF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAqC,CAAC;AAE1F;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAExE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,OAAO,EAA0B,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,EAE7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,EAAE,GAAG,MAAM,MAAM,EAAE,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAE1F,CAAC"}

package/dist/utils/type-guards.js

@@ -0,0 +1,45 @@
+/**
+ * Type guard utilities for common type checks.
+ * Reduces verbosity and provides reusable predicates across the codebase.
+ */
+/**
+ * Check if value is a string.
+ */
+export const isString = (value) => typeof value === 'string';
+/**
+ * Check if value is a number.
+ */
+export const isNumber = (value) => typeof value === 'number';
+/**
+ * Check if value is a boolean.
+ */
+export const isBoolean = (value) => typeof value === 'boolean';
+/**
+ * Check if value is a record (plain object).
+ */
+export const isRecord = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};
+/**
+ * Check if value is an array.
+ */
+export const isArray = (value) => Array.isArray(value);
+/**
+ * Check if value is an array of strings.
+ */
+export const isStringArray = (value) => {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+};
+/**
+ * Check if value is an array of objects (records).
+ */
+export const isRecordArray = (value) => {
+    return Array.isArray(value) && value.every((item) => isRecord(item));
+};
+/**
+ * Check if value is an object with specific keys (shallow validation).
+ */
+export const hasKeys = (value, ...keys) => {
+    return isRecord(value) && keys.every((key) => key in value);
+};
+//# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;AAEvF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAc,EAAoB,EAAE,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE;IAC3E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEpF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAqB,EAAE;IACjE,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAsC,EAAE;IAClF,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,GAAG,IAAc,EAAoC,EAAE;IAC7F,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/dist/utils/utf8-helpers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UTF-8 safe string encoding/decoding utilities.
+ * Handles proper UTF-8 sequence detection to prevent breaking multi-byte characters.
+ */
+/**
+ * Safely decode a buffer tail to UTF-8, avoiding partial UTF-8 sequences.
+ * If the buffer ends in the middle of a multi-byte UTF-8 sequence,
+ * the incomplete sequence is truncated.
+ *
+ * @param buffer Buffer to decode
+ * @returns UTF-8 string without incomplete sequences at the end
+ */
+export declare function decodeUtf8TailSafely(buffer: Buffer): string;
+/**
+ * Extract the last N lines from a string.
+ *
+ * @param content String content to extract from
+ * @param maxLines Maximum number of lines to return
+ * @returns Last N lines of the content (or entire content if fewer lines)
+ */
+export declare function tailLogByLines(content: string, maxLines: number): string;
+/**
+ * Read the tail bytes of a file into a buffer.
+ * Useful for reading last N bytes of a large file without loading entire file.
+ *
+ * @param logFile Path to the file
+ * @param size Total size of the file (from fs.statSync)
+ * @param maxSize Maximum bytes to read
+ * @returns Buffer containing the tail bytes
+ */
+export declare function readTailBytes(logFile: string, size: number, maxSize: number): Buffer;
+//# sourceMappingURL=utf8-helpers.d.ts.map

package/dist/utils/utf8-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utf8-helpers.d.ts","sourceRoot":"","sources":["../../src/utils/utf8-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUpF"}

package/dist/utils/utf8-helpers.js

@@ -0,0 +1,97 @@
+/**
+ * UTF-8 safe string encoding/decoding utilities.
+ * Handles proper UTF-8 sequence detection to prevent breaking multi-byte characters.
+ */
+import * as fs from 'fs';
+/**
+ * Check if a byte is a UTF-8 continuation byte.
+ * Continuation bytes have the pattern 10xxxxxx (0x80-0xBF).
+ */
+function isUtf8ContinuationByte(byte) {
+    return (byte & 0xc0) === 0x80;
+}
+/**
+ * Determine the expected length of a UTF-8 sequence from its leading byte.
+ */
+function utf8SequenceLength(leadingByte) {
+    if ((leadingByte & 0x80) === 0)
+        return 1; // Single-byte: 0xxxxxxx
+    if ((leadingByte & 0xe0) === 0xc0)
+        return 2; // Two-byte: 110xxxxx
+    if ((leadingByte & 0xf0) === 0xe0)
+        return 3; // Three-byte: 1110xxxx
+    if ((leadingByte & 0xf8) === 0xf0)
+        return 4; // Four-byte: 11110xxx
+    return 1; // Invalid; treat as single-byte
+}
+/**
+ * Safely decode a buffer tail to UTF-8, avoiding partial UTF-8 sequences.
+ * If the buffer ends in the middle of a multi-byte UTF-8 sequence,
+ * the incomplete sequence is truncated.
+ *
+ * @param buffer Buffer to decode
+ * @returns UTF-8 string without incomplete sequences at the end
+ */
+export function decodeUtf8TailSafely(buffer) {
+    let end = buffer.length;
+    if (end > 0) {
+        let continuationCount = 0;
+        let candidateLead = end - 1;
+        // Count continuation bytes at the end
+        while (candidateLead >= 0 && isUtf8ContinuationByte(buffer[candidateLead])) {
+            continuationCount++;
+            candidateLead--;
+        }
+        if (candidateLead < 0) {
+            // All bytes are continuation bytes; skip all
+            end = 0;
+        }
+        else {
+            const sequenceLength = utf8SequenceLength(buffer[candidateLead]);
+            const expectedContinuationCount = sequenceLength - 1;
+            // If the continuation byte count doesn't match the expected count, truncate
+            if (sequenceLength > 1 && continuationCount !== expectedContinuationCount) {
+                end = candidateLead;
+            }
+        }
+    }
+    return buffer.subarray(0, end).toString('utf-8');
+}
+/**
+ * Extract the last N lines from a string.
+ *
+ * @param content String content to extract from
+ * @param maxLines Maximum number of lines to return
+ * @returns Last N lines of the content (or entire content if fewer lines)
+ */
+export function tailLogByLines(content, maxLines) {
+    if (maxLines <= 0) {
+        return '';
+    }
+    const lines = content.split(/\r?\n/);
+    if (lines.length <= maxLines) {
+        return content;
+    }
+    return lines.slice(-maxLines).join('\n');
+}
+/**
+ * Read the tail bytes of a file into a buffer.
+ * Useful for reading last N bytes of a large file without loading entire file.
+ *
+ * @param logFile Path to the file
+ * @param size Total size of the file (from fs.statSync)
+ * @param maxSize Maximum bytes to read
+ * @returns Buffer containing the tail bytes
+ */
+export function readTailBytes(logFile, size, maxSize) {
+    const truncated = Buffer.alloc(maxSize);
+    const fd = fs.openSync(logFile, 'r');
+    try {
+        fs.readSync(fd, truncated, 0, maxSize, size - maxSize);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return truncated;
+}
+//# sourceMappingURL=utf8-helpers.js.map

package/dist/utils/utf8-helpers.js.map

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

package/dist/utils/webhook-event-builder.d.ts

@@ -0,0 +1,26 @@
+import { WebhookPayload } from '../kaseki-api-types';
+/**
+ * Factory functions for creating webhook event payloads.
+ * Consolidates webhook event creation logic across job-scheduler.ts.
+ */
+/**
+ * Create a JOB_SUBMITTED event payload.
+ */
+export declare function createJobSubmittedEvent(jobId: string): WebhookPayload;
+/**
+ * Create a JOB_STARTED event payload.
+ */
+export declare function createJobStartedEvent(jobId: string): WebhookPayload;
+/**
+ * Create a JOB_COMPLETED event payload.
+ */
+export declare function createJobCompletedEvent(jobId: string, exitCode?: number | null): WebhookPayload;
+/**
+ * Create a JOB_CANCELLED event payload.
+ */
+export declare function createJobCancelledEvent(jobId: string, error?: string): WebhookPayload;
+/**
+ * Create a JOB_FAILED event payload.
+ */
+export declare function createJobFailedEvent(jobId: string, failureClass?: string, error?: string, exitCode?: number): WebhookPayload;
+//# sourceMappingURL=webhook-event-builder.d.ts.map

package/dist/utils/webhook-event-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-event-builder.d.ts","sourceRoot":"","sources":["../../src/utils/webhook-event-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CASrE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAU/F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAWrF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAYhB"}