@kb-labs/core-platform 1.0.0 → 1.2.0

package/dist/{snapshot-provider--COac4P-.d.ts → snapshot-provider-BeZmFkse.d.cts}

@@ -1,5 +1,4 @@
-import { L as LogRecord, a as LogQuery } from './artifacts-DrVnkLzu.js';
-import { I as ISQLDatabase } from './database-DGV6a1nj.js';
+import { L as LogRecord, a as LogQuery, W as ISQLDatabase } from './invoke-BzOIin5Z.cjs';
 
 /**
  * @module @kb-labs/core-platform/adapters/adapter-manifest
@@ -526,6 +525,15 @@ interface ILogPersistence {
         /** Storage size in bytes */
         sizeBytes: number;
     }>;
+    /**
+     * Delete logs matching specific levels older than specified timestamp.
+     * Allows per-level retention policies (e.g., keep errors longer than debug).
+     *
+     * @param levels - Log levels to delete (e.g., ['debug', 'trace'])
+     * @param beforeTimestamp - Delete logs before this timestamp (milliseconds)
+     * @returns Promise with number of deleted logs
+     */
+    deleteByLevelOlderThan?(levels: string[], beforeTimestamp: number): Promise<number>;
     /**
      * Close persistence adapter and flush pending writes.
      * Should be called during application shutdown.
@@ -534,6 +542,41 @@ interface ILogPersistence {
      */
     close?(): Promise<void>;
 }
+/**
+ * Log retention policy configuration.
+ * Controls automatic cleanup of old logs and database size limits.
+ *
+ * Defaults are applied when retention is omitted — logs are never unbounded.
+ */
+interface LogRetentionPolicy {
+    /**
+     * Max age for warn/error/fatal logs in milliseconds.
+     * @default 604800000 (7 days)
+     */
+    maxAge?: number;
+    /**
+     * Max age for debug/trace logs in milliseconds.
+     * Set to 0 to disable debug/trace persistence entirely.
+     * @default 3600000 (1 hour)
+     */
+    maxAgeDebug?: number;
+    /**
+     * Max age for info logs in milliseconds.
+     * @default 86400000 (24 hours)
+     */
+    maxAgeInfo?: number;
+    /**
+     * Maximum database size in bytes.
+     * When exceeded, oldest logs are deleted until size is under limit.
+     * @default 524288000 (500 MB)
+     */
+    maxSizeBytes?: number;
+    /**
+     * How often to run retention cleanup in milliseconds.
+     * @default 300000 (5 minutes)
+     */
+    cleanupIntervalMs?: number;
+}
 /**
  * Configuration for log persistence adapter.
  */
