agentic-orchestrator 0.1.26 → 0.1.28

package/dist/apps/control-plane/core/configuration-service.js

@@ -0,0 +1,130 @@
+import path from 'node:path';
+import { pathExists } from './fs.js';
+import { loadAndValidateYaml } from './schemas.js';
+import { ERROR_CODES } from './error-codes.js';
+import { ensureAopRuntimeLayout } from './path-layout.js';
+import { loadComposedPolicy } from '../application/services/policy-loader-service.js';
+import { ACTIVITY_DETECTOR_SLOT, NOTIFICATION_CHANNEL_SLOT, SCM_PROVIDER_SLOT, globalAdapterRegistry, } from '../application/adapters/adapter-registry.js';
+import { ToolRegistryLoader } from '../mcp/tool-registry-loader.js';
+import { readStringField, readObjectField } from './utils/field-readers.js';
+import { readPositiveIntegerField } from './utils/field-readers.js';
+function validateAgentRuntimeTimeoutRelationships(agentsConfig) {
+    const runtime = readObjectField(agentsConfig, 'runtime');
+    if (Object.keys(runtime).length === 0) {
+        return;
+    }
+    const responseTimeoutMs = readPositiveIntegerField(runtime, 'worker_response_timeout_ms');
+    const spawnTimeoutMs = readPositiveIntegerField(runtime, 'worker_spawn_timeout_ms');
+    const idleTimeoutMs = readPositiveIntegerField(runtime, 'worker_idle_timeout_ms');
+    if (responseTimeoutMs != null && spawnTimeoutMs != null && spawnTimeoutMs >= responseTimeoutMs) {
+        throw new Error('invalid_agents_yaml:runtime.worker_spawn_timeout_ms must be less than runtime.worker_response_timeout_ms');
+    }
+    if (responseTimeoutMs != null && idleTimeoutMs != null && idleTimeoutMs > responseTimeoutMs) {
+        throw new Error('invalid_agents_yaml:runtime.worker_idle_timeout_ms must be less than or equal to runtime.worker_response_timeout_ms');
+    }
+}
+/**
+ * Handles loading and validation of all configuration files for the kernel.
+ *
+ * Extracts the load() body from AopKernel to keep the kernel focused on
+ * orchestration rather than configuration I/O.
+ */
+export class ConfigurationService {
+    repoRoot;
+    pathLayout;
+    schemaRegistry;
+    configOverrides;
+    constructor(repoRoot, pathLayout, schemaRegistry, configOverrides) {
+        this.repoRoot = repoRoot;
+        this.pathLayout = pathLayout;
+        this.schemaRegistry = schemaRegistry;
+        this.configOverrides = configOverrides;
+    }
+    async resolveDefaultConfigPath(fileName) {
+        const primary = path.join(this.pathLayout.orchestratorRoot, fileName);
+        if (await pathExists(primary)) {
+            return primary;
+        }
+        const legacy = path.join(this.pathLayout.legacyOrchestratorRoot, fileName);
+        if (await pathExists(legacy)) {
+            return legacy;
+        }
+        return primary;
+    }
+    async loadAll() {
+        await ensureAopRuntimeLayout(this.pathLayout);
+        const gatesPath = this.configOverrides.gatesPath ?? (await this.resolveDefaultConfigPath('gates.yaml'));
+        const policyPath = this.configOverrides.policyPath ?? (await this.resolveDefaultConfigPath('policy.yaml'));
+        const agentsPath = this.configOverrides.agentsPath ?? (await this.resolveDefaultConfigPath('agents.yaml'));
+        const adaptersPath = this.configOverrides.adaptersPath ?? (await this.resolveDefaultConfigPath('adapters.yaml'));
+        const gates = await loadAndValidateYaml(this.schemaRegistry, 'gates.schema.json', gatesPath);
+        if (!gates.validation.valid) {
+            throw new Error(`invalid_gates_yaml:${JSON.stringify(gates.validation.errors)}`);
+        }
+        const { mergedPolicy } = await loadComposedPolicy(this.repoRoot, policyPath, this.schemaRegistry);
+        const parsedPolicy = mergedPolicy;
+        const implementation = readObjectField(parsedPolicy, 'implementation');
+        const testing = readObjectField(parsedPolicy, 'testing');
+        if (readStringField(implementation, 'workspace') !== 'nx') {
+            throw new Error(ERROR_CODES.INVALID_WORKSPACE_IMPLEMENTATION);
+        }
+        if (readStringField(testing, 'framework') !== 'vitest') {
+            throw new Error(ERROR_CODES.INVALID_WORKSPACE_IMPLEMENTATION);
+        }
+        const agentsExists = await pathExists(agentsPath);
+        let agents = { parsed: { version: 1, roles: {} }, validation: { valid: true, errors: [] } };
+        if (agentsExists) {
+            agents = await loadAndValidateYaml(this.schemaRegistry, 'agents.schema.json', agentsPath);
+            if (!agents.validation.valid) {
+                throw new Error(`invalid_agents_yaml:${JSON.stringify(agents.validation.errors)}`);
+            }
+            validateAgentRuntimeTimeoutRelationships(agents.parsed);
+        }
+        const adaptersExists = await pathExists(adaptersPath);
+        let adapters = { parsed: {}, validation: { valid: true, errors: [] } };
+        if (adaptersExists) {
+            adapters = await loadAndValidateYaml(this.schemaRegistry, 'adapters.schema.json', adaptersPath);
+            if (!adapters.validation.valid) {
+                throw new Error(`invalid_adapters_yaml:${JSON.stringify(adapters.validation.errors)}`);
+            }
+            const parsedAdapters = readObjectField(adapters, 'parsed');
+            const notificationChannel = readStringField(parsedAdapters, NOTIFICATION_CHANNEL_SLOT.name);
+            if (notificationChannel) {
+                try {
+                    globalAdapterRegistry.resolve(NOTIFICATION_CHANNEL_SLOT, notificationChannel, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${NOTIFICATION_CHANNEL_SLOT.name}:${notificationChannel}`);
+                }
+            }
+            const activityDetector = readStringField(parsedAdapters, ACTIVITY_DETECTOR_SLOT.name);
+            if (activityDetector) {
+                try {
+                    globalAdapterRegistry.resolve(ACTIVITY_DETECTOR_SLOT, activityDetector, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${ACTIVITY_DETECTOR_SLOT.name}:${activityDetector}`);
+                }
+            }
+            const scmProvider = readStringField(parsedAdapters, SCM_PROVIDER_SLOT.name);
+            if (scmProvider) {
+                try {
+                    globalAdapterRegistry.resolve(SCM_PROVIDER_SLOT, scmProvider, {});
+                }
+                catch {
+                    throw new Error(`adapter_not_found:${SCM_PROVIDER_SLOT.name}:${scmProvider}`);
+                }
+            }
+        }
+        const registryLoader = new ToolRegistryLoader(this.repoRoot);
+        const toolRegistry = await registryLoader.load();
+        return {
+            gatesConfig: gates.parsed,
+            policy: parsedPolicy,
+            agentsConfig: agents.parsed,
+            adaptersConfig: readObjectField(adapters, 'parsed'),
+            toolRegistry,
+        };
+    }
+}
+//# sourceMappingURL=configuration-service.js.map

