@kb-labs/core-runtime 1.0.0 → 1.2.0

package/dist/index.d.cts

@@ -1,6 +1,7 @@
-import { CreateEnvironmentRequest, EnvironmentDescriptor, EnvironmentStatusResult, EnvironmentLease, MaterializeWorkspaceRequest, WorkspaceDescriptor, AttachWorkspaceRequest, WorkspaceAttachment, WorkspaceStatusResult, WorkspaceProviderCapabilities, CaptureSnapshotRequest, SnapshotDescriptor, RestoreSnapshotRequest, RestoreSnapshotResult, SnapshotStatusResult, SnapshotGarbageCollectRequest, SnapshotGarbageCollectResult, SnapshotProviderCapabilities, IExecutionBackend, ExecutionRequest, ExecutionResult, CreateRunRequest, RunRecord, IAnalytics, IVectorStore, ILLM, IEmbeddings, ICache, IConfig, IStorage, ILogger, IEventBus, IInvoke, IArtifacts, ILogReader, IWorkflowEngine, IJobScheduler, ICronManager, IResourceManager, TenantQuotas, ResourceType, ResourceSlot, ResourceAvailability, JobDefinition, JobHandle, CronExpression, JobFilter, CronHandler, CronJob, WorkflowOptions, WorkflowRun, WorkflowFilter, VectorFilter, VectorSearchResult, VectorRecord, LLMOptions, LLMResponse, LLMProtocolCapabilities, LLMMessage, LLMToolCallOptions, LLMToolCallResponse } from '@kb-labs/core-platform';
+import { CreateEnvironmentRequest, EnvironmentDescriptor, EnvironmentStatusResult, EnvironmentLease, MaterializeWorkspaceRequest, WorkspaceDescriptor, AttachWorkspaceRequest, WorkspaceAttachment, WorkspaceStatusResult, WorkspaceProviderCapabilities, CaptureSnapshotRequest, SnapshotDescriptor, RestoreSnapshotRequest, RestoreSnapshotResult, SnapshotStatusResult, SnapshotGarbageCollectRequest, SnapshotGarbageCollectResult, SnapshotProviderCapabilities, CreateRunRequest, RunRecord, IAnalytics, IVectorStore, ILLM, IEmbeddings, ICache, IConfig, IStorage, ILogger, IEventBus, IInvoke, ILogReader, IWorkflowEngine, IJobScheduler, ICronManager, IResourceManager, TenantQuotas, ResourceType, ResourceSlot, ResourceAvailability, JobDefinition, JobHandle, CronExpression, JobFilter, CronHandler, CronJob, WorkflowOptions, WorkflowRun, WorkflowFilter, VectorFilter, VectorSearchResult, VectorRecord, LLMOptions, LLMResponse, LLMProtocolCapabilities, LLMMessage, LLMToolCallOptions, LLMToolCallResponse } from '@kb-labs/core-platform';
+import { IExecutionBackend, ExecutionRequest, ExecutionResult } from '@kb-labs/core-contracts';
+import { ISQLDatabase, IDocumentDatabase, AnalyticsContext, IStorage as IStorage$1, StorageMetadata, SQLQueryResult, SQLTransaction, BaseDocument, DocumentFilter, FindOptions, DocumentUpdate } from '@kb-labs/core-platform/adapters';
 import { IResourceBroker, RateLimitConfig, RateLimitPreset } from '@kb-labs/core-resource-broker';
-import { AnalyticsContext, IStorage as IStorage$1, StorageMetadata, ISQLDatabase, SQLQueryResult, SQLTransaction, IDocumentDatabase, BaseDocument, DocumentFilter, FindOptions, DocumentUpdate } from '@kb-labs/core-platform/adapters';
 export { BulkTransfer, BulkTransferHelper, BulkTransferOptions, CircuitOpenError, IPCServer, IPCTransport, ITransport, OPERATION_TIMEOUTS, PendingRequest, TimeoutError, TransportConfig, TransportError, UnixSocketConfig, UnixSocketServer, UnixSocketServerConfig, UnixSocketTransport, createIPCServer, createIPCTransport, createUnixSocketTransport, getOperationTimeout, isRetryableError, selectTimeout } from '@kb-labs/core-ipc';
 import { AdapterCall, AdapterResponse, AdapterType, AdapterCallContext } from '@kb-labs/core-platform/serializable';
 export { createNoOpPlatform } from '@kb-labs/core-platform/noop';