@@ -560,104 +603,11 @@ interface LogPersistenceConfig {
      * @default 5000 (5 seconds)
      */
     flushInterval?: number;
-}
-
-/**
- * @module @kb-labs/core-platform/adapters/execution
- * Execution backend interface (plugin execution layer).
- */
-/**
- * Execution backend interface.
- * Handles plugin execution (in-process, worker-pool, or remote).
- *
- * Implementations:
- * - InProcessBackend: Same process, no isolation (dev mode)
- * - WorkerPoolBackend: Worker pool with fault isolation (production)
- * - RemoteExecutionBackend: Remote executor service (Phase 3)
- */
-interface IExecutionBackend {
     /**
-     * Execute a plugin handler.
-     *
-     * @param request - Execution request with descriptor, pluginRoot, handlerRef
-     * @param options - Optional execution options (signal, etc.)
-     * @returns Execution result with data/error
+     * Retention policy for automatic log cleanup.
+     * Defaults are applied to prevent unbounded database growth.
      */
-    execute(request: ExecutionRequest, options?: ExecuteOptions): Promise<ExecutionResult>;
-    /**
-     * Shutdown execution backend gracefully.
-     * Closes worker pool, cleanup resources.
-     */
-    shutdown(): Promise<void>;
-}
-/**
- * Execution options (optional).
- */
-interface ExecuteOptions {
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-    /** Additional options */
-    [key: string]: unknown;
-}
-/**
- * Execution request - minimal interface for core-platform.
- * Full implementation in @kb-labs/plugin-execution.
- */
-interface ExecutionRequest {
-    /** Unique execution ID */
-    executionId: string;
-    /**
-     * Runtime descriptor containing execution context.
-     *
-     * Type is `any` to allow implementations to use their concrete descriptor types
-     * (e.g., PluginContextDescriptor from @kb-labs/plugin-contracts).
-     *
-     * This is intentional for interface contracts - concrete type determined by implementation.
-     */
-    descriptor: any;
-    /** Plugin root directory (absolute path) */
-    pluginRoot: string;
-    /** Handler reference (relative path) */
-    handlerRef: string;
-    /** Input data passed to handler */
-    input: unknown;
-    /** Execution timeout in milliseconds */
-    timeoutMs?: number;
-    /** Optional execution target affinity */
-    target?: {
-        environmentId?: string;
-        workspaceId?: string;
-        namespace?: string;
-        workdir?: string;
-    };
-    /** Additional configuration */
-    [key: string]: unknown;
-}
-/**
- * Execution result - minimal interface for core-platform.
- * Full implementation in @kb-labs/plugin-execution.
- */
-interface ExecutionResult {
-    /** Success flag */
-    ok: boolean;
-    /** Result data (if ok) */
-    data?: unknown;
-    /**
-     * Error details (if !ok).
-     * Type is `any` to allow implementations to use their own error types.
-     * Expected to have at least { message: string } structure.
-     */
-    error?: any;
-    /** Execution time in milliseconds */
-    executionTimeMs: number;
-    /**
-     * Execution metadata (optional).
-     * Contains backend-specific info, timing, plugin info.
-     * Type is `any` to allow implementations to extend with their own metadata types.
-     */
-    metadata?: any;
-    /** Additional fields allowed for extensibility */
-    [key: string]: unknown;
+    retention?: LogRetentionPolicy;
 }
 
 /**
@@ -920,4 +870,4 @@ interface ISnapshotProvider {
     getCapabilities?(): SnapshotProviderCapabilities;
 }
 
-export type { AdapterManifest as A, RestoreSnapshotResult as B, CreateEnvironmentRequest as C, SnapshotStatusResult as D, ExecutionRequest as E, SnapshotGarbageCollectRequest as F, SnapshotGarbageCollectResult as G, SnapshotProviderCapabilities as H, ILogPersistence as I, LogPersistenceConfig as L, MaterializeWorkspaceRequest as M, RestoreSnapshotRequest as R, SnapshotStatus as S, WorkspaceStatus as W, AdapterType as a, AdapterDependency as b, AdapterExtension as c, AdapterCapabilities as d, AdapterFactory as e, IExecutionBackend as f, ExecutionResult as g, ExecuteOptions as h, IEnvironmentProvider as i, EnvironmentStatus as j, EnvironmentResources as k, EnvironmentLease as l, EnvironmentEndpoint as m, EnvironmentDescriptor as n, EnvironmentStatusResult as o, EnvironmentProviderCapabilities as p, IWorkspaceProvider as q, WorkspaceMount as r, WorkspaceDescriptor as s, AttachWorkspaceRequest as t, WorkspaceAttachment as u, WorkspaceStatusResult as v, WorkspaceProviderCapabilities as w, ISnapshotProvider as x, CaptureSnapshotRequest as y, SnapshotDescriptor as z };
+export type { AdapterManifest as A, SnapshotGarbageCollectResult as B, CreateEnvironmentRequest as C, SnapshotProviderCapabilities as D, EnvironmentStatus as E, ILogPersistence as I, LogPersistenceConfig as L, MaterializeWorkspaceRequest as M, RestoreSnapshotRequest as R, SnapshotStatus as S, WorkspaceStatus as W, AdapterType as a, AdapterDependency as b, AdapterExtension as c, AdapterCapabilities as d, AdapterFactory as e, LogRetentionPolicy as f, IEnvironmentProvider as g, EnvironmentResources as h, EnvironmentLease as i, EnvironmentEndpoint as j, EnvironmentDescriptor as k, EnvironmentStatusResult as l, EnvironmentProviderCapabilities as m, IWorkspaceProvider as n, WorkspaceMount as o, WorkspaceDescriptor as p, AttachWorkspaceRequest as q, WorkspaceAttachment as r, WorkspaceStatusResult as s, WorkspaceProviderCapabilities as t, ISnapshotProvider as u, CaptureSnapshotRequest as v, SnapshotDescriptor as w, RestoreSnapshotResult as x, SnapshotStatusResult as y, SnapshotGarbageCollectRequest as z };

package/dist/{snapshot-provider-nE9wuc1C.d.cts → snapshot-provider-CNO_x3lV.d.ts}

@@ -1,5 +1,4 @@
-import { L as LogRecord, a as LogQuery } from './artifacts-DrVnkLzu.cjs';
-import { I as ISQLDatabase } from './database-DGV6a1nj.cjs';
+import { L as LogRecord, a as LogQuery, W as ISQLDatabase } from './invoke-BzOIin5Z.js';
 
 /**
  * @module @kb-labs/core-platform/adapters/adapter-manifest
@@ -526,6 +525,15 @@ interface ILogPersistence {
         /** Storage size in bytes */
         sizeBytes: number;
     }>;
