@spotpatch/dev-server 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { applyPreparedAgentChange, executeAgentChange, inspectAgentWorkspace, probeProviderCapability, resolveProviderCredential, revertPreparedAgentChange } from '@spotpatch/agent';
-import { AgentJobEvent, AgentJobSnapshot, AgentJobCreateRequest, AgentCapabilityRequest, AgentCapabilitySnapshot, AgentJobResultResponse, AgentWorkspaceHealthSnapshot, ResolvedAiOptions, ExternalHandoffFramework, ExternalHandoffCapability, ExternalHandoffPublishRequest, SpotAnnotation, ExternalHandoffPublishResult, ExternalHandoffStatusResult, SpotPatchEditorPreference, ContextBudget, SpotPatchLocalePreference, DataFlowLimits, AiProviderProtocol, AiProviderAuthentication, AiExecutionOptions, AiOptions, RuntimeAiConfig, RuntimeDataFlowConfig, ResolvedAgentCheckDefinition, SpotPatchRuntimeConfig } from '@spotpatch/shared';
+import { AgentJobEvent, AgentJobSnapshot, AgentJobCreateRequest, AgentCapabilityRequest, AgentCapabilitySnapshot, AgentJobResultResponse, AgentWorkspaceHealthSnapshot, ResolvedAiOptions, ExternalHandoffFramework, ExternalHandoffCapability, ExternalHandoffPublishRequest, SpotAnnotation, ExternalHandoffPublishResult, ExternalHandoffStatusResult, ExternalAgentControlStatus, ExternalAgentControlConnectRequest, ExternalAgentControlDisconnectRequest, ExternalAgentControlCancelRequest, ExternalAgentManagedResult, SpotPatchEditorPreference, ContextBudget, SpotPatchLocalePreference, DataFlowLimits, AiProviderProtocol, AiProviderAuthentication, AiExecutionOptions, AiOptions, RuntimeAiConfig, RuntimeDataFlowConfig, ResolvedAgentCheckDefinition, AgentLimits, SpotPatchRuntimeConfig } from '@spotpatch/shared';
 import { SourceFilterEntry } from '@spotpatch/compiler';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
@@ -51,6 +51,16 @@ interface CreateExternalHandoffServiceOptions {
 }
 declare function createExternalHandoffService(options: CreateExternalHandoffServiceOptions): ExternalHandoffService;
 