@@ -236,8 +237,24 @@ interface CoreAdapterTypes {
     logger: ILogger;
     eventBus: IEventBus;
     invoke: IInvoke;
-    artifacts: IArtifacts;
+    sqlDatabase: ISQLDatabase;
+    documentDatabase: IDocumentDatabase;
 }
+/**
+ * Names of all core adapters.
+ * Use this type instead of raw strings when referencing adapters —
+ * it stays in sync with CoreAdapterTypes automatically.
+ *
+ * @example
+ * ```typescript
+ * import type { CoreAdapterName } from '@kb-labs/core-runtime';
+ *
+ * function requiresLLM(name: CoreAdapterName) { ... }
+ * requiresLLM('llm');      // ✅
+ * requiresLLM('unknown');  // ❌ compile error
+ * ```
+ */
+type CoreAdapterName = keyof CoreAdapterTypes;
 /**
  * All adapter types (core + extensions).
  * Extensions can be any type, not known at compile time.
@@ -361,9 +378,22 @@ declare class PlatformContainer {
     emitLifecycleError(error: unknown, phase: PlatformLifecyclePhase, context?: Omit<PlatformLifecycleContext, 'phase'>): Promise<void>;
     /**
      * Check if a service is explicitly configured (not using fallback).
-     * @param service - Service name (e.g., 'llm', 'vectorStore', 'workflows')
-     * @returns true if service is configured, false if using NoOp/fallback
+     *
+     * @example
+     * ```typescript
+     * // Core adapter — type-safe, autocomplete works
+     * platform.isConfigured('llm');         // ✅
+     * platform.isConfigured('vectorStore'); // ✅
+     * platform.isConfigured('unknown');     // ❌ compile error
+     *
+     * // Extension adapter — generic string
+     * platform.isConfigured('myCustomAdapter'); // ✅ string overload
+     * ```
+     *
+     * @param service - Adapter/service name
+     * @returns true if explicitly configured, false if using NoOp/fallback
      */
+    isConfigured<K extends CoreAdapterName>(service: K): boolean;
     isConfigured(service: string): boolean;
     /**
      * Get list of all configured services (adapters + core features).
@@ -390,8 +420,10 @@ declare class PlatformContainer {
     get eventBus(): IEventBus;
     /** Inter-plugin invocation adapter (fallback: NoOpInvoke) */
     get invoke(): IInvoke;
-    /** Artifact storage adapter (fallback: MemoryArtifacts) */
-    get artifacts(): IArtifacts;
+    /** SQL database adapter (fallback: NoOpSQLDatabase — throws on use) */
+    get sqlDatabase(): ISQLDatabase;
+    /** Document database adapter (fallback: NoOpDocumentDatabase — throws on use) */
+    get documentDatabase(): IDocumentDatabase;
     private _logQueryService?;
     /**
      * Unified log query service.
@@ -2264,4 +2296,4 @@ declare function getDegradedStatus(options?: DegradedOptions): Promise<DegradedS
  */
 declare function startFullCycle(platform: Pick<PlatformContainer, 'runOrchestrator'>, request: StartFullCycleRequest): Promise<RunRecord>;
 