+    /**
+     * Delete logs matching specific levels older than specified timestamp.
+     * Allows per-level retention policies (e.g., keep errors longer than debug).
+     *
+     * @param levels - Log levels to delete (e.g., ['debug', 'trace'])
+     * @param beforeTimestamp - Delete logs before this timestamp (milliseconds)
+     * @returns Promise with number of deleted logs
+     */
+    deleteByLevelOlderThan?(levels: string[], beforeTimestamp: number): Promise<number>;
     /**
      * Close persistence adapter and flush pending writes.
      * Should be called during application shutdown.
@@ -534,6 +542,41 @@ interface ILogPersistence {
      */
     close?(): Promise<void>;
 }
+/**
+ * Log retention policy configuration.
+ * Controls automatic cleanup of old logs and database size limits.
+ *
+ * Defaults are applied when retention is omitted — logs are never unbounded.
+ */
+interface LogRetentionPolicy {
+    /**
+     * Max age for warn/error/fatal logs in milliseconds.
+     * @default 604800000 (7 days)
+     */
+    maxAge?: number;
+    /**
+     * Max age for debug/trace logs in milliseconds.
+     * Set to 0 to disable debug/trace persistence entirely.
+     * @default 3600000 (1 hour)
+     */
+    maxAgeDebug?: number;
+    /**
+     * Max age for info logs in milliseconds.
+     * @default 86400000 (24 hours)
+     */
+    maxAgeInfo?: number;
+    /**
+     * Maximum database size in bytes.
+     * When exceeded, oldest logs are deleted until size is under limit.
+     * @default 524288000 (500 MB)
+     */
+    maxSizeBytes?: number;
+    /**
+     * How often to run retention cleanup in milliseconds.
+     * @default 300000 (5 minutes)
+     */
+    cleanupIntervalMs?: number;
+}
 /**
  * Configuration for log persistence adapter.
  */
