import type { CommandResult, SandboxProvider, WorkspaceFilesystem, WorkspaceSandbox } from '@n8n/agents/sandbox'; import type { KnowledgeConsumerScope } from './knowledge-consumer-scope'; export type KnowledgeSandboxHandle = { provider: SandboxProvider; sandbox: WorkspaceSandbox; filesystem: Pick; cacheKey: string; }; export interface KnowledgeSandboxProvider { assertConfiguration(scope: KnowledgeConsumerScope): void; acquire(scope: KnowledgeConsumerScope): Promise; executeCommand(sandbox: WorkspaceSandbox, command: string, timeoutMs: number): Promise; warm(scope: KnowledgeConsumerScope): Promise; destroy(scope: KnowledgeConsumerScope): Promise; }