@d34dman/flowdrop 0.0.56 → 0.0.57

package/dist/components/form/FormUISchemaRenderer.svelte.d.ts

@@ -0,0 +1,32 @@
+import type { UISchemaElement } from '../../types/uischema.js';
+import type { ConfigSchema, WorkflowNode, WorkflowEdge, AuthProvider } from '../../types/index.js';
+import type { FieldSchema } from './types.js';
+interface Props {
+    /** The UISchema element to render */
+    element: UISchemaElement;
+    /** The data schema (for resolving field definitions) */
+    schema: ConfigSchema;
+    /** Current form values */
+    values: Record<string, unknown>;
+    /** Required field keys from the schema */
+    requiredFields?: string[];
+    /** Base animation index for staggered animations */
+    animationIndexBase?: number;
+    /** Callback when a field value changes */
+    onFieldChange: (key: string, value: unknown) => void;
+    /** Convert a property to FieldSchema (handles template variable injection etc.) */
+    toFieldSchema: (property: Record<string, unknown>) => FieldSchema;
+    /** Current workflow node (optional, passed through to FormField) */
+    node?: WorkflowNode;
+    /** All workflow nodes (optional, passed through to FormField) */
+    nodes?: WorkflowNode[];
+    /** All workflow edges (optional, passed through to FormField) */
+    edges?: WorkflowEdge[];
+    /** Workflow ID (optional, passed through to FormField) */
+    workflowId?: string;
+    /** Auth provider (optional, passed through to FormField) */
+    authProvider?: AuthProvider;
+}
+declare const FormUISchemaRenderer: import("svelte").Component<Props, {}, "">;
+type FormUISchemaRenderer = ReturnType<typeof FormUISchemaRenderer>;
+export default FormUISchemaRenderer;

package/dist/components/form/index.d.ts

@@ -44,4 +44,6 @@ export { default as FormCodeEditor } from './FormCodeEditor.svelte';
 export { default as FormMarkdownEditor } from './FormMarkdownEditor.svelte';
 export { default as FormTemplateEditor } from './FormTemplateEditor.svelte';
 export { default as FormAutocomplete } from './FormAutocomplete.svelte';
+export { default as FormFieldset } from './FormFieldset.svelte';
+export { default as FormUISchemaRenderer } from './FormUISchemaRenderer.svelte';
 export { createTemplateAutocomplete } from './templateAutocomplete.js';

package/dist/components/form/index.js

@@ -48,5 +48,8 @@ export { default as FormCodeEditor } from './FormCodeEditor.svelte';
 export { default as FormMarkdownEditor } from './FormMarkdownEditor.svelte';
 export { default as FormTemplateEditor } from './FormTemplateEditor.svelte';
 export { default as FormAutocomplete } from './FormAutocomplete.svelte';
+// UISchema rendering components
+export { default as FormFieldset } from './FormFieldset.svelte';
+export { default as FormUISchemaRenderer } from './FormUISchemaRenderer.svelte';
 // Template autocomplete utilities
 export { createTemplateAutocomplete } from './templateAutocomplete.js';