-export { type AdapterTypes, type AdaptersConfig, CacheProxy, type CoreAdapterTypes, type CoreFeaturesConfig, type CreateProxyPlatformOptions, CronManager, type DegradedLevel, type DegradedOptions, type DegradedStatus, type DiscoveredAdapter, DocumentDatabaseProxy, EmbeddingsProxy, EnvironmentManager, type ExecutionConfig, type JobHandler, JobScheduler, type JobSchedulerConfig, type JobsConfig, LLMProxy, type MonitoringOptions, type MonitoringSnapshot, type PlatformConfig, PlatformContainer, type PlatformLifecycleContext, type PlatformLifecycleHooks, type PlatformLifecyclePhase, RemoteAdapter, type ResourceBrokerConfig, ResourceManager, type ResourceManagerConfig, type ResourcesConfig, RunExecutor, RunOrchestrator, type RunStepExecutionRequest, SQLDatabaseProxy, SnapshotManager, type StartFullCycleRequest, StorageProxy, VectorStoreProxy, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineConfig, type WorkflowStepContext, type WorkflowStepDefinition, type WorkflowsConfig, WorkspaceManager, closeProxyPlatform, createAnalyticsContext, createCacheProxy, createDocumentDatabaseProxy, createProxyPlatform, createSQLDatabaseProxy, createStorageProxy, createVectorStoreProxy, discoverAdapters, getDegradedStatus, getMonitoringSnapshot, initPlatform, platform, resetPlatform, resolveAdapter, startFullCycle };
+export { type AdapterTypes, type AdaptersConfig, CacheProxy, type CoreAdapterName, type CoreAdapterTypes, type CoreFeaturesConfig, type CreateProxyPlatformOptions, CronManager, type DegradedLevel, type DegradedOptions, type DegradedStatus, type DiscoveredAdapter, DocumentDatabaseProxy, EmbeddingsProxy, EnvironmentManager, type ExecutionConfig, type JobHandler, JobScheduler, type JobSchedulerConfig, type JobsConfig, LLMProxy, type MonitoringOptions, type MonitoringSnapshot, type PlatformConfig, PlatformContainer, type PlatformLifecycleContext, type PlatformLifecycleHooks, type PlatformLifecyclePhase, RemoteAdapter, type ResourceBrokerConfig, ResourceManager, type ResourceManagerConfig, type ResourcesConfig, RunExecutor, RunOrchestrator, type RunStepExecutionRequest, SQLDatabaseProxy, SnapshotManager, type StartFullCycleRequest, StorageProxy, VectorStoreProxy, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineConfig, type WorkflowStepContext, type WorkflowStepDefinition, type WorkflowsConfig, WorkspaceManager, closeProxyPlatform, createAnalyticsContext, createCacheProxy, createDocumentDatabaseProxy, createProxyPlatform, createSQLDatabaseProxy, createStorageProxy, createVectorStoreProxy, discoverAdapters, getDegradedStatus, getMonitoringSnapshot, initPlatform, platform, resetPlatform, resolveAdapter, startFullCycle };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { CreateEnvironmentRequest, EnvironmentDescriptor, EnvironmentStatusResult, EnvironmentLease, MaterializeWorkspaceRequest, WorkspaceDescriptor, AttachWorkspaceRequest, WorkspaceAttachment, WorkspaceStatusResult, WorkspaceProviderCapabilities, CaptureSnapshotRequest, SnapshotDescriptor, RestoreSnapshotRequest, RestoreSnapshotResult, SnapshotStatusResult, SnapshotGarbageCollectRequest, SnapshotGarbageCollectResult, SnapshotProviderCapabilities, IExecutionBackend, ExecutionRequest, ExecutionResult, CreateRunRequest, RunRecord, IAnalytics, IVectorStore, ILLM, IEmbeddings, ICache, IConfig, IStorage, ILogger, IEventBus, IInvoke, IArtifacts, ILogReader, IWorkflowEngine, IJobScheduler, ICronManager, IResourceManager, TenantQuotas, ResourceType, ResourceSlot, ResourceAvailability, JobDefinition, JobHandle, CronExpression, JobFilter, CronHandler, CronJob, WorkflowOptions, WorkflowRun, WorkflowFilter, VectorFilter, VectorSearchResult, VectorRecord, LLMOptions, LLMResponse, LLMProtocolCapabilities, LLMMessage, LLMToolCallOptions, LLMToolCallResponse } from '@kb-labs/core-platform';
+import { CreateEnvironmentRequest, EnvironmentDescriptor, EnvironmentStatusResult, EnvironmentLease, MaterializeWorkspaceRequest, WorkspaceDescriptor, AttachWorkspaceRequest, WorkspaceAttachment, WorkspaceStatusResult, WorkspaceProviderCapabilities, CaptureSnapshotRequest, SnapshotDescriptor, RestoreSnapshotRequest, RestoreSnapshotResult, SnapshotStatusResult, SnapshotGarbageCollectRequest, SnapshotGarbageCollectResult, SnapshotProviderCapabilities, CreateRunRequest, RunRecord, IAnalytics, IVectorStore, ILLM, IEmbeddings, ICache, IConfig, IStorage, ILogger, IEventBus, IInvoke, ILogReader, IWorkflowEngine, IJobScheduler, ICronManager, IResourceManager, TenantQuotas, ResourceType, ResourceSlot, ResourceAvailability, JobDefinition, JobHandle, CronExpression, JobFilter, CronHandler, CronJob, WorkflowOptions, WorkflowRun, WorkflowFilter, VectorFilter, VectorSearchResult, VectorRecord, LLMOptions, LLMResponse, LLMProtocolCapabilities, LLMMessage, LLMToolCallOptions, LLMToolCallResponse } from '@kb-labs/core-platform';
+import { IExecutionBackend, ExecutionRequest, ExecutionResult } from '@kb-labs/core-contracts';
+import { ISQLDatabase, IDocumentDatabase, AnalyticsContext, IStorage as IStorage$1, StorageMetadata, SQLQueryResult, SQLTransaction, BaseDocument, DocumentFilter, FindOptions, DocumentUpdate } from '@kb-labs/core-platform/adapters';
 import { IResourceBroker, RateLimitConfig, RateLimitPreset } from '@kb-labs/core-resource-broker';