package/dist/apps/control-plane/core/configuration-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-service.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/configuration-service.ts"],"names":[],"mappings":"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"}

package/dist/apps/control-plane/core/kernel-tool-wiring.d.ts

@@ -0,0 +1,50 @@
+import type { ToolHandlerRegistry } from '../application/tools/tool-router.js';
+import type { FeatureDeleteResult } from '../application/services/feature-deletion-service.js';
+type AnyRecord = Record<string, any>;
+/**
+ * Minimal interface of kernel methods used by tool handlers.
+ * The kernel implements this interface; tool wiring only depends on it.
+ */
+export interface KernelToolFacade {
+    featureDiscoverSpecs(): Promise<unknown>;
+    featureInit(featureId: string | null): Promise<unknown>;
+    featureGetContext(featureId: string | null): Promise<unknown>;
+    featureStateGet(featureId: string | null): Promise<unknown>;
+    featureStatePatch(featureId: string | null, expectedVersion: number | null, patch: unknown): Promise<unknown>;
+    featureLogAppend(featureId: string | null, note: string | null, context: unknown): Promise<unknown>;
+    planSubmit(featureId: string | null, plan: unknown, expectedVersion: number | null): Promise<unknown>;
+    planGet(featureId: string | null): Promise<unknown>;
+    planUpdate(featureId: string | null, expectedPlanVersion: number | null, plan: unknown): Promise<unknown>;
+    repoEnsureWorktree(featureId: string | null): Promise<unknown>;
+    repoApplyPatch(featureId: string | null, unifiedDiff: string | null): Promise<unknown>;
+    repoStatus(featureId: string | null): Promise<unknown>;
+    repoDiff(featureId: string | null, options: string[]): Promise<unknown>;
+    repoReadFile(featureId: string | null, filePath: string | null): Promise<unknown>;
+    repoSearch(featureId: string | null, query: string | null): Promise<unknown>;
+    repoDiffBundle(featureId: string | null): Promise<unknown>;
+    featureReadyToMerge(featureId: string | null, commitMessage: string | null, mergeStrategy: string | null, userApprovalToken: string | null): Promise<unknown>;
+    featureDelete(featureId: string | null, dryRun: boolean | null, confirm: boolean | null, removeWorktree: boolean | null, removeBranch: string | null): Promise<FeatureDeleteResult>;
+    gatesList(profileName: string | null): Promise<unknown>;
+    gatesRun(featureId: string | null, profileName: string | null, mode: string | null): Promise<unknown>;
+    evidenceLatest(featureId: string | null): Promise<unknown>;
+    qaTestIndexGet(featureId: string | null): Promise<unknown>;
+    qaTestIndexUpdate(featureId: string | null, expectedVersion: number | null, updates: unknown, evidenceRefs: unknown[]): Promise<unknown>;
+    locksAcquire(resource: string | null, featureId: string | null, waitTimeoutSeconds: number | null): Promise<unknown>;
+    locksRelease(resource: string | null, featureId: string | null): Promise<unknown>;
+    collisionsScan(): Promise<unknown>;
+    reportDashboard(): Promise<unknown>;
+    reportFeatureSummary(featureId: string | null): Promise<unknown>;
+    featureSendMessage(featureId: string | null, message: string | null): Promise<unknown>;
+    costRecord(featureId: string, tokensDelta: number, costUsdDelta: number): Promise<unknown>;
+    costGet(featureId: string | null): Promise<unknown>;
+    performanceRecordOutcome(args: AnyRecord): Promise<unknown>;
+    performanceGetAnalytics(provider: string | null, model: string | null): Promise<unknown>;
+}
+/**
+ * Registers all MCP tool handlers on the given registry.
+ *
+ * Extracted from AopKernel.registerToolHandlers() to reduce kernel size.
+ * The kernel calls this during construction.
+ */
+export declare function registerKernelTools(toolHandlers: ToolHandlerRegistry, kernel: KernelToolFacade): void;
+export {};