package/dist/config/agentSpecEndpoints.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Agent Spec Runtime Endpoint Configuration
+ *
+ * Defines the API endpoints for connecting to Agent Spec runtimes
+ * (WayFlow, PyAgentSpec, or other compatible runtimes).
+ */
+/**
+ * Agent Spec runtime endpoint configuration.
+ *
+ * Separate from the main FlowDrop EndpointConfig because the Agent Spec
+ * runtime is an independent service with its own base URL and auth.
+ *
+ * @example
+ * ```typescript
+ * const config: AgentSpecEndpointConfig = {
+ *   baseUrl: 'http://localhost:8000',
+ *   endpoints: { ...defaultAgentSpecEndpoints.endpoints },
+ *   auth: { type: 'bearer', token: 'my-api-key' }
+ * };
+ * ```
+ */
+export interface AgentSpecEndpointConfig {
+    /** Base URL for the Agent Spec runtime */
+    baseUrl: string;
+    endpoints: {
+        /** POST — Execute a flow (body: AgentSpecFlow JSON) */
+        execute: string;
+        /** GET — Get execution status (params: {id}) */
+        status: string;
+        /** POST — Cancel a running execution (params: {id}) */
+        cancel: string;
+        /** GET — Get execution results (params: {id}) */
+        results: string;
+        /** WS — WebSocket for streaming execution updates (params: {id}) */
+        stream: string;
+        /** POST — Validate a flow specification (body: AgentSpecFlow JSON) */
+        validate: string;
+        /** GET — List available agents on the runtime */
+        agents: string;
+        /** GET — List available tools on the runtime */
+        tools: string;
+        /** GET — Runtime health check */
+        health: string;
+    };
+    /** Authentication for the runtime */
+    auth?: {
+        type: 'none' | 'bearer' | 'api_key';
+        token?: string;
+        apiKey?: string;
+    };
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Default Agent Spec runtime endpoints.
+ * Targets a local WayFlow/PyAgentSpec instance on port 8000.
+ */
+export declare const defaultAgentSpecEndpoints: AgentSpecEndpointConfig;
+/**
+ * Create Agent Spec endpoint configuration with custom base URL.
+ */
+export declare function createAgentSpecEndpointConfig(baseUrl: string, overrides?: Partial<AgentSpecEndpointConfig>): AgentSpecEndpointConfig;
+/**
+ * Build a full URL for an Agent Spec runtime endpoint.
+ */
+export declare function buildAgentSpecUrl(config: AgentSpecEndpointConfig, endpointPath: string, params?: Record<string, string>): string;
+/**
+ * Get authentication headers for Agent Spec runtime requests.
+ */
+export declare function getAgentSpecAuthHeaders(config: AgentSpecEndpointConfig): Record<string, string>;

package/dist/config/agentSpecEndpoints.js

@@ -0,0 +1,65 @@
+/**
+ * Agent Spec Runtime Endpoint Configuration
+ *
+ * Defines the API endpoints for connecting to Agent Spec runtimes
+ * (WayFlow, PyAgentSpec, or other compatible runtimes).
+ */
+/**
+ * Default Agent Spec runtime endpoints.
+ * Targets a local WayFlow/PyAgentSpec instance on port 8000.
+ */
+export const defaultAgentSpecEndpoints = {
+    baseUrl: 'http://localhost:8000',
+    endpoints: {
+        execute: '/flows/execute',
+        status: '/executions/{id}',
+        cancel: '/executions/{id}/cancel',
+        results: '/executions/{id}/results',
+        stream: '/executions/{id}/stream',
+        validate: '/flows/validate',
+        agents: '/agents',
+        tools: '/tools',
+        health: '/health'
+    },
+    timeout: 60000
+};
+/**
+ * Create Agent Spec endpoint configuration with custom base URL.
+ */
+export function createAgentSpecEndpointConfig(baseUrl, overrides) {
+    return {
+        ...defaultAgentSpecEndpoints,
+        baseUrl: baseUrl.replace(/\/$/, ''),
+        ...overrides
+    };
+}
+/**
+ * Build a full URL for an Agent Spec runtime endpoint.
+ */
+export function buildAgentSpecUrl(config, endpointPath, params) {
+    let url = endpointPath;
+    if (params) {
+        for (const [key, value] of Object.entries(params)) {
+            url = url.replace(`{${key}}`, encodeURIComponent(value));
+        }
+    }
+    if (!url.startsWith('http') && !url.startsWith('//')) {
+        url = `${config.baseUrl}${url.startsWith('/') ? url : `/${url}`}`;
+    }
+    return url;
+}
+/**
+ * Get authentication headers for Agent Spec runtime requests.
+ */
+export function getAgentSpecAuthHeaders(config) {
+    const headers = {
+        'Content-Type': 'application/json'
+    };
+    if (config.auth?.type === 'bearer' && config.auth.token) {
+        headers['Authorization'] = `Bearer ${config.auth.token}`;
+    }
+    else if (config.auth?.type === 'api_key' && config.auth.apiKey) {
+        headers['X-API-Key'] = config.auth.apiKey;
+    }
+    return headers;
+}

package/dist/config/endpoints.d.ts

@@ -2,6 +2,7 @@
  * FlowDrop Endpoint Configuration
  * Provides configurable endpoints for all API actions
  */
+import type { AgentSpecEndpointConfig } from './agentSpecEndpoints.js';
 export interface EndpointConfig {
     /** Base URL for all endpoints */
     baseUrl: string;
@@ -88,6 +89,11 @@ export interface EndpointConfig {
             version: string;
         };
     };
+    /**
+     * Optional Agent Spec runtime configuration.
+     * When provided, enables Agent Spec execution features.
+     */
+    agentSpec?: AgentSpecEndpointConfig;
     /** HTTP method overrides for specific endpoints */
     methods?: {
         [key: string]: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';

package/dist/core/index.d.ts

@@ -14,7 +14,8 @@
  * import { getStatusColor, createDefaultExecutionInfo } from "@d34dman/flowdrop/core";
  * ```
  */
-export type { NodeCategory, BuiltinNodeCategory, CategoryDefinition, NodeDataType, NodePort, DynamicPort, Branch, NodeMetadata, NodeExtensions, NodeUIExtensions, ConfigValues, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents, BuiltinNodeType, PortConfig, PortCompatibilityRule, ConfigSchema, ConfigProperty, HttpMethod, DynamicSchemaEndpoint, ExternalEditLink, ConfigEditOptions, EdgeCategory } from '../types/index.js';
+export type { NodeCategory, BuiltinNodeCategory, CategoryDefinition, NodeDataType, NodePort, DynamicPort, Branch, NodeMetadata, NodeExtensions, NodeUIExtensions, ConfigValues, WorkflowNode, WorkflowEdge, Workflow, ApiResponse, NodesResponse, WorkflowResponse, WorkflowsResponse, ExecutionStatus, ExecutionResult, FlowDropConfig, WorkflowEvents, BuiltinNodeType, PortConfig, PortCompatibilityRule, ConfigSchema, ConfigProperty, HttpMethod, DynamicSchemaEndpoint, ExternalEditLink, ConfigEditOptions, EdgeCategory, UISchemaElementType, UISchemaElementBase, UISchemaControl, UISchemaVerticalLayout, UISchemaGroup, UISchemaElement } from '../types/index.js';
+export { isUISchemaControl, isUISchemaVerticalLayout, isUISchemaGroup } from '../types/index.js';
 export type { WorkflowEditorConfig, EditorFeatures, UIConfig, APIConfig, ExecutionConfig, StorageConfig } from '../types/config.js';
 export type { AuthProvider, StaticAuthConfig, CallbackAuthConfig } from '../types/auth.js';
 export type { WorkflowChangeType, FlowDropEventHandlers, FlowDropFeatures } from '../types/events.js';
@@ -37,8 +38,23 @@ export * from '../utils/config.js';
 export * from '../utils/nodeTypes.js';
 export { isLoopbackEdge, isValidLoopbackCycle, hasCycles, hasInvalidCycles } from '../utils/connections.js';
 export { isFieldOptionArray, normalizeOptions } from '../components/form/types.js';
+export { resolveScopeToKey, keyToScope, generateDefaultUISchema, collectReferencedKeys } from '../utils/uischema.js';
 export { DEFAULT_PORT_CONFIG } from '../config/defaultPortConfig.js';
 export { defaultEndpointConfig, createEndpointConfig } from '../config/endpoints.js';
 export * from '../adapters/WorkflowAdapter.js';
+export type { AgentSpecNodeComponentType, AgentSpecToolComponentType, AgentSpecComponentType, AgentSpecProperty, AgentSpecNodeBase, AgentSpecStartNode, AgentSpecEndNode, AgentSpecLLMNode, AgentSpecAPINode, AgentSpecAgentNode, AgentSpecFlowNode, AgentSpecMapNode, AgentSpecBranchingNode, AgentSpecToolNode, AgentSpecNode, AgentSpecBranch, AgentSpecControlFlowEdge, AgentSpecDataFlowEdge, AgentSpecFlow, AgentSpecToolBase, AgentSpecServerTool, AgentSpecClientTool, AgentSpecRemoteTool, AgentSpecTool, AgentSpecLLMConfig, AgentSpecAgent, AgentSpecDocument } from '../types/agentspec.js';
+export { COMPONENT_REF_PREFIX, isComponentRef, extractComponentRefId, createComponentRef } from '../types/agentspec.js';
+export { getAgentSpecNodeMetadata, getAllAgentSpecNodeTypes, createAgentSpecNodeMetadata, isAgentSpecNodeId, extractComponentType, AGENTSPEC_NAMESPACE } from '../adapters/agentspec/nodeTypeRegistry.js';
+export { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
+export { AgentSpecAgentAdapter } from '../adapters/agentspec/agentAdapter.js';
+export type { AgentConfig, AgentSpecImportResult } from '../adapters/agentspec/agentAdapter.js';
+export { validateForAgentSpecExport, validateAgentSpecFlow } from '../adapters/agentspec/validator.js';
+export type { AgentSpecValidationResult } from '../adapters/agentspec/validator.js';
+export { computeAutoLayout } from '../adapters/agentspec/autoLayout.js';
+export type { AutoLayoutConfig } from '../adapters/agentspec/autoLayout.js';
+export type { AgentSpecEndpointConfig } from '../config/agentSpecEndpoints.js';
+export { defaultAgentSpecEndpoints, createAgentSpecEndpointConfig, buildAgentSpecUrl, getAgentSpecAuthHeaders } from '../config/agentSpecEndpoints.js';
+export { AgentSpecExecutionService, agentSpecExecutionService } from '../services/agentSpecExecutionService.js';
+export type { AgentSpecExecutionHandle } from '../services/agentSpecExecutionService.js';
 export type { ThemePreference, ResolvedTheme } from '../stores/settingsStore.js';
 export { theme, resolvedTheme, setTheme, toggleTheme, cycleTheme, initializeTheme, isThemeInitialized } from '../stores/settingsStore.js';

package/dist/core/index.js

@@ -14,6 +14,7 @@
  * import { getStatusColor, createDefaultExecutionInfo } from "@d34dman/flowdrop/core";
  * ```
  */
+export { isUISchemaControl, isUISchemaVerticalLayout, isUISchemaGroup } from '../types/index.js';
 export { isChatInputNode, CHAT_INPUT_PATTERNS } from '../types/playground.js';
 // ============================================================================
 // Authentication Providers (no dependencies)
@@ -42,6 +43,8 @@ export * from '../utils/nodeTypes.js';
 export { isLoopbackEdge, isValidLoopbackCycle, hasCycles, hasInvalidCycles } from '../utils/connections.js';
 // Form type utilities
 export { isFieldOptionArray, normalizeOptions } from '../components/form/types.js';
+// UISchema utilities
+export { resolveScopeToKey, keyToScope, generateDefaultUISchema, collectReferencedKeys } from '../utils/uischema.js';
 // ============================================================================
 // Configuration
 // ============================================================================
@@ -51,4 +54,18 @@ export { defaultEndpointConfig, createEndpointConfig } from '../config/endpoints
 // Adapters
 // ============================================================================
 export * from '../adapters/WorkflowAdapter.js';
+export { COMPONENT_REF_PREFIX, isComponentRef, extractComponentRefId, createComponentRef } from '../types/agentspec.js';
+// Agent Spec node type registry
+export { getAgentSpecNodeMetadata, getAllAgentSpecNodeTypes, createAgentSpecNodeMetadata, isAgentSpecNodeId, extractComponentType, AGENTSPEC_NAMESPACE } from '../adapters/agentspec/nodeTypeRegistry.js';
+// Agent Spec adapter (bidirectional conversion)
+export { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
+// Agent Spec agent-level adapter
+export { AgentSpecAgentAdapter } from '../adapters/agentspec/agentAdapter.js';
+// Agent Spec validation
+export { validateForAgentSpecExport, validateAgentSpecFlow } from '../adapters/agentspec/validator.js';
+// Agent Spec auto-layout
+export { computeAutoLayout } from '../adapters/agentspec/autoLayout.js';
+export { defaultAgentSpecEndpoints, createAgentSpecEndpointConfig, buildAgentSpecUrl, getAgentSpecAuthHeaders } from '../config/agentSpecEndpoints.js';
+// Agent Spec execution service
+export { AgentSpecExecutionService, agentSpecExecutionService } from '../services/agentSpecExecutionService.js';
 export { theme, resolvedTheme, setTheme, toggleTheme, cycleTheme, initializeTheme, isThemeInitialized } from '../stores/settingsStore.js';

package/dist/form/index.d.ts

@@ -69,6 +69,8 @@ export { default as FormToggle } from '../components/form/FormToggle.svelte';
 export { default as FormSelect } from '../components/form/FormSelect.svelte';
 export { default as FormCheckboxGroup } from '../components/form/FormCheckboxGroup.svelte';
 export { default as FormArray } from '../components/form/FormArray.svelte';
+export { default as FormFieldset } from '../components/form/FormFieldset.svelte';
+export { default as FormUISchemaRenderer } from '../components/form/FormUISchemaRenderer.svelte';
 export type { FieldSchema, FieldType, FieldFormat, FieldOption, OneOfItem, SchemaFormProps, BaseFieldProps, TextFieldProps, TextareaFieldProps, NumberFieldProps, ToggleFieldProps, RangeFieldProps, SelectFieldProps, CheckboxGroupFieldProps, ArrayFieldProps, FormFieldFactoryProps, FormFieldWrapperProps } from '../components/form/types.js';
 export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, getSchemaOptions } from '../components/form/types.js';
 export { registerFieldComponent, unregisterFieldComponent, resolveFieldComponent, getRegisteredFieldTypes, isFieldTypeRegistered, clearFieldRegistry, getFieldRegistrySize, hiddenFieldMatcher, checkboxGroupMatcher, enumSelectMatcher, textareaMatcher, rangeMatcher, textFieldMatcher, numberFieldMatcher, toggleMatcher, selectOptionsMatcher, arrayMatcher } from './fieldRegistry.js';

package/dist/form/index.js

@@ -77,6 +77,9 @@ export { default as FormToggle } from '../components/form/FormToggle.svelte';
 export { default as FormSelect } from '../components/form/FormSelect.svelte';
 export { default as FormCheckboxGroup } from '../components/form/FormCheckboxGroup.svelte';
 export { default as FormArray } from '../components/form/FormArray.svelte';
+// UISchema rendering components
+export { default as FormFieldset } from '../components/form/FormFieldset.svelte';
+export { default as FormUISchemaRenderer } from '../components/form/FormUISchemaRenderer.svelte';
 export { isFieldOptionArray, isOneOfArray, normalizeOptions, oneOfToOptions, getSchemaOptions } from '../components/form/types.js';
 // ============================================================================
 // Field Registry (for dynamic field registration)

package/dist/helpers/workflowEditorHelper.d.ts

@@ -131,6 +131,30 @@ export declare class WorkflowOperationsHelper {
      * Export workflow as JSON file
      */
     static exportWorkflow(workflow: Workflow | null): void;
+    /**
+     * Export workflow as Agent Spec JSON file.
+     *
+     * Converts the FlowDrop workflow to Agent Spec format and triggers a download.
+     * Validates the workflow for Agent Spec compatibility first.
+     *
+     * @param workflow - The FlowDrop workflow to export
+     * @returns Validation result (check .valid before assuming success)
+     */
+    static exportAsAgentSpec(workflow: Workflow | null): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Import a workflow from an Agent Spec JSON or YAML file.
+     *
+     * Reads the file, detects format, converts to FlowDrop format,
+     * and returns a Workflow ready for the editor.
+     *
+     * @param file - The file to import (JSON or YAML)
+     * @returns Promise resolving to the imported FlowDrop Workflow
+     */
+    static importFromAgentSpec(file: File): Promise<Workflow>;
     /**
      * Check if workflow has invalid cycles (excludes valid loopback cycles)
      * Valid loopback cycles are used for ForEach node iteration and should not

package/dist/helpers/workflowEditorHelper.js

@@ -8,6 +8,9 @@ import { workflowApi, nodeApi, setEndpointConfig } from '../services/api.js';
 import { v4 as uuidv4 } from 'uuid';
 import { workflowActions } from '../stores/workflowStore.js';
 import { nodeExecutionService } from '../services/nodeExecutionService.js';
+import { WorkflowAdapter } from '../adapters/WorkflowAdapter.js';
+import { AgentSpecAdapter } from '../adapters/agentspec/AgentSpecAdapter.js';
+import { validateForAgentSpecExport } from '../adapters/agentspec/validator.js';
 /**
  * Generate a unique node ID based on node type and existing nodes
  * Format: <node_type>.<number>
@@ -537,6 +540,58 @@ export class WorkflowOperationsHelper {
         link.click();
         URL.revokeObjectURL(url);
     }
+    /**
+     * Export workflow as Agent Spec JSON file.
+     *
+     * Converts the FlowDrop workflow to Agent Spec format and triggers a download.
+     * Validates the workflow for Agent Spec compatibility first.
+     *
+     * @param workflow - The FlowDrop workflow to export
+     * @returns Validation result (check .valid before assuming success)
+     */
+    static exportAsAgentSpec(workflow) {
+        if (!workflow) {
+            return { valid: false, errors: ['No workflow data available to export'], warnings: [] };
+        }
+        // Convert to StandardWorkflow first
+        const workflowAdapter = new WorkflowAdapter();
+        const standardWorkflow = workflowAdapter.fromSvelteFlow(workflow);
+        // Validate for Agent Spec
+        const validation = validateForAgentSpecExport(standardWorkflow);
+        if (!validation.valid) {
+            return validation;
+        }
+        // Convert to Agent Spec
+        const agentSpecAdapter = new AgentSpecAdapter();
+        const agentSpecJson = agentSpecAdapter.exportJSON(standardWorkflow);
+        // Trigger download
+        const dataBlob = new Blob([agentSpecJson], { type: 'application/json' });
+        const url = URL.createObjectURL(dataBlob);
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = `${workflow.name || 'workflow'}-agentspec.json`;
+        link.click();
+        URL.revokeObjectURL(url);
+        return validation;
+    }
+    /**
+     * Import a workflow from an Agent Spec JSON or YAML file.
+     *
+     * Reads the file, detects format, converts to FlowDrop format,
+     * and returns a Workflow ready for the editor.
+     *
+     * @param file - The file to import (JSON or YAML)
+     * @returns Promise resolving to the imported FlowDrop Workflow
+     */
+    static async importFromAgentSpec(file) {
+        const text = await file.text();
+        const agentSpecAdapter = new AgentSpecAdapter();
+        const workflowAdapter = new WorkflowAdapter();
+        // Parse the Agent Spec data
+        const standardWorkflow = agentSpecAdapter.importJSON(text);
+        // Convert to SvelteFlow format
+        return workflowAdapter.toSvelteFlow(standardWorkflow);
+    }
     /**
      * Check if workflow has invalid cycles (excludes valid loopback cycles)
      * Valid loopback cycles are used for ForEach node iteration and should not

package/dist/services/agentSpecExecutionService.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Agent Spec Execution Service
+ *
+ * Connects FlowDrop to Agent Spec runtimes (WayFlow/PyAgentSpec) for
+ * workflow execution, status tracking, and result retrieval.
+ *
+ * Follows the same singleton pattern as NodeExecutionService.
+ */
+import type { NodeExecutionInfo } from '../types/index.js';
+import type { StandardWorkflow } from '../adapters/WorkflowAdapter.js';
+import type { AgentSpecEndpointConfig } from '../config/agentSpecEndpoints.js';
+/** Result returned when starting an execution */
+export interface AgentSpecExecutionHandle {
+    /** Unique execution ID from the runtime */
+    executionId: string;
+    /** Stop polling and clean up */
+    stop: () => void;
+}
+/**
+ * Service for executing FlowDrop workflows on Agent Spec runtimes.
+ *
+ * @example
+ * ```typescript
+ * const service = AgentSpecExecutionService.getInstance();
+ * service.configure(myRuntimeConfig);
+ *
+ * // Check runtime availability
+ * const healthy = await service.checkHealth();
+ *
+ * // Execute a workflow
+ * const handle = await service.executeWorkflow(workflow, inputs, {
+ *   onNodeUpdate: (nodeId, info) => updateNodeVisual(nodeId, info),
+ *   onComplete: (results) => showResults(results),
+ *   onError: (error) => showError(error)
+ * });
+ *
+ * // Cancel if needed
+ * await service.cancelExecution(handle.executionId);
+ * ```
+ */
+export declare class AgentSpecExecutionService {
+    private static instance;
+    private config;
+    private adapter;
+    private activeExecutions;
+    private constructor();
+    static getInstance(): AgentSpecExecutionService;
+    /**
+     * Configure the runtime connection.
+     */
+    configure(config: AgentSpecEndpointConfig): void;
+    /**
+     * Check if the service has been configured with a runtime.
+     */
+    isConfigured(): boolean;
+    /**
+     * Check runtime health.
+     */
+    checkHealth(): Promise<boolean>;
+    /**
+     * Execute a FlowDrop workflow on the Agent Spec runtime.
+     *
+     * 1. Converts StandardWorkflow → AgentSpecFlow using the adapter
+     * 2. POSTs the flow JSON to the runtime
+     * 3. Starts polling for execution status
+     * 4. Maps runtime node statuses to FlowDrop's NodeExecutionInfo
+     */
+    executeWorkflow(workflow: StandardWorkflow, inputs?: Record<string, unknown>, callbacks?: {
+        onNodeUpdate?: (nodeId: string, info: NodeExecutionInfo) => void;
+        onComplete?: (results: Record<string, unknown>) => void;
+        onError?: (error: Error) => void;
+    }, pollingIntervalMs?: number): Promise<AgentSpecExecutionHandle>;
+    /**
+     * Get current execution status.
+     */
+    getExecutionStatus(executionId: string): Promise<Record<string, NodeExecutionInfo> | null>;
+    /**
+     * Cancel a running execution.
+     */
+    cancelExecution(executionId: string): Promise<void>;
+    /**
+     * Get execution results.
+     */
+    getResults(executionId: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Validate a workflow against the runtime.
+     */
+    validateOnRuntime(workflow: StandardWorkflow): Promise<{
+        valid: boolean;
+        errors?: string[];
+    }>;
+    /**
+     * Clean up all active executions.
+     */
+    destroy(): void;
+    private ensureConfigured;
+    /** Get the config, throwing if not configured */
+    private getConfig;
+    private startPolling;
+    private stopPolling;
+    private mapRuntimeStatusToNodeInfo;
+    private mapSingleNodeStatus;
+    private mapToFlowDropStatus;
+}
+/** Singleton instance */
+export declare const agentSpecExecutionService: AgentSpecExecutionService;