-import { AnalyticsContext, IStorage as IStorage$1, StorageMetadata, ISQLDatabase, SQLQueryResult, SQLTransaction, IDocumentDatabase, BaseDocument, DocumentFilter, FindOptions, DocumentUpdate } from '@kb-labs/core-platform/adapters';
 export { BulkTransfer, BulkTransferHelper, BulkTransferOptions, CircuitOpenError, IPCServer, IPCTransport, ITransport, OPERATION_TIMEOUTS, PendingRequest, TimeoutError, TransportConfig, TransportError, UnixSocketConfig, UnixSocketServer, UnixSocketServerConfig, UnixSocketTransport, createIPCServer, createIPCTransport, createUnixSocketTransport, getOperationTimeout, isRetryableError, selectTimeout } from '@kb-labs/core-ipc';
 import { AdapterCall, AdapterResponse, AdapterType, AdapterCallContext } from '@kb-labs/core-platform/serializable';
 export { createNoOpPlatform } from '@kb-labs/core-platform/noop';
@@ -236,8 +237,24 @@ interface CoreAdapterTypes {
     logger: ILogger;
     eventBus: IEventBus;
     invoke: IInvoke;
-    artifacts: IArtifacts;
+    sqlDatabase: ISQLDatabase;
+    documentDatabase: IDocumentDatabase;
 }
+/**
+ * Names of all core adapters.
+ * Use this type instead of raw strings when referencing adapters —
+ * it stays in sync with CoreAdapterTypes automatically.
+ *
+ * @example
+ * ```typescript
+ * import type { CoreAdapterName } from '@kb-labs/core-runtime';
+ *
+ * function requiresLLM(name: CoreAdapterName) { ... }
+ * requiresLLM('llm');      // ✅
+ * requiresLLM('unknown');  // ❌ compile error
+ * ```
+ */
+type CoreAdapterName = keyof CoreAdapterTypes;
 /**
  * All adapter types (core + extensions).
  * Extensions can be any type, not known at compile time.
@@ -361,9 +378,22 @@ declare class PlatformContainer {
     emitLifecycleError(error: unknown, phase: PlatformLifecyclePhase, context?: Omit<PlatformLifecycleContext, 'phase'>): Promise<void>;
     /**
      * Check if a service is explicitly configured (not using fallback).
-     * @param service - Service name (e.g., 'llm', 'vectorStore', 'workflows')
-     * @returns true if service is configured, false if using NoOp/fallback
+     *
+     * @example
+     * ```typescript
+     * // Core adapter — type-safe, autocomplete works
+     * platform.isConfigured('llm');         // ✅
+     * platform.isConfigured('vectorStore'); // ✅
+     * platform.isConfigured('unknown');     // ❌ compile error
+     *
+     * // Extension adapter — generic string
+     * platform.isConfigured('myCustomAdapter'); // ✅ string overload
+     * ```
+     *
+     * @param service - Adapter/service name
+     * @returns true if explicitly configured, false if using NoOp/fallback
      */
