@kici-dev/orchestrator 0.1.3 → 0.1.6

package/dist/sources/build-platform-sources.d.ts

@@ -0,0 +1,26 @@
+import type { AppConfig } from '../config.js';
+import type { SourceManager } from './source-manager.js';
+import type { ProviderSource } from '../entry-helpers.js';
+/** One active generic-webhook routing-key row (subset consumed here). */
+export interface GenericRoutingKeyRow {
+    routing_key: string;
+    provider_type: string;
+    name: string;
+    has_git_config: boolean;
+}
+/**
+ * Build the full provider-source list the orchestrator advertises to the
+ * Platform: GitHub-app sources from the {@link SourceManager} plus every
+ * *servable* generic-webhook source.
+ *
+ * Used both at boot and by the live republish closure (platform mode). It MUST
+ * return the complete set every time — a live source change re-sends the whole
+ * list via `platformClient.updateSources()`, which diffs against the previously
+ * sent set; a partial list would make the Platform deregister the sources that
+ * happened to be omitted.
+ *
+ * The generic-row loader is injected (rather than taking a `db`) so the merge
+ * logic is unit-testable without a live database.
+ */
+export declare function buildPlatformProviderSources(sourceManager: Pick<SourceManager, 'getSources'>, loadGenericRows: () => Promise<GenericRoutingKeyRow[]>, config: AppConfig): Promise<ProviderSource[]>;
+//# sourceMappingURL=build-platform-sources.d.ts.map

package/dist/sources/source-manager.d.ts

@@ -42,7 +42,21 @@ export declare class SourceManager {
     private currentSources;
     private debounceTimer;
     private readonly debounceMs;
+    /**
+     * Change callback. Stored in a mutable field (not read off `opts`) so a
+     * mode-specific hook can rewire it after construction — the platform-mode
+     * boot wires it to push the full source list to the Platform via
+     * `platformClient.updateSources()`. Defaults to the (possibly no-op) value
+     * passed at construction.
+     */
+    private onSourcesChanged;
     constructor(opts: SourceManagerOptions);
+    /**
+     * Replace the change callback after construction. The SourceManager is built
+     * early (before the Platform client exists); the platform-mode boot calls
+     * this once the client is ready so live source changes propagate upstream.
+     */
+    setOnSourcesChanged(cb: SourceManagerOptions['onSourcesChanged']): void;
     /** Get current ProviderRegistry (rebuilt on each reload). */
     getRegistry(): ProviderRegistry;
     /** Get current sources for Platform registration. */

package/dist/stale-detector/stale-run-detector.d.ts

@@ -18,7 +18,7 @@
 import { type Kysely } from 'kysely';
 import type { Database } from '../db/types.js';
 import type { ExecutionTracker } from '../reporting/execution-tracker.js';
-import type { CommitStatusReporter } from '../reporting/commit-status.js';
+import type { CheckRunReporter } from '../reporting/check-run-reporter.js';
 import type { ScalerManager } from '../scaler/manager.js';
 import type { Dispatcher } from '../agent/dispatcher.js';
 import type { AgentRegistry } from '../agent/registry.js';
@@ -26,7 +26,7 @@ import type { HeldRunStore } from '../environments/held-runs.js';
 export interface StaleRunDetectorDeps {
     db: Kysely<Database>;
     executionTracker: ExecutionTracker;
-    commitStatusReporter?: CommitStatusReporter;
+    checkRunReporter?: CheckRunReporter;
     scalerManager?: ScalerManager;
     dispatcher: Dispatcher;
     registry: AgentRegistry;
@@ -40,7 +40,7 @@ export interface StaleRunDetectorDeps {
 export declare class StaleRunDetector {
     private readonly db;
     private readonly executionTracker;
-    private readonly commitStatusReporter?;
+    private readonly checkRunReporter?;
     private readonly scalerManager?;
     private readonly dispatcher;
     private readonly registry;
@@ -96,8 +96,20 @@ export declare class StaleRunDetector {
     private scanStaleRunningJobsNullHeartbeat;
     /**
      * Sub-scan C: Find dispatched entries that were never acknowledged.
-     * Only checks 'dispatched' status (job sent to agent but agent never started it).
-     * 'queued' jobs are legitimately waiting for agents and handled by queue timeout instead.
+     *
+     * Only catches dispatches that the agent never started — i.e., the
+     * dispatch_queue row is still 'dispatched' AND there is no
+     * execution_jobs row in 'running' state. When the agent has reported
+     * the job as running (so execution_jobs.status='running'), heartbeat
+     * supervision falls to sub-scans A and B, which look at
+     * `execution_jobs.last_heartbeat_at`. Without this filter, a long
+     * job whose first step legitimately exceeds the dispatch threshold
+     * (e.g. an inline `npm install` for a workflow that imports
+     * `@kici-dev/sdk`) would be marked stale here before sub-scan A's
+     * heartbeat path has a chance to keep it alive.
+     *
+     * 'queued' jobs are legitimately waiting for agents and handled by
+     * the queue timeout in {@link JobQueue.markExpired} instead.
      */
     private scanStaleDispatchedJobs;
     /**