@cyanautomation/kaseki-agent 1.4.1

package/dist/idempotency-store.d.ts

@@ -0,0 +1,61 @@
+import { RunResponse } from './kaseki-api-types';
+export type ClaimResult = {
+    kind: 'claimed';
+} | {
+    kind: 'pending';
+} | {
+    kind: 'fulfilled';
+    response: RunResponse;
+};
+/**
+ * Idempotency store manages request deduplication with persistent storage.
+ * Ensures safe retries: same idempotency key always returns the same job ID.
+ */
+export declare class IdempotencyStore {
+    private cache;
+    private persistencePath;
+    private lockPath;
+    private logger;
+    private ttlHours;
+    private cleanupInterval;
+    private lastReadPosition;
+    private readRemainder;
+    constructor(resultsDir: string, ttlHours?: number);
+    /**
+     * Check if idempotency key has been seen before and return cached response.
+     */
+    claimOrGet(idempotencyKey: string, requestFingerprint: string): ClaimResult;
+    /**
+     * Store a new idempotency entry.
+     */
+    storeResponse(idempotencyKey: string, response: RunResponse, requestFingerprint: string): void;
+    private withLock;
+    private acquireLock;
+    private releaseLock;
+    private sleepSync;
+    /**
+     * Persist a single entry to disk (append-only log).
+     */
+    private persistToDisk;
+    /**
+     * Load idempotency entries from disk.
+     */
+    private loadFromDisk;
+    /**
+     * Start periodic cleanup of expired entries.
+     */
+    private startCleanup;
+    /**
+     * Clean up expired entries and rewrite the log file.
+     */
+    private cleanup;
+    /**
+     * Get current cache size.
+     */
+    getSize(): number;
+    /**
+     * Gracefully shutdown the store.
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=idempotency-store.d.ts.map

package/dist/idempotency-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-store.d.ts","sourceRoot":"","sources":["../src/idempotency-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA4BjD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAM;gBAEf,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW;IASrD;;OAEG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,WAAW;IA0C3E;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI;IAiC9F,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IA+EpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,OAAO;IA4Cf;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAajB"}

package/dist/idempotency-store.js

@@ -0,0 +1,321 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { createEventLogger } from './logger.js';
+/**
+ * Idempotency store manages request deduplication with persistent storage.
+ * Ensures safe retries: same idempotency key always returns the same job ID.
+ */
+export class IdempotencyStore {
+    cache = new Map();
+    persistencePath;
+    lockPath;
+    logger;
+    ttlHours;
+    cleanupInterval = null;
+    lastReadPosition = 0;
+    readRemainder = '';
+    constructor(resultsDir, ttlHours = 24) {
+        this.persistencePath = path.join(resultsDir, '.kaseki-api-idempotency.jsonl');
+        this.lockPath = path.join(resultsDir, '.kaseki-api-idempotency.lock');
+        this.logger = createEventLogger('idempotency-store');
+        this.ttlHours = ttlHours;
+        this.loadFromDisk();
+        this.startCleanup();
+    }
+    /**
+     * Check if idempotency key has been seen before and return cached response.
+     */
+    claimOrGet(idempotencyKey, requestFingerprint) {
+        return this.withLock(() => {
+            this.loadFromDisk();
+            const entry = this.cache.get(idempotencyKey);
+            if (!entry || Date.now() > entry.expiresAt) {
+                const pendingEntry = {
+                    idempotencyKey,
+                    requestFingerprint,
+                    state: 'pending',
+                    jobId: '',
+                    requestTime: new Date().toISOString(),
+                    responsePayload: {
+                        id: '',
+                        status: 'queued',
+                        createdAt: new Date().toISOString(),
+                    },
+                    expiresAt: Date.now() + this.ttlHours * 3600 * 1000,
+                };
+                this.cache.set(idempotencyKey, pendingEntry);
+                this.persistToDisk(pendingEntry);
+                return { kind: 'claimed' };
+            }
+            if (entry.requestFingerprint !== requestFingerprint) {
+                throw new Error('Idempotency key has already been used with a different request payload');
+            }
+            if (entry.state === 'pending') {
+                return { kind: 'pending' };
+            }
+            this.logger.event('idempotency_cache_hit', {
+                idempotencyKey,
+                jobId: entry.jobId,
+                ageSeconds: Math.round((Date.now() - new Date(entry.requestTime).getTime()) / 1000),
+            });
+            return { kind: 'fulfilled', response: entry.responsePayload };
+        });
+    }
+    /**
+     * Store a new idempotency entry.
+     */
+    storeResponse(idempotencyKey, response, requestFingerprint) {
+        this.withLock(() => {
+            this.loadFromDisk();
+            const existing = this.cache.get(idempotencyKey);
+            const entry = existing
+                ? {
+                    ...existing,
+                    requestFingerprint,
+                    state: 'fulfilled',
+                    jobId: response.id,
+                    responsePayload: response,
+                }
+                : {
+                    idempotencyKey,
+                    requestFingerprint,
+                    state: 'fulfilled',
+                    jobId: response.id,
+                    requestTime: new Date().toISOString(),
+                    responsePayload: response,
+                    expiresAt: Date.now() + this.ttlHours * 3600 * 1000,
+                };
+            this.cache.set(idempotencyKey, entry);
+            this.persistToDisk(entry);
+            this.logger.event('idempotency_cache_store', {
+                idempotencyKey,
+                jobId: response.id,
+                ttlHours: this.ttlHours,
+            });
+        });
+    }
+    withLock(fn) {
+        this.acquireLock();
+        try {
+            return fn();
+        }
+        finally {
+            this.releaseLock();
+        }
+    }
+    acquireLock() {
+        const maxRetries = 600; // 3 seconds total (600 * 5ms)
+        const staleThresholdMs = 30000; // 30 seconds
+        let retries = 0;
+        while (retries < maxRetries) {
+            try {
+                fs.mkdirSync(this.lockPath);
+                return;
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST') {
+                    throw error;
+                }
+                try {
+                    const stats = fs.statSync(this.lockPath);
+                    if (Date.now() - stats.mtimeMs > staleThresholdMs) {
+                        fs.rmdirSync(this.lockPath);
+                        continue;
+                    }
+                }
+                catch {
+                    // If stale-lock check/removal fails, proceed to retry sleep.
+                }
+                this.sleepSync(5);
+                retries++;
+            }
+        }
+        throw new Error('Failed to acquire lock after maximum retries');
+    }
+    releaseLock() {
+        try {
+            fs.rmdirSync(this.lockPath);
+        }
+        catch {
+            // Ignore lock release failures.
+        }
+    }
+    sleepSync(ms) {
+        const start = Date.now();
+        while (Date.now() - start < ms) {
+            // Busy wait
+        }
+    }
+    /**
+     * Persist a single entry to disk (append-only log).
+     */
+    persistToDisk(entry) {
+        try {
+            const line = JSON.stringify({
+                idempotencyKey: entry.idempotencyKey,
+                requestFingerprint: entry.requestFingerprint,
+                state: entry.state,
+                jobId: entry.jobId,
+                requestTime: entry.requestTime,
+                responsePayload: entry.responsePayload,
+                expiresAt: entry.expiresAt,
+            });
+            fs.appendFileSync(this.persistencePath, `${line}\n`, 'utf-8');
+        }
+        catch (error) {
+            this.logger.error('Failed to persist idempotency entry', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Load idempotency entries from disk.
+     */
+    loadFromDisk() {
+        try {
+            if (!fs.existsSync(this.persistencePath)) {
+                return;
+            }
+            const stats = fs.statSync(this.persistencePath);
+            if (stats.size < this.lastReadPosition) {
+                this.lastReadPosition = 0;
+                this.readRemainder = '';
+                this.cache.clear();
+            }
+            if (stats.size === this.lastReadPosition) {
+                return;
+            }
+            const fileDescriptor = fs.openSync(this.persistencePath, 'r');
+            let lines = [];
+            try {
+                const bytesToRead = stats.size - this.lastReadPosition;
+                const buffer = Buffer.alloc(bytesToRead);
+                fs.readSync(fileDescriptor, buffer, 0, bytesToRead, this.lastReadPosition);
+                this.lastReadPosition = stats.size;
+                const content = this.readRemainder + buffer.toString('utf-8');
+                lines = content.split('\n');
+                this.readRemainder = lines.pop() ?? '';
+            }
+            finally {
+                fs.closeSync(fileDescriptor);
+            }
+            for (const line of lines) {
+                if (!line.trim()) {
+                    continue;
+                }
+                try {
+                    const entry = JSON.parse(line);
+                    // Skip expired entries
+                    if (Date.now() > entry.expiresAt) {
+                        continue;
+                    }
+                    const requestTime = entry.requestTime || '1970-01-01T00:00:00.000Z';
+                    const jobId = entry.jobId || entry.responsePayload?.id || '';
+                    const restoredResponse = entry.responsePayload || {
+                        id: jobId,
+                        status: 'queued',
+                        createdAt: requestTime,
+                        requestId: entry.requestId,
+                        correlationId: entry.correlationId,
+                    };
+                    // Store in cache
+                    this.cache.set(entry.idempotencyKey, {
+                        idempotencyKey: entry.idempotencyKey,
+                        requestFingerprint: entry.requestFingerprint || '',
+                        state: entry.state || 'fulfilled',
+                        jobId,
+                        requestTime,
+                        responsePayload: restoredResponse,
+                        expiresAt: entry.expiresAt,
+                    });
+                }
+                catch {
+                    // Skip invalid JSON lines
+                }
+            }
+            this.logger.event('idempotency_loaded', {
+                entriesLoaded: this.cache.size,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to load idempotency store from disk', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Start periodic cleanup of expired entries.
+     */
+    startCleanup() {
+        if (this.cleanupInterval) {
+            return;
+        }
+        // Run cleanup every hour (but allow process to exit even if interval is pending)
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 3600000);
+        this.cleanupInterval.unref();
+    }
+    /**
+     * Clean up expired entries and rewrite the log file.
+     */
+    cleanup() {
+        try {
+            const now = Date.now();
+            let removedCount = 0;
+            // Remove expired entries from cache
+            for (const [key, entry] of this.cache.entries()) {
+                if (now > entry.expiresAt) {
+                    this.cache.delete(key);
+                    removedCount++;
+                }
+            }
+            // Rewrite persistence file with only valid entries
+            if (removedCount > 0) {
+                const validEntries = [];
+                for (const entry of this.cache.values()) {
+                    validEntries.push(JSON.stringify({
+                        idempotencyKey: entry.idempotencyKey,
+                        requestFingerprint: entry.requestFingerprint,
+                        state: entry.state,
+                        jobId: entry.jobId,
+                        requestTime: entry.requestTime,
+                        responsePayload: entry.responsePayload,
+                        expiresAt: entry.expiresAt,
+                    }));
+                }
+                fs.writeFileSync(this.persistencePath, validEntries.join('\n') + (validEntries.length > 0 ? '\n' : ''), 'utf-8');
+                this.logger.event('idempotency_cleanup', {
+                    removedEntries: removedCount,
+                    remainingEntries: this.cache.size,
+                });
+            }
+        }
+        catch (error) {
+            this.logger.error('Idempotency cleanup failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Get current cache size.
+     */
+    getSize() {
+        return this.cache.size;
+    }
+    /**
+     * Gracefully shutdown the store.
+     */
+    shutdown() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        // Run final cleanup
+        this.cleanup();
+        this.logger.event('idempotency_store_shutdown', {
+            entriesRemaining: this.cache.size,
+        });
+    }
+}
+//# sourceMappingURL=idempotency-store.js.map

package/dist/idempotency-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export { JobScheduler } from './job-scheduler';
+export { ResultCache } from './result-cache';
+export { WebhookManager } from './webhook-manager';
+export { KasekiApiConfig, validateApiKey, loadConfig } from './kaseki-api-config';
+export { createGracefulShutdown, assertSupportedNodeVersion } from './kaseki-api-service';
+export type { Job, RunRequest, RunResponse, StatusResponse, StructuredProgress, LogResponse, ArtifactResponse, RunsListResponse, ErrorResponse, ValidationResponse, PreflightCheck, PreflightResponse, AnalysisResponse, WebhookPayload, WebhookEventType, } from './kaseki-api-types';
+export { KasekiApiClient } from './kaseki-api-client';
+export { sendErrorResponse, buildStatusResponse, detectContentType } from './utils/response-helpers';
+export { isNonEmptyFile, isNonEmptyFile as fileIsNonEmpty, readFirstLine, readTailLines, commandOutput, fileExists, readFileContent, getFileStats, } from './utils/file-helpers';
+export { isString, isNumber, isBoolean, isRecord, isArray, isStringArray, isRecordArray, hasKeys, } from './utils/type-guards';
+export { decodeUtf8TailSafely, tailLogByLines, readTailBytes, } from './utils/utf8-helpers';
+export { getJobOrRespond } from './utils/route-helpers';
+export { jobLookupMiddleware } from './middleware/job-lookup';
+export { createJobSubmittedEvent, createJobStartedEvent, createJobCompletedEvent, createJobCancelledEvent, createJobFailedEvent, } from './utils/webhook-event-builder';
+export { HttpClientFactory } from './utils/http-client-factory';
+export type { HttpRequestOptions, RetryConfig } from './utils/http-client-factory';
+export { FailureArtifactWriter } from './utils/failure-artifact-writer';
+export type { CleanupResult } from './utils/failure-artifact-writer';
+export { StatusResponseBuilder } from './utils/status-response-builder';
+export { normalizeProgressEvent, toStructuredProgress, } from './utils/progress-normalizer';
+export { createStatusRoutes } from './routes/status-routes';
+export { createLogRoutes } from './routes/log-routes';
+export { createArtifactRoutes, readArtifactContent } from './routes/artifact-routes';
+export { createWebhookRoutes } from './routes/webhook-routes';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAG1F,YAAY,EACV,GAAG,EACH,UAAU,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EACL,cAAc,EACd,cAAc,IAAI,cAAc,EAChC,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+// Kaseki Agent TypeScript Entry Point
+// Public API exports for library users and service consumers
+// Services
+export { JobScheduler } from './job-scheduler.js';
+export { ResultCache } from './result-cache.js';
+export { WebhookManager } from './webhook-manager.js';
+// Configuration & Utilities
+export { validateApiKey, loadConfig } from './kaseki-api-config.js';
+export { createGracefulShutdown, assertSupportedNodeVersion } from './kaseki-api-service.js';
+// Client
+export { KasekiApiClient } from './kaseki-api-client.js';
+// Utilities (Phase 1 extractions)
+export { sendErrorResponse, buildStatusResponse, detectContentType } from './utils/response-helpers.js';
+export { isNonEmptyFile, isNonEmptyFile as fileIsNonEmpty, readFirstLine, readTailLines, commandOutput, fileExists, readFileContent, getFileStats, } from './utils/file-helpers.js';
+export { isString, isNumber, isBoolean, isRecord, isArray, isStringArray, isRecordArray, hasKeys, } from './utils/type-guards.js';
+export { decodeUtf8TailSafely, tailLogByLines, readTailBytes, } from './utils/utf8-helpers.js';
+export { getJobOrRespond } from './utils/route-helpers.js';
+export { jobLookupMiddleware } from './middleware/job-lookup.js';
+// Utilities (Phase 2 consolidations)
+export { createJobSubmittedEvent, createJobStartedEvent, createJobCompletedEvent, createJobCancelledEvent, createJobFailedEvent, } from './utils/webhook-event-builder.js';
+export { HttpClientFactory } from './utils/http-client-factory.js';
+// Utilities (Phase 3 refactoring)
+export { FailureArtifactWriter } from './utils/failure-artifact-writer.js';
+export { StatusResponseBuilder } from './utils/status-response-builder.js';
+export { normalizeProgressEvent, toStructuredProgress, } from './utils/progress-normalizer.js';
+// Route modules (Phase 3 refactoring)
+export { createStatusRoutes } from './routes/status-routes.js';
+export { createLogRoutes } from './routes/log-routes.js';
+export { createArtifactRoutes, readArtifactContent } from './routes/artifact-routes.js';
+export { createWebhookRoutes } from './routes/webhook-routes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,6DAA6D;AAE7D,WAAW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,4BAA4B;AAC5B,OAAO,EAAmB,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAqB1F,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrG,OAAO,EACL,cAAc,EACd,cAAc,IAAI,cAAc,EAChC,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,OAAO,EACP,aAAa,EACb,aAAa,EACb,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,qCAAqC;AACrC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,kCAAkC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AAErC,sCAAsC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/instance/InstanceManager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Instance Manager
+ *
+ * Handles kaseki instance lifecycle: naming, directories, metadata
+ */
+export interface InstanceMetadata {
+    id: string;
+    createdAt: string;
+    completedAt?: string;
+    status: 'running' | 'completed' | 'failed';
+    exitCode?: number;
+    model?: string;
+    provider?: string;
+    repoUrl?: string;
+    gitRef?: string;
+    stages?: {
+        [stageName: string]: {
+            startTime?: string;
+            endTime?: string;
+            exitCode?: number;
+            duration?: number;
+        };
+    };
+}
+export declare class InstanceManager {
+    private rootDir;
+    private instanceId;
+    constructor(rootDir?: string);
+    /**
+     * Generate or get next instance ID
+     */
+    getOrCreateInstanceId(): Promise<string>;
+    /**
+     * Get workspace directory path
+     */
+    getWorkspaceDir(): Promise<string>;
+    /**
+     * Get results directory path
+     */
+    getResultsDir(): Promise<string>;
+    /**
+     * Get cache directory path
+     */
+    getCacheDir(): string;
+    /**
+     * Create instance directories
+     */
+    createDirectories(): Promise<{
+        workspace: string;
+        results: string;
+    }>;
+    /**
+     * Initialize metadata file
+     */
+    initializeMetadata(metadata: Partial<InstanceMetadata>): Promise<void>;
+    /**
+     * Update metadata
+     */
+    updateMetadata(updates: Partial<InstanceMetadata>): Promise<void>;
+    /**
+     * Record stage timing
+     */
+    recordStage(stageName: string, exitCode?: number, startTime?: Date, endTime?: Date): Promise<void>;
+    /**
+     * Finalize instance metadata
+     */
+    finalize(exitCode: number): Promise<void>;
+    /**
+     * Get instance metadata
+     */
+    getMetadata(): Promise<InstanceMetadata | null>;
+    /**
+     * Clean up instance workspace (optional)
+     */
+    cleanup(keepWorkspace?: boolean): Promise<void>;
+    /**
+     * Get instance ID
+     */
+    getInstanceId(): string | null;
+}
+//# sourceMappingURL=InstanceManager.d.ts.map

package/dist/instance/InstanceManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceManager.d.ts","sourceRoot":"","sources":["../../src/instance/InstanceManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,CAAC,SAAS,EAAE,MAAM,GAAG;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;CACH;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,GAAE,MAAkB;IAIvC;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;IAiC9C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAe1E;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB5E;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCvE;;OAEG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,IAAI,EAChB,OAAO,CAAC,EAAE,IAAI,GACb,OAAO,CAAC,IAAI,CAAC;IA0ChB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAWrD;;OAEG;IACG,OAAO,CAAC,aAAa,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}