+    isConfigured<K extends CoreAdapterName>(service: K): boolean;
     isConfigured(service: string): boolean;
     /**
      * Get list of all configured services (adapters + core features).
@@ -390,8 +420,10 @@ declare class PlatformContainer {
     get eventBus(): IEventBus;
     /** Inter-plugin invocation adapter (fallback: NoOpInvoke) */
     get invoke(): IInvoke;
-    /** Artifact storage adapter (fallback: MemoryArtifacts) */
-    get artifacts(): IArtifacts;
+    /** SQL database adapter (fallback: NoOpSQLDatabase — throws on use) */
+    get sqlDatabase(): ISQLDatabase;
+    /** Document database adapter (fallback: NoOpDocumentDatabase — throws on use) */
+    get documentDatabase(): IDocumentDatabase;
     private _logQueryService?;
     /**
      * Unified log query service.
@@ -2264,4 +2296,4 @@ declare function getDegradedStatus(options?: DegradedOptions): Promise<DegradedS
  */
 declare function startFullCycle(platform: Pick<PlatformContainer, 'runOrchestrator'>, request: StartFullCycleRequest): Promise<RunRecord>;
 
-export { type AdapterTypes, type AdaptersConfig, CacheProxy, type CoreAdapterTypes, type CoreFeaturesConfig, type CreateProxyPlatformOptions, CronManager, type DegradedLevel, type DegradedOptions, type DegradedStatus, type DiscoveredAdapter, DocumentDatabaseProxy, EmbeddingsProxy, EnvironmentManager, type ExecutionConfig, type JobHandler, JobScheduler, type JobSchedulerConfig, type JobsConfig, LLMProxy, type MonitoringOptions, type MonitoringSnapshot, type PlatformConfig, PlatformContainer, type PlatformLifecycleContext, type PlatformLifecycleHooks, type PlatformLifecyclePhase, RemoteAdapter, type ResourceBrokerConfig, ResourceManager, type ResourceManagerConfig, type ResourcesConfig, RunExecutor, RunOrchestrator, type RunStepExecutionRequest, SQLDatabaseProxy, SnapshotManager, type StartFullCycleRequest, StorageProxy, VectorStoreProxy, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineConfig, type WorkflowStepContext, type WorkflowStepDefinition, type WorkflowsConfig, WorkspaceManager, closeProxyPlatform, createAnalyticsContext, createCacheProxy, createDocumentDatabaseProxy, createProxyPlatform, createSQLDatabaseProxy, createStorageProxy, createVectorStoreProxy, discoverAdapters, getDegradedStatus, getMonitoringSnapshot, initPlatform, platform, resetPlatform, resolveAdapter, startFullCycle };
+export { type AdapterTypes, type AdaptersConfig, CacheProxy, type CoreAdapterName, type CoreAdapterTypes, type CoreFeaturesConfig, type CreateProxyPlatformOptions, CronManager, type DegradedLevel, type DegradedOptions, type DegradedStatus, type DiscoveredAdapter, DocumentDatabaseProxy, EmbeddingsProxy, EnvironmentManager, type ExecutionConfig, type JobHandler, JobScheduler, type JobSchedulerConfig, type JobsConfig, LLMProxy, type MonitoringOptions, type MonitoringSnapshot, type PlatformConfig, PlatformContainer, type PlatformLifecycleContext, type PlatformLifecycleHooks, type PlatformLifecyclePhase, RemoteAdapter, type ResourceBrokerConfig, ResourceManager, type ResourceManagerConfig, type ResourcesConfig, RunExecutor, RunOrchestrator, type RunStepExecutionRequest, SQLDatabaseProxy, SnapshotManager, type StartFullCycleRequest, StorageProxy, VectorStoreProxy, type WorkflowDefinition, WorkflowEngine, type WorkflowEngineConfig, type WorkflowStepContext, type WorkflowStepDefinition, type WorkflowsConfig, WorkspaceManager, closeProxyPlatform, createAnalyticsContext, createCacheProxy, createDocumentDatabaseProxy, createProxyPlatform, createSQLDatabaseProxy, createStorageProxy, createVectorStoreProxy, discoverAdapters, getDegradedStatus, getMonitoringSnapshot, initPlatform, platform, resetPlatform, resolveAdapter, startFullCycle };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { NoOpAnalytics, MemoryVectorStore, MockLLM, MockEmbeddings, MemoryCache, NoOpConfig, MemoryStorage, ConsoleLogger, MemoryEventBus, NoOpInvoke, MemoryArtifacts, NoOpWorkflowEngine, NoOpJobScheduler, NoOpCronManager, NoOpResourceManager } from '@kb-labs/core-platform/noop';
+import { NoOpAnalytics, MemoryVectorStore, MockLLM, MockEmbeddings, MemoryCache, NoOpConfig, MemoryStorage, ConsoleLogger, MemoryEventBus, NoOpInvoke, NoOpSQLDatabase, NoOpDocumentDatabase, NoOpWorkflowEngine, NoOpJobScheduler, NoOpCronManager, NoOpResourceManager } from '@kb-labs/core-platform/noop';
 export { createNoOpPlatform } from '@kb-labs/core-platform/noop';
 import * as fs2 from 'fs';
 import { unlinkSync, promises } from 'fs';