package/dist/apps/control-plane/core/kernel-tool-wiring.js

@@ -0,0 +1,44 @@
+import { TOOLS } from './constants.js';
+import { readStringField, readNumberField, readBooleanField, asArray, } from './utils/field-readers.js';
+/**
+ * Registers all MCP tool handlers on the given registry.
+ *
+ * Extracted from AopKernel.registerToolHandlers() to reduce kernel size.
+ * The kernel calls this during construction.
+ */
+export function registerKernelTools(toolHandlers, kernel) {
+    toolHandlers.register(TOOLS.FEATURE_DISCOVER_SPECS, async () => kernel.featureDiscoverSpecs());
+    toolHandlers.register(TOOLS.FEATURE_INIT, async (args) => kernel.featureInit(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_GET_CONTEXT, async (args) => kernel.featureGetContext(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_STATE_GET, async (args) => kernel.featureStateGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_STATE_PATCH, async (args) => kernel.featureStatePatch(readStringField(args, 'feature_id'), readNumberField(args, 'expected_version'), args.patch));
+    toolHandlers.register(TOOLS.FEATURE_LOG_APPEND, async (args, context) => kernel.featureLogAppend(readStringField(args, 'feature_id'), readStringField(args, 'note'), context));
+    toolHandlers.register(TOOLS.PLAN_SUBMIT, async (args) => kernel.planSubmit(readStringField(args, 'feature_id'), args.plan_json, readNumberField(args, 'expected_version')));
+    toolHandlers.register(TOOLS.PLAN_GET, async (args) => kernel.planGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.PLAN_UPDATE, async (args) => kernel.planUpdate(readStringField(args, 'feature_id'), readNumberField(args, 'expected_plan_version'), args.plan_json));
+    toolHandlers.register(TOOLS.REPO_ENSURE_WORKTREE, async (args) => kernel.repoEnsureWorktree(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.REPO_APPLY_PATCH, async (args) => kernel.repoApplyPatch(readStringField(args, 'feature_id'), readStringField(args, 'unified_diff')));
+    toolHandlers.register(TOOLS.REPO_STATUS, async (args) => kernel.repoStatus(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.REPO_DIFF, async (args) => kernel.repoDiff(readStringField(args, 'feature_id'), asArray(args.options)));
+    toolHandlers.register(TOOLS.REPO_READ_FILE, async (args) => kernel.repoReadFile(readStringField(args, 'feature_id'), readStringField(args, 'path')));
+    toolHandlers.register(TOOLS.REPO_SEARCH, async (args) => kernel.repoSearch(readStringField(args, 'feature_id'), readStringField(args, 'query')));
+    toolHandlers.register(TOOLS.REPO_DIFF_BUNDLE, async (args) => kernel.repoDiffBundle(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_READY_TO_MERGE, async (args) => kernel.featureReadyToMerge(readStringField(args, 'feature_id'), readStringField(args, 'commit_message'), readStringField(args, 'merge_strategy'), readStringField(args, 'user_approval_token')));
+    toolHandlers.register(TOOLS.FEATURE_DELETE, async (args) => kernel.featureDelete(readStringField(args, 'feature_id'), readBooleanField(args, 'dry_run'), readBooleanField(args, 'confirm'), readBooleanField(args, 'remove_worktree'), readStringField(args, 'remove_branch')));
+    toolHandlers.register(TOOLS.GATES_LIST, async (args) => kernel.gatesList(readStringField(args, 'profile')));
+    toolHandlers.register(TOOLS.GATES_RUN, async (args) => kernel.gatesRun(readStringField(args, 'feature_id'), readStringField(args, 'profile'), readStringField(args, 'mode')));
+    toolHandlers.register(TOOLS.EVIDENCE_LATEST, async (args) => kernel.evidenceLatest(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.QA_TEST_INDEX_GET, async (args) => kernel.qaTestIndexGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.QA_TEST_INDEX_UPDATE, async (args) => kernel.qaTestIndexUpdate(readStringField(args, 'feature_id'), readNumberField(args, 'expected_version'), args.updates, asArray(args.evidence_refs)));
+    toolHandlers.register(TOOLS.LOCKS_ACQUIRE, async (args) => kernel.locksAcquire(readStringField(args, 'resource'), readStringField(args, 'feature_id'), readNumberField(args, 'wait_timeout_seconds')));
+    toolHandlers.register(TOOLS.LOCKS_RELEASE, async (args) => kernel.locksRelease(readStringField(args, 'resource'), readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.COLLISIONS_SCAN, async () => kernel.collisionsScan());
+    toolHandlers.register(TOOLS.REPORT_DASHBOARD, async () => kernel.reportDashboard());
+    toolHandlers.register(TOOLS.REPORT_FEATURE_SUMMARY, async (args) => kernel.reportFeatureSummary(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.FEATURE_SEND_MESSAGE, async (args) => kernel.featureSendMessage(readStringField(args, 'feature_id'), readStringField(args, 'message')));
+    toolHandlers.register(TOOLS.COST_RECORD, async (args) => kernel.costRecord(readStringField(args, 'feature_id') ?? '', typeof args.tokens_used_delta === 'number' ? args.tokens_used_delta : 0, typeof args.estimated_cost_usd_delta === 'number' ? args.estimated_cost_usd_delta : 0));
+    toolHandlers.register(TOOLS.COST_GET, async (args) => kernel.costGet(readStringField(args, 'feature_id')));
+    toolHandlers.register(TOOLS.PERFORMANCE_RECORD_OUTCOME, async (args) => kernel.performanceRecordOutcome(args));
+    toolHandlers.register(TOOLS.PERFORMANCE_GET_ANALYTICS, async (args) => kernel.performanceGetAnalytics(readStringField(args, 'provider'), readStringField(args, 'model')));
+}
+//# sourceMappingURL=kernel-tool-wiring.js.map

package/dist/apps/control-plane/core/kernel-tool-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-tool-wiring.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/kernel-tool-wiring.ts"],"names":[],"mappings":"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"}

package/dist/apps/control-plane/core/kernel-types.d.ts

@@ -0,0 +1,48 @@
+export type AnyRecord = Record<string, any>;
+export interface KernelContext {
+    actor_type?: string;
+    actor_id?: string;
+}
+export interface KernelConfigOverrides {
+    policyPath?: string;
+    gatesPath?: string;
+    agentsPath?: string;
+    adaptersPath?: string;
+}
+export interface AgentsRoleConfig {
+    system_prompt_path?: string;
+}
+export interface AgentsRuntimeConfig {
+    execution_mode?: 'deterministic' | 'interactive' | string;
+    interactive?: {
+        watchdog_poll_interval_ms?: number;
+        checkpoint_interval_ms?: number;
+        max_uncommitted_changes?: number;
+        validation_on_checkpoint?: boolean;
+        revert_on_violation?: boolean;
+        violation_severity?: 'info' | 'warning' | 'error' | 'critical' | string;
+        shadow_workspace?: {
+            enabled?: boolean;
+            promotion_strategy?: 'atomic' | 'incremental' | string;
+            cleanup_on_failure?: boolean;
+            max_shadow_size_mb?: number;
+        };
+    };
+    default_provider?: string;
+    default_model?: string;
+    provider_config_env?: string;
+    default_agent_config?: Record<string, unknown>;
+    provider_configs?: Record<string, Record<string, unknown>>;
+    worker_provider_mode?: 'live' | 'stub' | string;
+    worker_response_timeout_ms?: number;
+    max_consecutive_no_progress_iterations?: number;
+}
+export interface AgentsConfigSnapshot {
+    version?: number;
+    roles?: Record<string, AgentsRoleConfig>;
+    missing_prompt_behavior?: 'ignore' | 'error' | string;
+    runtime?: AgentsRuntimeConfig;
+}
+export interface PolicyConfigSnapshot extends AnyRecord {
+    rbac?: Record<string, string[]>;
+}

package/dist/apps/control-plane/core/kernel-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=kernel-types.js.map

package/dist/apps/control-plane/core/kernel-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-types.js","sourceRoot":"","sources":["../../../../apps/control-plane/src/core/kernel-types.ts"],"names":[],"mappings":""}

package/dist/apps/control-plane/core/kernel.d.ts

@@ -3,43 +3,13 @@ import { type ToolResponse } from './response.js';
 import type { RuntimeSessionsSnapshot } from './runtime-sessions.js';
 import { ToolHandlerRegistry, ToolRouter, type ToolHandlerContext } from '../application/tools/tool-router.js';
 import { type AcquireRunLeaseInput } from '../application/services/run-lease-service.js';
+import { type PatchValidationResult } from '../application/services/patch-service.js';
 import { CollisionQueueService } from '../application/services/collision-queue-service.js';
 import { type FeatureDeleteResult } from '../application/services/feature-deletion-service.js';
 import { type FeatureOutcome } from '../application/services/performance-analytics-service.js';
 import type { WorkerProvider } from '../providers/providers.js';
-type AnyRecord = Record<string, any>;
-interface KernelContext {
-    actor_type?: string;
-    actor_id?: string;
-}
-interface KernelConfigOverrides {
-    policyPath?: string;
-    gatesPath?: string;
-    agentsPath?: string;
-    adaptersPath?: string;
-}
-export interface AgentsRoleConfig {
-    system_prompt_path?: string;
-}
-export interface AgentsRuntimeConfig {
-    default_provider?: string;
-    default_model?: string;
-    provider_config_env?: string;
-    default_agent_config?: Record<string, unknown>;
-    provider_configs?: Record<string, Record<string, unknown>>;
-    worker_provider_mode?: 'live' | 'stub' | string;
-    worker_response_timeout_ms?: number;
-    max_consecutive_no_progress_iterations?: number;
-}
-export interface AgentsConfigSnapshot {
-    version?: number;
-    roles?: Record<string, AgentsRoleConfig>;
-    missing_prompt_behavior?: 'ignore' | 'error' | string;
-    runtime?: AgentsRuntimeConfig;
-}
-interface PolicyConfigSnapshot extends AnyRecord {
-    rbac?: Record<string, string[]>;
-}
+import type { AnyRecord, KernelContext, KernelConfigOverrides, AgentsConfigSnapshot, PolicyConfigSnapshot } from './kernel-types.js';
+export type { AgentsConfigSnapshot } from './kernel-types.js';
 /**
  * Deterministic orchestration kernel for multi-agent feature development.
  *
@@ -101,6 +71,8 @@ export declare class AopKernel {
     private readonly costTrackingService;
     private readonly performanceAnalyticsService;
     private readonly gateSelectionService;
+    private readonly repoOperationsService;
+    private readonly sendMessageService;
     private readonly pathLayout;
     readonly instanceId: string;
     private provider;
@@ -130,14 +102,12 @@ export declare class AopKernel {
     normalizeRuntimeSessions(value: unknown, at?: string): RuntimeSessionsSnapshot;
     normalizeIndexShape(value: unknown): AnyRecord;
     isRunLeaseFresh(runtimeSessions: RuntimeSessionsSnapshot): boolean;
-    private resolveDefaultConfigPath;
     load(): Promise<void>;
     ensureLoaded(): Promise<void>;
     authorize(actorType: string, toolName: string): boolean;
     invoke(toolName: string, args?: AnyRecord, context?: KernelContext): Promise<AnyRecord>;
     normalizeError(error: unknown): ToolResponse;
     dispatchTool(toolName: string, args: AnyRecord, context: ToolHandlerContext): Promise<unknown>;
-    private registerToolHandlers;
     featurePath(featureId: any): string;
     featureLockPath(featureId: any): string;
     statePath(featureId: any): string;
@@ -157,6 +127,7 @@ export declare class AopKernel {
         branch: any;
         worktree_path: string;
         status: "planning";
+        execution_mode: string;
         gate_profile: string;
         gates: {
             plan: "na";
@@ -183,6 +154,7 @@ export declare class AopKernel {
             builder: "ready";
             qa: "ready";
         };
+        checkpoints: any[];
         last_updated: string;
     };
     readState(featureId: string): Promise<{
@@ -335,8 +307,8 @@ export declare class AopKernel {
     }>;
     repoEnsureWorktree(featureId: any): Promise<{
         data: {
-            feature_id: any;
-            branch: any;
+            feature_id: string;
+            branch: string;
             worktree_path_abs: string;
             existed: boolean;
         };
@@ -353,30 +325,31 @@ export declare class AopKernel {
             qa_index_version: number;
         };
     }>;
+    validatePatchDiff(featureId: string, parsedDiff: unknown): Promise<PatchValidationResult>;
     repoStatus(featureId: any): Promise<{
         data: {
-            feature_id: any;
+            feature_id: string;
             branch: string;
             status_porcelain: string[];
         };
     }>;
     repoDiff(featureId: any, options?: any[]): Promise<{
         data: {
-            feature_id: any;
+            feature_id: string;
             diff: string;
         };
     }>;
     repoReadFile(featureId: any, filePath: any): Promise<{
         data: {
-            feature_id: any;
+            feature_id: string;
             path: string;
             content: string;
         };
     }>;
     repoSearch(featureId: any, query: any): Promise<{
         data: {
-            feature_id: any;
-            query: any;
+            feature_id: string;
+            query: string;
             matches: ({
                 raw: string;
                 path?: undefined;
@@ -392,13 +365,11 @@ export declare class AopKernel {
     }>;
     repoDiffBundle(featureId: any): Promise<{
         data: {
-            feature_id: any;
+            feature_id: string;
             diff_stat: string;
             diff: string;
             touched_files: string[];
-            last_gate_summary: {
-                [x: string]: any;
-            };
+            last_gate_summary: unknown;
         };
     }>;
     gatesList(profileName?: any): Promise<{
@@ -514,7 +485,6 @@ export declare class AopKernel {
             active: unknown;
         };
     }>;
-    private waitForSessionToBecomeActive;
     featureSendMessage(featureId: string | null, message: string | null): Promise<unknown>;
     costRecord(featureId: string, tokensDelta: number, costUsdDelta: number): Promise<{
         ok: true;
@@ -540,4 +510,3 @@ export declare class AopKernel {
         };
     }>;
 }
-export {};