@@ -560,104 +603,11 @@ interface LogPersistenceConfig {
      * @default 5000 (5 seconds)
      */
     flushInterval?: number;
-}
-
-/**
- * @module @kb-labs/core-platform/adapters/execution
- * Execution backend interface (plugin execution layer).
- */
-/**
- * Execution backend interface.
- * Handles plugin execution (in-process, worker-pool, or remote).
- *
- * Implementations:
- * - InProcessBackend: Same process, no isolation (dev mode)
- * - WorkerPoolBackend: Worker pool with fault isolation (production)
- * - RemoteExecutionBackend: Remote executor service (Phase 3)
- */
-interface IExecutionBackend {
     /**
-     * Execute a plugin handler.
-     *
-     * @param request - Execution request with descriptor, pluginRoot, handlerRef
-     * @param options - Optional execution options (signal, etc.)
-     * @returns Execution result with data/error
+     * Retention policy for automatic log cleanup.
+     * Defaults are applied to prevent unbounded database growth.
      */
-    execute(request: ExecutionRequest, options?: ExecuteOptions): Promise<ExecutionResult>;
-    /**
-     * Shutdown execution backend gracefully.
-     * Closes worker pool, cleanup resources.
-     */
-    shutdown(): Promise<void>;
-}
-/**
- * Execution options (optional).
- */
-interface ExecuteOptions {
-    /** Abort signal for cancellation */
-    signal?: AbortSignal;
-    /** Additional options */
-    [key: string]: unknown;
-}
-/**
- * Execution request - minimal interface for core-platform.
- * Full implementation in @kb-labs/plugin-execution.
- */
-interface ExecutionRequest {
-    /** Unique execution ID */
-    executionId: string;
-    /**
-     * Runtime descriptor containing execution context.
-     *
-     * Type is `any` to allow implementations to use their concrete descriptor types
-     * (e.g., PluginContextDescriptor from @kb-labs/plugin-contracts).
-     *
-     * This is intentional for interface contracts - concrete type determined by implementation.
-     */
-    descriptor: any;
-    /** Plugin root directory (absolute path) */
-    pluginRoot: string;
-    /** Handler reference (relative path) */
-    handlerRef: string;
-    /** Input data passed to handler */
-    input: unknown;
-    /** Execution timeout in milliseconds */
-    timeoutMs?: number;
-    /** Optional execution target affinity */
-    target?: {
-        environmentId?: string;
-        workspaceId?: string;
-        namespace?: string;
-        workdir?: string;
-    };
-    /** Additional configuration */
-    [key: string]: unknown;
-}
-/**
- * Execution result - minimal interface for core-platform.
- * Full implementation in @kb-labs/plugin-execution.
- */
-interface ExecutionResult {
-    /** Success flag */
-    ok: boolean;
-    /** Result data (if ok) */
-    data?: unknown;
-    /**
-     * Error details (if !ok).
-     * Type is `any` to allow implementations to use their own error types.
-     * Expected to have at least { message: string } structure.
-     */
-    error?: any;
-    /** Execution time in milliseconds */
-    executionTimeMs: number;
-    /**
-     * Execution metadata (optional).
-     * Contains backend-specific info, timing, plugin info.
-     * Type is `any` to allow implementations to extend with their own metadata types.
-     */
-    metadata?: any;
-    /** Additional fields allowed for extensibility */
-    [key: string]: unknown;
+    retention?: LogRetentionPolicy;
 }
 
 /**
@@ -920,4 +870,4 @@ interface ISnapshotProvider {
     getCapabilities?(): SnapshotProviderCapabilities;
 }
 
-export type { AdapterManifest as A, RestoreSnapshotResult as B, CreateEnvironmentRequest as C, SnapshotStatusResult as D, ExecutionRequest as E, SnapshotGarbageCollectRequest as F, SnapshotGarbageCollectResult as G, SnapshotProviderCapabilities as H, ILogPersistence as I, LogPersistenceConfig as L, MaterializeWorkspaceRequest as M, RestoreSnapshotRequest as R, SnapshotStatus as S, WorkspaceStatus as W, AdapterType as a, AdapterDependency as b, AdapterExtension as c, AdapterCapabilities as d, AdapterFactory as e, IExecutionBackend as f, ExecutionResult as g, ExecuteOptions as h, IEnvironmentProvider as i, EnvironmentStatus as j, EnvironmentResources as k, EnvironmentLease as l, EnvironmentEndpoint as m, EnvironmentDescriptor as n, EnvironmentStatusResult as o, EnvironmentProviderCapabilities as p, IWorkspaceProvider as q, WorkspaceMount as r, WorkspaceDescriptor as s, AttachWorkspaceRequest as t, WorkspaceAttachment as u, WorkspaceStatusResult as v, WorkspaceProviderCapabilities as w, ISnapshotProvider as x, CaptureSnapshotRequest as y, SnapshotDescriptor as z };
+export type { AdapterManifest as A, SnapshotGarbageCollectResult as B, CreateEnvironmentRequest as C, SnapshotProviderCapabilities as D, EnvironmentStatus as E, ILogPersistence as I, LogPersistenceConfig as L, MaterializeWorkspaceRequest as M, RestoreSnapshotRequest as R, SnapshotStatus as S, WorkspaceStatus as W, AdapterType as a, AdapterDependency as b, AdapterExtension as c, AdapterCapabilities as d, AdapterFactory as e, LogRetentionPolicy as f, IEnvironmentProvider as g, EnvironmentResources as h, EnvironmentLease as i, EnvironmentEndpoint as j, EnvironmentDescriptor as k, EnvironmentStatusResult as l, EnvironmentProviderCapabilities as m, IWorkspaceProvider as n, WorkspaceMount as o, WorkspaceDescriptor as p, AttachWorkspaceRequest as q, WorkspaceAttachment as r, WorkspaceStatusResult as s, WorkspaceProviderCapabilities as t, ISnapshotProvider as u, CaptureSnapshotRequest as v, SnapshotDescriptor as w, RestoreSnapshotResult as x, SnapshotStatusResult as y, SnapshotGarbageCollectRequest as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kb-labs/core-platform",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Pure abstractions for KB Labs platform with minimal dependencies.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -46,6 +46,17 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix",
+    "type-check": "tsc --noEmit"
+  },
   "dependencies": {
     "ulid": "^2.3.0"
   },
@@ -54,7 +65,7 @@
     "typescript": "^5.6.3",
     "rimraf": "^6.0.1",
     "vitest": "^3.2.4",
-    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "@kb-labs/devkit": "^1.0.0",
     "@types/node": "^24.3.3"
   },
   "keywords": [
@@ -77,16 +88,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "clean": "rimraf dist",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run --passWithNoTests",
-    "test:watch": "vitest",
-    "dev": "tsup --config tsup.config.ts --watch",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint . --fix",
-    "type-check": "tsc --noEmit"
   }
-}
+}