import { SandboxHandle, WorkspaceProjection } from '@tanstack/ai-sandbox';
/** ACP `newSession` MCP server descriptor (HTTP transport). */
export interface AcpMcpServer {
    name: string;
    url: string;
    headers: Array<{
        name: string;
        value: string;
    }>;
}
/**
 * Build ACP `mcpServers` entries from the workspace's `mcp` skills, resolving
 * every header value (SecretRef / bearer / plain string). Returns `[]` when
 * there are no MCP skills. Pass the result to `startAcpSession({ mcpServers })`.
 */
export declare function workspaceMcpServers(projection: WorkspaceProjection): Array<AcpMcpServer>;
/**
 * Project the non-MCP parts of a workspace into an ACP harness. Links each
 * cloned `gitSkill` repo into the harness's skills directory when one is
 * declared; warns and skips `agentSkill`s, `plugin`s, and (when no `skillsDir`
 * is configured) `gitSkill`s. Idempotent — gated by the projection marker.
 *
 * MCP skills are NOT handled here; pass {@link workspaceMcpServers} to the ACP
 * session instead.
 */
export declare function projectAcpWorkspace(handle: SandboxHandle, projection: WorkspaceProjection, options: {
    skillsDir?: string;
    harnessName: string;
}): Promise<void>;