@@ -342,11 +342,6 @@ var init_container = __esm({
           }
         }
       }
-      /**
-       * Check if a service is explicitly configured (not using fallback).
-       * @param service - Service name (e.g., 'llm', 'vectorStore', 'workflows')
-       * @returns true if service is configured, false if using NoOp/fallback
-       */
       isConfigured(service) {
         if (this.adapters.has(service)) {
           return true;
@@ -434,9 +429,13 @@ var init_container = __esm({
       get invoke() {
         return this.adapters.get("invoke") ?? new NoOpInvoke();
       }
-      /** Artifact storage adapter (fallback: MemoryArtifacts) */
-      get artifacts() {
-        return this.adapters.get("artifacts") ?? new MemoryArtifacts();
+      /** SQL database adapter (fallback: NoOpSQLDatabase — throws on use) */
+      get sqlDatabase() {
+        return this.adapters.get("sqlDatabase") ?? new NoOpSQLDatabase();
+      }
+      /** Document database adapter (fallback: NoOpDocumentDatabase — throws on use) */
+      get documentDatabase() {
+        return this.adapters.get("documentDatabase") ?? new NoOpDocumentDatabase();
       }
       // ═══════════════════════════════════════════════════════════════════════════
       // SERVICES (derived from adapters, lazy-initialized)
@@ -2204,11 +2203,9 @@ var init_unix_socket_server = __esm({
             return this.platform.eventBus;
           case "invoke":
             return this.platform.invoke;
-          case "artifacts":
-            return this.platform.artifacts;
           default:
             throw new Error(
-              `Unknown adapter: '${name}'. Valid adapters: vectorStore, cache, config, llm, embeddings, storage, logger, analytics, eventBus, invoke, artifacts`
+              `Unknown adapter: '${name}'. Valid adapters: vectorStore, cache, config, llm, embeddings, storage, logger, analytics, eventBus, invoke`
             );
         }
       }
@@ -2776,7 +2773,7 @@ var EnvironmentLeaseStore = class {
 var EnvironmentManager = class {
   constructor(platform2, options = {}) {
     this.platform = platform2;
-    const db = this.platform.getAdapter("db");
+    const db = this.platform.getAdapter("sqlDatabase");
     if (db) {
       this.store = new EnvironmentLeaseStore(db);
     }
@@ -3163,20 +3160,6 @@ var RunExecutor = class {
    */
   async executeStep(request) {
     const { runId, stepId, environmentId, execution } = request;
-    const descriptor = execution.descriptor && typeof execution.descriptor === "object" ? {
-      ...execution.descriptor,
-      run: {
-        runId,
-        stepId,
-        environmentId
-      }
-    } : {
-      run: {
-        runId,
-        stepId,
-        environmentId
-      }
-    };
     this.logger.debug("RunExecutor: executing step", {
       runId,
       stepId,
@@ -3187,7 +3170,14 @@ var RunExecutor = class {
     });
     return this.executionBackend.execute({
       ...execution,
-      descriptor
+      context: {
+        ...execution.context,
+        run: {
+          runId,
+          stepId,
+          environmentId
+        }
+      }
     });
   }
 };