+interface ExternalAgentControlPort {
+    getStatus(): ExternalAgentControlStatus;
+    connect(request: ExternalAgentControlConnectRequest, signal: AbortSignal): Promise<ExternalAgentControlStatus>;
+    disconnect(request: ExternalAgentControlDisconnectRequest): Promise<ExternalAgentControlStatus>;
+    cancel(request: ExternalAgentControlCancelRequest): Promise<ExternalAgentControlStatus>;
+    getResult(revision: number): ExternalAgentManagedResult | undefined;
+    subscribe(listener: (status: ExternalAgentControlStatus) => void): () => void;
+    dispose(): Promise<void>;
+}
+
 type FilterEntry = SourceFilterEntry;
 interface SimpleAiOptions {
     readonly baseURL: string;
@@ -145,6 +155,7 @@ declare const DEFAULT_OPTIONS: Readonly<{
             readonly graphMaxCallsites: 100;
             readonly analysisTimeoutMs: 2000;
             readonly reportMaxFields: 100;
+            readonly sourceMaxComponents: 256;
         }>;
     }>;
     externalAgent: Readonly<{
@@ -187,13 +198,26 @@ interface DiscoverProjectValidationCheckOptions {
     readonly appRoot: string;
     readonly timeoutMs: number;
 }
+interface ResolveProjectValidationChecksOptions extends DiscoverProjectValidationCheckOptions {
+    readonly checks: Readonly<Record<string, ResolvedAgentCheckDefinition>>;
+}
+interface ResolveManagedExecutionValidationOptions {
+    readonly ai: false | ResolvedAiOptions;
+    readonly appRoot: string;
+}
+interface ResolvedManagedExecutionValidation {
+    readonly checks: Readonly<Record<string, ResolvedAgentCheckDefinition>>;
+    readonly limits: Readonly<AgentLimits>;
+}
 declare function discoverProjectValidationCheck(options: DiscoverProjectValidationCheckOptions): Promise<ResolvedAgentCheckDefinition | undefined>;
+declare function resolveProjectValidationChecks(options: ResolveProjectValidationChecksOptions): Promise<Readonly<Record<string, ResolvedAgentCheckDefinition>>>;
+declare function resolveManagedExecutionValidation(options: ResolveManagedExecutionValidationOptions): Promise<ResolvedManagedExecutionValidation>;
 
 type SourceIdFactory = () => string;
 
 interface SourceRegistry {
     register(absolutePath: string): string;
-    registerDataFlowComponents(absolutePath: string, sourceVersion: string, components: readonly DataFlowComponentAnchorInput[]): void;
+    registerDataFlowComponents(absolutePath: string, sourceVersion: string, components: readonly DataFlowComponentAnchorInput[]): string;
     resolve(fileId: string): string | undefined;
     resolveDataFlowComponent(componentSourceId: string): DataFlowComponentAnchor | undefined;
     clear(): void;
@@ -232,7 +256,10 @@ declare function resolveRuntimeBootstrapOptions(options: RuntimeBootstrapOptions
 declare function readRuntimeBootstrap(request: IncomingMessage, options: ResolvedRuntimeBootstrapOptions): Promise<SpotPatchRuntimeConfig>;
 
 type SpotPatchNext = (error?: unknown) => void;
-type SpotPatchMiddleware = (request: IncomingMessage, response: ServerResponse, next: SpotPatchNext) => void;
+interface SpotPatchMiddleware {
+    (request: IncomingMessage, response: ServerResponse, next: SpotPatchNext): void;
+    dispose(): void;
+}
 interface SpotPatchServerLogger {
     warn(message: string): void;
 }
@@ -240,6 +267,7 @@ interface CreateMiddlewareOptions {
     readonly agentManager?: AgentJobManager;
     readonly bootstrap?: RuntimeBootstrapOptions;
     readonly editorLauncher?: EditorLauncher;
+    readonly externalAgentControl?: ExternalAgentControlPort;
     readonly externalHandoffService?: ExternalHandoffService;
     readonly logger?: SpotPatchServerLogger;
     readonly options: ResolvedSpotPatchOptions;
@@ -296,4 +324,4 @@ interface SerializedSpotPatchOptions {
 declare function serializeResolvedSpotPatchOptions(options: ResolvedSpotPatchOptions): SerializedSpotPatchOptions;
 declare function parseSerializedSpotPatchOptions(value: unknown): ResolvedSpotPatchOptions;
 
-export { type AgentJobEventListener, type AgentJobManager, type CreateAgentJobManagerOptions, type CreateExternalHandoffServiceOptions, type CreateMiddlewareOptions, DEFAULT_EXCLUDE, DEFAULT_OPTIONS, type DiscoverProjectValidationCheckOptions, type EnvironmentAiConfiguration, type ExternalHandoffService, type FilterEntry, type IntegrationFileChange, type IntegrationPlan, type ResolveProjectOptionsInput, type ResolvedRuntimeBootstrapOptions, type ResolvedSpotPatchDataFlowOptions, type ResolvedSpotPatchOptions, type RuntimeBootstrapOptions, type SerializedFilterEntry, type SerializedSpotPatchOptions, type SimpleAiOptions, type SourceRegistrationHandler, type SourceRegistrationService, type SourceRegistrationServiceOptions, type SourceRegistry, type SpotPatchAiOptions, type SpotPatchDataFlowOptions, type SpotPatchMiddleware, type SpotPatchNext, type SpotPatchOptions, type SpotPatchServerLogger, type SpotPatchSession, applyIntegrationPlan, createAgentJobManager, createExternalHandoffService, createIntegrationFileChange, createRuntimeAiConfig, createRuntimeDataFlowConfig, createSession, createSourceRegistrationService, createSourceRegistry, createSpotPatchMiddleware, discoverProjectValidationCheck, integrationPathExists, isLoopbackHostname, parseSerializedSpotPatchOptions, readIntegrationFile, readJsonRequestBody, readRuntimeBootstrap, resolveCredentialEnvironment, resolveEnvironmentAiConfiguration, resolveOptions, resolveProjectOptions, resolveRuntimeBootstrapOptions, serializeResolvedSpotPatchOptions };
+export { type AgentJobEventListener, type AgentJobManager, type CreateAgentJobManagerOptions, type CreateExternalHandoffServiceOptions, type CreateMiddlewareOptions, DEFAULT_EXCLUDE, DEFAULT_OPTIONS, type DiscoverProjectValidationCheckOptions, type EnvironmentAiConfiguration, type ExternalAgentControlPort, type ExternalHandoffService, type FilterEntry, type IntegrationFileChange, type IntegrationPlan, type ResolveManagedExecutionValidationOptions, type ResolveProjectOptionsInput, type ResolveProjectValidationChecksOptions, type ResolvedManagedExecutionValidation, type ResolvedRuntimeBootstrapOptions, type ResolvedSpotPatchDataFlowOptions, type ResolvedSpotPatchOptions, type RuntimeBootstrapOptions, type SerializedFilterEntry, type SerializedSpotPatchOptions, type SimpleAiOptions, type SourceRegistrationHandler, type SourceRegistrationService, type SourceRegistrationServiceOptions, type SourceRegistry, type SpotPatchAiOptions, type SpotPatchDataFlowOptions, type SpotPatchMiddleware, type SpotPatchNext, type SpotPatchOptions, type SpotPatchServerLogger, type SpotPatchSession, applyIntegrationPlan, createAgentJobManager, createExternalHandoffService, createIntegrationFileChange, createRuntimeAiConfig, createRuntimeDataFlowConfig, createSession, createSourceRegistrationService, createSourceRegistry, createSpotPatchMiddleware, discoverProjectValidationCheck, integrationPathExists, isLoopbackHostname, parseSerializedSpotPatchOptions, readIntegrationFile, readJsonRequestBody, readRuntimeBootstrap, resolveCredentialEnvironment, resolveEnvironmentAiConfiguration, resolveManagedExecutionValidation, resolveOptions, resolveProjectOptions, resolveProjectValidationChecks, resolveRuntimeBootstrapOptions, serializeResolvedSpotPatchOptions };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { applyPreparedAgentChange, executeAgentChange, inspectAgentWorkspace, probeProviderCapability, resolveProviderCredential, revertPreparedAgentChange } from '@spotpatch/agent';
-import { AgentJobEvent, AgentJobSnapshot, AgentJobCreateRequest, AgentCapabilityRequest, AgentCapabilitySnapshot, AgentJobResultResponse, AgentWorkspaceHealthSnapshot, ResolvedAiOptions, ExternalHandoffFramework, ExternalHandoffCapability, ExternalHandoffPublishRequest, SpotAnnotation, ExternalHandoffPublishResult, ExternalHandoffStatusResult, SpotPatchEditorPreference, ContextBudget, SpotPatchLocalePreference, DataFlowLimits, AiProviderProtocol, AiProviderAuthentication, AiExecutionOptions, AiOptions, RuntimeAiConfig, RuntimeDataFlowConfig, ResolvedAgentCheckDefinition, SpotPatchRuntimeConfig } from '@spotpatch/shared';
+import { AgentJobEvent, AgentJobSnapshot, AgentJobCreateRequest, AgentCapabilityRequest, AgentCapabilitySnapshot, AgentJobResultResponse, AgentWorkspaceHealthSnapshot, ResolvedAiOptions, ExternalHandoffFramework, ExternalHandoffCapability, ExternalHandoffPublishRequest, SpotAnnotation, ExternalHandoffPublishResult, ExternalHandoffStatusResult, ExternalAgentControlStatus, ExternalAgentControlConnectRequest, ExternalAgentControlDisconnectRequest, ExternalAgentControlCancelRequest, ExternalAgentManagedResult, SpotPatchEditorPreference, ContextBudget, SpotPatchLocalePreference, DataFlowLimits, AiProviderProtocol, AiProviderAuthentication, AiExecutionOptions, AiOptions, RuntimeAiConfig, RuntimeDataFlowConfig, ResolvedAgentCheckDefinition, AgentLimits, SpotPatchRuntimeConfig } from '@spotpatch/shared';
 import { SourceFilterEntry } from '@spotpatch/compiler';
 import { IncomingMessage, ServerResponse } from 'node:http';
 
@@ -51,6 +51,16 @@ interface CreateExternalHandoffServiceOptions {
 }
 declare function createExternalHandoffService(options: CreateExternalHandoffServiceOptions): ExternalHandoffService;
 
+interface ExternalAgentControlPort {
+    getStatus(): ExternalAgentControlStatus;
+    connect(request: ExternalAgentControlConnectRequest, signal: AbortSignal): Promise<ExternalAgentControlStatus>;
+    disconnect(request: ExternalAgentControlDisconnectRequest): Promise<ExternalAgentControlStatus>;
+    cancel(request: ExternalAgentControlCancelRequest): Promise<ExternalAgentControlStatus>;
+    getResult(revision: number): ExternalAgentManagedResult | undefined;
+    subscribe(listener: (status: ExternalAgentControlStatus) => void): () => void;
+    dispose(): Promise<void>;
+}
+
 type FilterEntry = SourceFilterEntry;
 interface SimpleAiOptions {
     readonly baseURL: string;
@@ -145,6 +155,7 @@ declare const DEFAULT_OPTIONS: Readonly<{
             readonly graphMaxCallsites: 100;
             readonly analysisTimeoutMs: 2000;
             readonly reportMaxFields: 100;
+            readonly sourceMaxComponents: 256;
         }>;
     }>;
     externalAgent: Readonly<{
@@ -187,13 +198,26 @@ interface DiscoverProjectValidationCheckOptions {
     readonly appRoot: string;
     readonly timeoutMs: number;
 }
+interface ResolveProjectValidationChecksOptions extends DiscoverProjectValidationCheckOptions {
+    readonly checks: Readonly<Record<string, ResolvedAgentCheckDefinition>>;
+}
+interface ResolveManagedExecutionValidationOptions {
+    readonly ai: false | ResolvedAiOptions;
+    readonly appRoot: string;
+}
+interface ResolvedManagedExecutionValidation {
+    readonly checks: Readonly<Record<string, ResolvedAgentCheckDefinition>>;
+    readonly limits: Readonly<AgentLimits>;
+}
 declare function discoverProjectValidationCheck(options: DiscoverProjectValidationCheckOptions): Promise<ResolvedAgentCheckDefinition | undefined>;
+declare function resolveProjectValidationChecks(options: ResolveProjectValidationChecksOptions): Promise<Readonly<Record<string, ResolvedAgentCheckDefinition>>>;
+declare function resolveManagedExecutionValidation(options: ResolveManagedExecutionValidationOptions): Promise<ResolvedManagedExecutionValidation>;
 
 type SourceIdFactory = () => string;
 
 interface SourceRegistry {
     register(absolutePath: string): string;
-    registerDataFlowComponents(absolutePath: string, sourceVersion: string, components: readonly DataFlowComponentAnchorInput[]): void;
+    registerDataFlowComponents(absolutePath: string, sourceVersion: string, components: readonly DataFlowComponentAnchorInput[]): string;
     resolve(fileId: string): string | undefined;
     resolveDataFlowComponent(componentSourceId: string): DataFlowComponentAnchor | undefined;
     clear(): void;
@@ -232,7 +256,10 @@ declare function resolveRuntimeBootstrapOptions(options: RuntimeBootstrapOptions
 declare function readRuntimeBootstrap(request: IncomingMessage, options: ResolvedRuntimeBootstrapOptions): Promise<SpotPatchRuntimeConfig>;
 
 type SpotPatchNext = (error?: unknown) => void;
-type SpotPatchMiddleware = (request: IncomingMessage, response: ServerResponse, next: SpotPatchNext) => void;
+interface SpotPatchMiddleware {
+    (request: IncomingMessage, response: ServerResponse, next: SpotPatchNext): void;
+    dispose(): void;
+}
 interface SpotPatchServerLogger {
     warn(message: string): void;
 }
@@ -240,6 +267,7 @@ interface CreateMiddlewareOptions {
     readonly agentManager?: AgentJobManager;
     readonly bootstrap?: RuntimeBootstrapOptions;
     readonly editorLauncher?: EditorLauncher;
+    readonly externalAgentControl?: ExternalAgentControlPort;
     readonly externalHandoffService?: ExternalHandoffService;
     readonly logger?: SpotPatchServerLogger;
     readonly options: ResolvedSpotPatchOptions;
@@ -296,4 +324,4 @@ interface SerializedSpotPatchOptions {
 declare function serializeResolvedSpotPatchOptions(options: ResolvedSpotPatchOptions): SerializedSpotPatchOptions;
 declare function parseSerializedSpotPatchOptions(value: unknown): ResolvedSpotPatchOptions;
 
-export { type AgentJobEventListener, type AgentJobManager, type CreateAgentJobManagerOptions, type CreateExternalHandoffServiceOptions, type CreateMiddlewareOptions, DEFAULT_EXCLUDE, DEFAULT_OPTIONS, type DiscoverProjectValidationCheckOptions, type EnvironmentAiConfiguration, type ExternalHandoffService, type FilterEntry, type IntegrationFileChange, type IntegrationPlan, type ResolveProjectOptionsInput, type ResolvedRuntimeBootstrapOptions, type ResolvedSpotPatchDataFlowOptions, type ResolvedSpotPatchOptions, type RuntimeBootstrapOptions, type SerializedFilterEntry, type SerializedSpotPatchOptions, type SimpleAiOptions, type SourceRegistrationHandler, type SourceRegistrationService, type SourceRegistrationServiceOptions, type SourceRegistry, type SpotPatchAiOptions, type SpotPatchDataFlowOptions, type SpotPatchMiddleware, type SpotPatchNext, type SpotPatchOptions, type SpotPatchServerLogger, type SpotPatchSession, applyIntegrationPlan, createAgentJobManager, createExternalHandoffService, createIntegrationFileChange, createRuntimeAiConfig, createRuntimeDataFlowConfig, createSession, createSourceRegistrationService, createSourceRegistry, createSpotPatchMiddleware, discoverProjectValidationCheck, integrationPathExists, isLoopbackHostname, parseSerializedSpotPatchOptions, readIntegrationFile, readJsonRequestBody, readRuntimeBootstrap, resolveCredentialEnvironment, resolveEnvironmentAiConfiguration, resolveOptions, resolveProjectOptions, resolveRuntimeBootstrapOptions, serializeResolvedSpotPatchOptions };
+export { type AgentJobEventListener, type AgentJobManager, type CreateAgentJobManagerOptions, type CreateExternalHandoffServiceOptions, type CreateMiddlewareOptions, DEFAULT_EXCLUDE, DEFAULT_OPTIONS, type DiscoverProjectValidationCheckOptions, type EnvironmentAiConfiguration, type ExternalAgentControlPort, type ExternalHandoffService, type FilterEntry, type IntegrationFileChange, type IntegrationPlan, type ResolveManagedExecutionValidationOptions, type ResolveProjectOptionsInput, type ResolveProjectValidationChecksOptions, type ResolvedManagedExecutionValidation, type ResolvedRuntimeBootstrapOptions, type ResolvedSpotPatchDataFlowOptions, type ResolvedSpotPatchOptions, type RuntimeBootstrapOptions, type SerializedFilterEntry, type SerializedSpotPatchOptions, type SimpleAiOptions, type SourceRegistrationHandler, type SourceRegistrationService, type SourceRegistrationServiceOptions, type SourceRegistry, type SpotPatchAiOptions, type SpotPatchDataFlowOptions, type SpotPatchMiddleware, type SpotPatchNext, type SpotPatchOptions, type SpotPatchServerLogger, type SpotPatchSession, applyIntegrationPlan, createAgentJobManager, createExternalHandoffService, createIntegrationFileChange, createRuntimeAiConfig, createRuntimeDataFlowConfig, createSession, createSourceRegistrationService, createSourceRegistry, createSpotPatchMiddleware, discoverProjectValidationCheck, integrationPathExists, isLoopbackHostname, parseSerializedSpotPatchOptions, readIntegrationFile, readJsonRequestBody, readRuntimeBootstrap, resolveCredentialEnvironment, resolveEnvironmentAiConfiguration, resolveManagedExecutionValidation, resolveOptions, resolveProjectOptions, resolveProjectValidationChecks, resolveRuntimeBootstrapOptions, serializeResolvedSpotPatchOptions };